Configura webhooks firmados

Los webhooks envían una solicitud HTTP POST a tu aplicación cuando ocurre un evento en ChatbotGen. Están incluidos en Growth y planes superiores.

1. Crea un endpoint

   Abre Configuración → Webhooks, haz clic en Agregar endpoint e ingresa la URL HTTPS pública de tu receptor. Agrega una descripción para que tu equipo lo identifique.

2. Elige eventos y chatbots

   Selecciona todos los chatbots o uno específico y marca los eventos que necesita tu automatización. Por ejemplo: lead.created para un nuevo lead, lead.updated para datos posteriores, appointment.requested para una solicitud de cita o handoff.requested cuando un cliente necesita a una persona. Crea el endpoint.

3. Verifica la firma

   Abre el endpoint y copia su secreto de firma en la configuración segura de tu receptor. Antes de procesar el evento, verifica el cuerpo original de la solicitud con webhook-id, webhook-timestamp y webhook-signature. Usa los ejemplos de código. Rechaza firmas inválidas y marcas de tiempo con más de cinco minutos de diferencia respecto al reloj de tu servidor.

4. Envía una prueba y revisa la entrega

   En la página del endpoint, elige un evento de prueba y envíalo. Revisa el registro de entregas y tu receptor. Devuelve una respuesta 2xx al aceptarlo. Si falla, revisa el error, corrige el receptor y reintenta la entrega desde el registro.

Administra la conexión

Abre un endpoint para editar su URL, filtro de chatbot o eventos; puedes pausarlo cuando lo necesites. Si rotas el secreto, actualiza la configuración de tu receptor y vuelve a probar la verificación.

Los desarrolladores pueden administrar suscripciones REST hooks mediante /api/v2. Consulta la documentación para desarrolladores para conocer la autenticación, los endpoints, los datos y el código de verificación.

La app de ChatbotGen para Zapier estará disponible próximamente; todavía no es pública.