Los eventos de Deskwoot llegan a tu propia URL en el momento en que ocurren

Los datos de tu soporte muchas veces tienen que llegar a otro sistema: un CRM que debe enterarse de cada contacto nuevo, una base de datos que cuenta las conversaciones resueltas, tu propia automatización que se ejecuta cuando un cliente valora un chat. Los webhooks lo hacen sin código que revise Deskwoot todo el tiempo en busca de cambios. Deskwoot llama a tu URL en cuanto pasa algo.

Tú eliges los eventos de cada webhook: conversación creada, actualizada, asignada y resuelta, mensaje creado, contacto creado y actualizado, y CSAT enviado. En el plan Enterprise con los tickets activados, también están ticket creado, actualizado, asignado y resuelto. Un webhook sin ningún evento marcado recibe todos los eventos excepto los de tickets, que solo van a los webhooks que los eligen. Para varias URL, crea un webhook para cada una, con sus propios eventos.

Cada evento es una solicitud POST con un cuerpo JSON que contiene event (el nombre del evento), data (los datos del evento, descritos en la documentación de la API), timestamp y accountId. El encabezado X-Deskwoot-Event indica el evento, y X-Deskwoot-Signature lleva sha256= y el HMAC SHA256 del cuerpo sin modificar, firmado con el secreto del webhook.

Deskwoot envía cada evento al instante, sin cola. Tu endpoint tiene 10 segundos para responder con un estado 2xx. Si la solicitud falla, recibe un error o tarda más, Deskwoot lo intenta una vez más después de 5 segundos, y después el evento se descarta. Muy pocas veces un evento llega dos veces. El cuerpo no tiene un ID de evento, pero una repetición es una copia exacta con el mismo timestamp, así que usa juntos el nombre del evento, el ID del objeto en data y el timestamp para omitir lo que ya procesaste. Deskwoot solo envía a direcciones HTTPS públicas.

Un webhook solo saca datos de Deskwoot. Para responder a los clientes desde tu propio servidor, usa un bot de tipo Webhook personalizado en Configuración → Bots (desde el plan Startup). Para responder a los clientes, asignar, etiquetar o resolver conversaciones o actualizar contactos desde tu propio código, usa la API REST, que requiere el plan Enterprise. Cada conversación que respondes de cualquiera de las dos formas cuenta como 1 conversación de IA. Los webhooks requieren el plan Startup o uno superior, y la prueba gratis de 7 días los incluye. En el plan Free, los webhooks que creaste antes siguen en la lista, pero no envían nada hasta que tu plan vuelva a incluir webhooks.