Webhooks de tareas de Telegram en Deskgram 2

Webhooks de tareas de Telegram en Deskgram 2

Envía eventos de Deskgram 2 a tu CRM, receptor HTTP o servicio de automatización. Elige destino, eventos y campos JSON y revisa resultados y errores en el registro de entregas.

Configuración del módulo

Abre Ajustes → Webhooks o el módulo independiente. Configura URL, eventos, filtro de módulos y activación. Se envía POST JSON con un tiempo de espera de 3–60 segundos, 15 por defecto. Puedes añadir Authorization y un secret. X-Deskgram-Signature utiliza HMAC-SHA256 sobre los bytes exactos del cuerpo; el secret también se envía en x-secret y X-Deskgram-Webhook-Secret por compatibilidad, por lo que conviene usar HTTPS en producción. task.completed, task.failed y task.cancelled proceden del gestor de tareas. message.sent, message.failed y lead.reply_received están conectados actualmente a spam_pm, no a todos los módulos. Una respuesta del contacto no equivale a una compra. El JSON deskgram incluye schema_version, event, occurred_at y source; task contiene ID, módulo, estado, número de cuentas, tiempos, params, statistics y result. Los eventos privados incluyen module, task, account, lead y message; los datos del contacto dependen de la información disponible. short_result, crm_lead y custom asignan campos y omiten valores ausentes.

Comprobación antes de ejecutar

La prueba envía webhook.test sin task, lead ni message; algunos campos asignados pueden faltar. HTTP 2xx indica entrega, no procesamiento terminado en el CRM. Otros códigos o errores de conexión producen hasta 3 intentos, con pausas de 2 y 4 segundos. Los reintentos automáticos conservan X-Deskgram-Delivery-Id; el receptor debe gestionar duplicados. El reintento manual solo está disponible para error, crea otro ID y aplica la configuración y asignación actuales al evento original guardado: el JSON puede cambiar. No hay cola persistente ni continuación automática tras reiniciar, ni garantía de entrega exactamente una vez. El registro muestra pending, retrying, success o error, intentos, último código HTTP, respuesta, error y tiempos. Los detalles incluyen source_payload y request_payload; se guardan hasta 2000 caracteres de respuesta. Los intentos automáticos actualizan una fila y el manual crea otra. Prueba el receptor y después un evento real de tu propia tarea; la prueba del endpoint no verifica la generación de eventos de negocio. MCP controla tareas; los webhooks envían avisos al exterior.

Tareas y guías relacionadas

Elige una tarea relacionada o abre la guía detallada. Los enlaces a guías en ruso indican su idioma.

Más módulos de Deskgram 2