Cómo activar la puerta de enlace y crear una clave

Actualizado el

En SyBox, esto se hace en Configuración > Integraciones > Claves de API. 1) Ve a Configuración > Integraciones > Claves de API. 2) Activa el interruptor "Puerta de enlace de API". 3) Haz clic en "Nueva clave". 4) Elige el "Tipo de clave": 5) Completa el "Nombre del dispositivo o programa", por ejemplo "Ordenador de la oficina" o "Sistema de contabilidad". Dale a cada dispositivo o programa su propia clave. 6) Para una clave de tipo "Enviar por WhatsApp", configura también: 7) Para una…

  1. Ve a Configuración > Integraciones > Claves de API.
  2. Activa el interruptor "Puerta de enlace de API".
  3. Haz clic en "Nueva clave".
    Settings, API keys: keys that let another program send through SyBox, and the "New key" button
  4. Elige el "Tipo de clave":
    • "Enviar por WhatsApp": el programa envía mensajes a tus clientes.
    • "Registrar una reclamación": el programa abre casos en SyBox. No puede enviar mensajes.
    • "Importar SMS desde un teléfono": un teléfono reenvía sus mensajes SMS a la bandeja de entrada.
  5. Completa el "Nombre del dispositivo o programa", por ejemplo "Ordenador de la oficina" o "Sistema de contabilidad". Dale a cada dispositivo o programa su propia clave.
  6. Para una clave de tipo "Enviar por WhatsApp", configura también:
    • "Envía desde": el número de WhatsApp desde el que envía esta clave (obligatorio).
    • "Permitir mensajes de texto libre": activado o desactivado.
    • "Permitir plantillas aprobadas": activado o desactivado. Al menos uno de estos dos debe estar activado, o verás: "Permite al menos texto libre o plantillas; de lo contrario, la clave no podrá enviar nada".
    • "Permitir envío de multimedia": activado o desactivado.
    • "Plantillas" (opcional): nombres de las plantillas, separados por comas. Déjalo vacío para permitir cualquier plantilla.
    • "Países de destinatarios permitidos" (opcional): códigos de país de dos letras, por ejemplo MA,FR,EG. Déjalo vacío para permitir cualquier país.
    • "Envío permitido de" ... "Para": el horario en el que la clave puede enviar. Deja ambos iguales para no aplicar límite de tiempo. Las horas corresponden a la zona horaria local del espacio de trabajo.
    • "Límite diario de mensajes (0 = ilimitado)".
  7. Para una clave de tipo "Importar SMS desde un teléfono", configura "Solo contactos y clientes". Cuando está activado, un SMS de cualquier otro número se queda en el teléfono y nunca llega a la bandeja de entrada. Desactívalo solo si el teléfono se usa exclusivamente para el trabajo.
  8. Haz clic en Guardar.
  9. Una ventana muestra la "URL base" y la "Clave API". Cópialas ahora. "Copia esta clave ahora — solo se muestra una vez.". Introdúcelas en la configuración de tu programa.

Preguntas

He perdido mi clave de API. ¿Puedo volver a verla?

No. Solo se muestra una vez. Crea una clave nueva, ponla en tu programa y luego elimina la clave antigua.

Creo que se ha filtrado una clave. ¿Qué hago?

Elimina esa clave o desactívala de inmediato. Solo esa clave dejará de funcionar. Tu número de WhatsApp y tus otras claves no se verán afectados.

La lista "Envía desde" está vacía.

La lista solo muestra números de WhatsApp que están conectados y activados. Conecta primero un número en Configuración > Mensajería > Canales.

Mi programa recibe un rechazo al enviar.

Comprueba que el interruptor "Puerta de enlace de API" esté activado y que la clave esté activa. Revisa también los límites de la clave: texto libre vs. plantillas, multimedia, plantillas permitidas, países permitidos, horario de envío y límite diario. Las propias reglas de WhatsApp también se siguen aplicando. Por ejemplo, el texto libre solo funciona dentro de las 24 horas posteriores al último mensaje del cliente.

¿Puede una clave de tipo "Registrar una reclamación" enviar también mensajes?

No, por diseño. Una clave que registra casos no puede enviar mensajes a los clientes, y una clave de envío no puede registrar casos. Usa una clave distinta para cada tarea.

Tengo una clave antigua del tipo "Recibir de un programa". ¿Sigue funcionando?

Sí, las claves existentes de ese tipo siguen funcionando. Ya no se pueden crear claves nuevas de ese tipo. Utiliza "Registrar una reclamación" para ese tipo de tarea.

Más sobre Claves de API.