A documentação mais atualizada das APIs da Cloud Humans fica em docs.cloudhumans.com/api-reference. Em caso de divergência entre este artigo e a referência, vale o que está lá.
Quando usar
- Você viu o aviso "Falha no envio do webhook" nas mensagens de um ticket e quer saber o que significa
- Você quer saber se esse aviso afeta o atendimento ou o envio de mensagens
O que é esse aviso
O aviso aparece quando uma regra de automação da sua conta tenta enviar dados para um endpoint externo (webhook) e esse endpoint não confirma o recebimento.
É comum em contas que usam automações do tipo "Mensagem recebida" ou "Ticket resolvido" para mandar uma cópia dos dados para um sistema próprio (planilha, script, ERP, ferramenta de BI).
O aviso não afeta o atendimento. O envio e o recebimento das mensagens (inclusive no WhatsApp) continuam funcionando normalmente, e a ClaudIA também não é impactada. O que falha é apenas a integração paralela que deveria receber esses dados.
Como investigar
- Vá em Configurações → Automação e identifique as regras que enviam dados para um endpoint externo.
- Confira a URL de destino de cada uma.
- Teste essa URL fora do Cloud Chat: ela precisa responder confirmando o recebimento. Se ela redireciona (resposta
302) ou passa a exigir login, o envio é considerado falha.
Caso comum — Google Apps Script: a implantação precisa estar como "Qualquer pessoa tem acesso", executando como o dono do script. Quando a implantação é alterada (ou o link antigo passa a exigir login), o endpoint começa a redirecionar e todas as tentativas falham — às vezes por meses, sem ninguém notar.
Observações
- Quem administra o endpoint (seu time ou quem cuida do script/integração) é quem precisa corrigir a implantação — o ajuste não é no Cloud Chat.
- Se a integração não é mais usada, o caminho mais limpo é desativar a regra de automação que faz o envio, e o aviso deixa de aparecer.