Webhooks de tarefas do Telegram no Deskgram 2

Webhooks de tarefas do Telegram no Deskgram 2

Envie eventos do Deskgram 2 para seu CRM, receptor HTTP ou serviço de automação. Escolha destino, eventos e campos JSON e consulte resultados e erros no registro de entregas.

Configurações do módulo

Abra Configurações → Webhooks ou o módulo separado. Defina URL, eventos, filtro de módulos e ativação. A entrega usa POST JSON e espera de 3–60 segundos, com padrão de 15. É possível adicionar Authorization e secret. X-Deskgram-Signature usa HMAC-SHA256 dos bytes exatos do corpo; o secret também é enviado em x-secret e X-Deskgram-Webhook-Secret por compatibilidade, então use HTTPS no destino de produção. task.completed, task.failed e task.cancelled vêm do gerenciador de tarefas. message.sent, message.failed e lead.reply_received estão ligados atualmente a spam_pm, não a todos os módulos. Uma resposta do contato não significa compra. O JSON deskgram contém schema_version, event, occurred_at e source; task inclui ID, módulo, estado, quantidade de contas, tempos, params, statistics e result. Eventos privados incluem module, task, account, lead e message; os contatos dependem dos dados disponíveis. short_result, crm_lead e custom mapeiam campos e omitem valores ausentes.

Verificação antes de executar

O teste envia webhook.test sem task, lead ou message; alguns campos mapeados podem faltar. HTTP 2xx indica entrega, não processamento concluído no CRM. Outros códigos ou falhas de conexão geram até 3 tentativas, com pausas de 2 e 4 segundos. Repetições automáticas mantêm X-Deskgram-Delivery-Id; o receptor deve tratar duplicatas. A repetição manual só está disponível para error, cria novo ID e aplica configurações e mapeamento atuais ao evento original salvo; o JSON pode mudar. Não há fila persistente nem continuação automática após reiniciar, e a entrega exatamente uma vez não é garantida. O registro mostra pending, retrying, success ou error, tentativas, último código HTTP, resposta, erro e tempos. Os detalhes trazem source_payload e request_payload; até 2000 caracteres da resposta são salvos. Tentativas automáticas atualizam uma linha; a manual cria outra. Teste o receptor e depois um evento real de sua tarefa: o teste do endpoint não confirma a geração de eventos de negócio. MCP controla tarefas; webhooks enviam notificações para fora.

Tarefas e guias relacionados

Escolha uma tarefa relacionada ou abra o guia detalhado. Os links de guias em russo indicam o idioma.

Mais módulos do Deskgram 2