Cómo añadir un webhook

Actualizado el

En SyBox, esto se hace en Configuración > Integraciones > Webhooks.

  1. Ve a Configuración > Integraciones > Webhooks.
    Settings, Webhooks: an active webhook with its last result, and the "Add webhook" button
  2. Haz clic en "Añadir webhook".
    The new webhook window: its name and the address it calls
  3. Introduce un "Nombre".
  4. Introduce la "URL de destino". Debe ser "Una dirección https pública a la que podamos llegar". Las direcciones http estándar y las redes privadas o internas serán rechazadas.
  5. En "Eventos", activa al menos un evento. "Mensaje entrante" está seleccionado por defecto.
  6. Opcional: activa "Transcripción de voz" para recibir las notas de voz acompañadas de su transcripción en texto.
  7. En "Números", mantén activada la opción "Todos los números" para abarcar cualquier línea de WhatsApp. O desactívala y marca solo los números que prefieras.
  8. Haz clic en Guardar.
  9. Aparecerá una ventana con la "Clave de firma". "Cópiala ahora — solo se muestra una vez". Guárdala en tu servidor.

Preguntas

He perdido la clave de firma.

No se puede volver a mostrar. Edita el webhook, escribe una clave nueva elegida por ti en "Clave de firma", guárdala y actualiza esa misma clave en tu servidor.

Mi webhook se desactivó y yo no lo hice.

SyBox lo desactivó después de que tu servidor fallara 20 veces seguidas durante más de una hora. Consulta "Desactivado por sí solo" más arriba: repara tu servidor y vuelve a activar el webhook antes de 24 horas para que se envíen los eventos pendientes.

Mi webhook nunca recibe datos.

Primero haz clic en "Enviar evento de prueba" en su tarjeta y mira en "Entregas". Luego comprueba estos cuatro aspectos: (1) El webhook está activado. (2) Hay al menos un evento seleccionado. (3) Incluye el número de WhatsApp correcto o la opción "Todos los números". (4) El canal por el que llegó el mensaje es uno de los que admiten los webhooks (WhatsApp, Messenger, Instagram, Telegram, TikTok o Chat en vivo; no email ni SMS). Por último, comprueba el resultado de la última entrega en la tarjeta.

La tarjeta muestra un error en rojo como HTTP 404 o 500.

SyBox ha podido contactar con tu dirección, pero tu servidor ha devuelto un error. Comprueba la URL y los registros de actividad de tu servidor.

No puedo crear un webhook. Me aparece un aviso de falta de permisos.

Para crear un webhook o reactivar uno en pausa, se requieren los permisos "Administrar canales" y "Mostrar el número del contacto". Contacta con tu administrador.

Más sobre Webhooks.