En resumen
- Nueve eventos entre los que elegir.Conversaciones, mensajes, traspasos, estado, leads, contactos, valoraciones, reservas y uso.
- Firmados con un estándar abierto.Cada entrega sigue Standard Webhooks, para que su servidor pueda demostrar que viene de OneType.
- Reintentos durante unos tres días.Una entrega fallida se reintenta según un calendario que va de 5 segundos hasta 24 horas.
- Un registro que puede repetir.Vea cada intento durante 30 días y reenvíe cualquier evento con un clic.
Un lead que solo está en una herramienta de chat es un lead que se olvida. Un webhook es un mensaje que OneType envía a una dirección de su servidor cada vez que ocurre algo. Úselo para añadir leads a su CRM, abrir tickets, avisar a su equipo o actualizar un panel, sin que nadie copie datos a mano.
Los eventos
- conversation.created: un visitante inicia una conversación.
- conversation.message.created: se completa un mensaje, del visitante, del agente o de su equipo.
- conversation.handoff.requested: el visitante o el agente piden una persona.
- conversation.status.changed: abierta, escalada, resuelta, sin resolver o fallida.
- lead.captured y contact.identified: un visitante deja datos de contacto o es reconocido como uno de sus usuarios con sesión iniciada.
- usage.threshold.reached: su workspace alcanza el 80 % o el 100 % de su uso mensual.
Cada entrega lleva el mismo objeto que devuelve la API REST para ese recurso, así que un mensaje incluye si lo escribió una IA. Puede suscribir un endpoint a algunos eventos o a todos.
Configúrelo en el panel
En “Developer”, “Webhooks”, un propietario o administrador añade una dirección https y elige los eventos. El secreto de firma se muestra una sola vez, así que guárdelo enseguida. Haga clic en “Send test” para entregar un ping firmado y ver el código de respuesta y el tiempo. Puede rotar el secreto cuando quiera: durante 24 horas firman cada entrega tanto el secreto antiguo como el nuevo, así que nada se rompe mientras cambia.
Entregas en las que confiar
Responda cualquier 2xx en 10 segundos y la entrega cuenta. Si su servidor falla o es lento, OneType reintenta tras 5 segundos, 30 segundos, 2 minutos, 10 minutos, 30 minutos, 1 hora, 3 horas, 6 horas, 12 horas y luego cada 24 horas tres veces. La entrega es al menos una vez, así que guarde la cabecera webhook-id, que es la misma en cada reintento, e ignore las repeticiones. No se garantiza el orden.
Un endpoint que solo falla durante tres días se desactiva, y los propietarios ven un aviso con “Turn back on”. El registro de entregas conserva cada intento durante 30 días con estado, código, tiempo y un extracto de la respuesta, y “Redeliver” envía un evento de nuevo.
Seguridad
Cada solicitud se firma según Standard Webhooks con una marca de tiempo, para que pueda rechazar solicitudes antiguas o repetidas. OneType entrega solo a direcciones https públicas, nunca a redes privadas, y no sigue redirecciones. La documentación para desarrolladores incluye código de verificación para Node.js, Python y PHP.
Ideas para su primer endpoint
- Añada a su CRM o lista de correo cada contacto de lead.captured.
- Abra un ticket en su helpdesk con conversation.handoff.requested.
- Avise al canal de su equipo cuando se escale una conversación.
- Avise a finanzas cuando llegue usage.threshold.reached.
Solo los propietarios y administradores pueden ver y gestionar endpoints, y los secretos no se vuelven a mostrar después de la primera vez. Los demás compañeros no ven los webhooks en absoluto.