Gerir webhooks

Os webhooks enviam eventos do Klang para o seu servidor. Utilize-os para atualizar um CRM, publicar numa ferramenta de conversação ou iniciar um processo quando o processamento de uma reunião termina.

Os webhooks são pessoais e só recebem eventos de conteúdo ao qual o respetivo utilizador tem acesso.

Criar um webhook

1. Abra Definições → Programadores → Webhooks
2. Clique em Criar webhook

3. Introduza o URL, que tem de ser um endpoint HTTPS público
4. Opcional: adicione uma Descrição
5. Selecione os eventos. Os três estão selecionados por predefinição.
6. Clique em Criar

O Klang mostra o segredo de assinatura depois da criação. Copie-o e guarde-o em segurança. Também pode consultá-lo mais tarde na página de detalhe do webhook. Serve para verificar que os pedidos recebidos vêm do Klang.

Eventos disponíveis

• conversation.ready: a transcrição e a análise de IA estão prontas
• conversation.failed: o processamento de uma reunião ou ficheiro falhou
• conversation.deleted: uma reunião ou ficheiro foi eliminado

Consulte a documentação dos webhooks para ver o esquema, o cabeçalho de assinatura e exemplos de verificação.

Eventos e automatizações

Um endpoint nesta página pode receber duas coisas diferentes, e ajuda saber qual está a configurar.

Os eventos avisam que algo aconteceu. O conversation.ready traz um id, um título e um estado, e o seu servidor vai depois buscar à API o conteúdo de que precisa.

As automatizações enviam o próprio conteúdo. Uma automatização corre apenas nas reuniões que escolher e entrega o relatório terminado, com os nomes de campos que escolher, sem que o seu servidor tenha de ir buscar nada. Isso configura-se no destino Webhook da automatização, não aqui. Usa os mesmos endpoints, por isso há um endereço, uma chave de assinatura e um histórico de entregas em qualquer dos casos.

Um endpoint usado apenas por automatizações não subscreve qualquer evento, por isso não mostra nenhum selecionado aqui. É o esperado.

Monitorizar entregas

A página mostra o estado e URL, o segredo, as estatísticas das últimas 24 horas e as entregas recentes. Abra uma entrega para ver o pedido e a resposta do servidor.

O Klang tenta novamente uma entrega falhada até seis vezes, esperando mais depois de cada tentativa, ao longo de cerca de sete horas. O webhook entra automaticamente em pausa quando cinco entregas seguidas falharam e já falham há pelo menos um dia. Uma falha breve não o desliga. Corrija o endpoint e volte a ativar Receber eventos.

Enviar um evento de teste

1. Abra os detalhes do webhook
2. Clique em Enviar evento de teste
3. Selecione o evento, se necessário
4. Consulte a nova linha em Entregas recentes

Os testes têm a etiqueta TEST e identificadores que começam por evt_test_. Utilizam o mesmo esquema dos eventos reais.

Colocar em pausa ou eliminar

Desative Receber eventos para colocar em pausa sem perder o histórico. Para eliminar, clique em Editar e em Eliminar webhook. Também pode utilizar o menu de três pontos na lista.

Próximos passos

• Consulte a documentação dos webhooks
• Faça a gestão das integrações