Saltar al contenido principal

Descripción general

Los webhooks conectan la actividad de Quo con las demás herramientas que usa tu empresa. Actualiza automáticamente tu CRM cuando llegue un mensaje, registra las llamadas finalizadas o activa un flujo de trabajo cuando cambie una tarea, sin tener que pasar información manualmente de un sistema a otro. La página Webhooks reúne en un solo lugar los webhooks creados en la app y mediante la API. Ahora ambos usan la misma versión, lo que te da acceso a más tipos de eventos directamente en Quo, como la actividad de tareas y otros eventos de llamadas.

Cómo funcionan los webhooks

Elige los eventos que quieres monitorizar e indica una URL para tu aplicación. Cuando se produce un evento que coincide, Quo envía a esa URL una solicitud HTTP POST con los datos del evento. Tu aplicación puede usar esta información para actualizar un registro, avisar a tu equipo o iniciar un flujo de trabajo. Quo registra los resultados de cada entrega y reintenta automáticamente las que no se completan. Necesitas permisos de propietario o administrador del espacio de trabajo para configurar webhooks. Esta configuración está disponible en la app de Quo para web y desktop. Imagen

Eventos de webhook disponibles

Crea flujos de trabajo en torno a llamadas, mensajes, contactos y tareas. Por ejemplo, avisa a tu equipo cuando haya una llamada perdida, haz seguimiento de los problemas de entrega de mensajes, mantén al día las fichas de cliente o responde cuando se asigne o se complete una tarea. Con los eventos de grabaciones, resúmenes y transcripciones, tus flujos de trabajo pueden actuar en cuanto esos recursos estén disponibles.
Explora los eventos compatibles Visita Cargas útiles de eventos de webhook para consultar la lista completa de eventos, cuándo se activa cada uno y ejemplos de los datos que envía. Usa esta referencia para elegir los disparadores adecuados y saber qué información tienen a su disposición tus flujos de trabajo.

Configuración de webhooks

Antes de comenzar, ten listo un endpoint HTTPS que reciba las solicitudes de webhook. Si otra persona se encarga de mantener tu integración, compártele la descripción general de webhooks para desarrolladores.
  1. Ve a Settings → Webhooks en Quo.
  2. Selecciona Create webhook.
  3. Introduce la URL de tu controlador de webhooks.
  4. Selecciona los tipos de eventos que quieres recibir.
  5. Para los eventos de llamadas y mensajes, elige los números de teléfono que quieres supervisar. Los eventos de contactos se aplican a todo el espacio de trabajo.
  6. Si quieres, añade una Etiqueta para identificar el webhook con más facilidad.
  7. Guarda el webhook.
  8. Abre sus detalles y selecciona Send test request para probar tu endpoint.
  9. Revisa el resultado en el Events log y comprueba que tu aplicación procesa la solicitud correctamente.
Los webhooks nuevos que se crean en la app usan la versión más reciente. Los webhooks creados a través de la API también aparecen en la tabla.

Administrar webhooks

Abre un webhook desde la tabla para revisar su configuración y su actividad de entrega.
  • Estado: Activa o desactiva el webhook.
  • URL: Revisa o actualiza el endpoint que recibe los eventos.
  • Secreto de firma: Úsalo para verificar que las solicitudes provienen de Quo.
  • Etiqueta: Agrega un nombre fácil de reconocer.
  • Tipos de eventos: Elige qué eventos activan las notificaciones.
  • Events log: Revisa los resultados de entrega para investigar posibles problemas.

Migración de webhooks heredados

Los webhooks existentes siguen funcionando con normalidad. Te recomendamos migrarlos cuando te venga bien para aprovechar los tipos de eventos y las funciones más recientes. Un icono de advertencia junto a la URL de un webhook y una etiqueta Webhook heredado en su página de detalles indican que se trata de una versión anterior. Estos indicadores no significan, por sí solos, que el webhook haya fallado.

Para migrar un webhook heredado

  1. Abre la página Webhook details del webhook heredado.
  2. Selecciona Guía de migración para revisar los cambios necesarios.
  3. Selecciona Duplicate as new webhook para crear un reemplazo con la versión más reciente.
  4. Actualiza tu aplicación receptora para que admita el nuevo formato de eventos y la validación de firmas.
  5. Usa Send test request en el reemplazo para confirmar que tu aplicación procesa correctamente el nuevo formato.
  6. Cuando estés listo para hacer el cambio, desactiva el webhook heredado con su interruptor estado y, después, activa el reemplazo.
Tu webhook heredado puede seguir funcionando mientras preparas el reemplazo. Un webhook heredado y su reemplazo migrado no pueden estar activados a la vez.
Haz pruebas antes del cambio Es posible que tengas que modificar tu aplicación receptora para que procese el nuevo formato de eventos. Pide a la persona responsable de tu integración que revise la guía de migración y pruebe el reemplazo antes de activarlo.

Solución de problemas

Si no te llegan las notificaciones:
  • Confirma que el webhook esté activado.
  • Verifica que su URL sea correcta y esté accesible.
  • Comprueba que tengas seleccionados los tipos de eventos y los números de teléfono correspondientes.
  • Selecciona Send test request y revisa el Events log para detectar problemas de entrega.
  • Confirma que tu aplicación acepte el formato del evento, valide la firma y devuelva una respuesta satisfactoria.
¿Estás creando o depurando tu integración? En la descripción general de webhooks para desarrolladores se explica cómo funciona la entrega, los reintentos y el control de versiones. Consulta Validar firmas de webhooks para saber cómo verificar las solicitudes entrantes.

Recursos adicionales

¿Necesitas ayuda? Envía una solicitud de soporte.