Webhooks
O que são Webhooks?
Webhooks permitem que o Hedy envie dados para outros aplicativos e serviços em tempo real. Quando um evento ocorre - como uma sessão terminando ou um destaque sendo criado - o Hedy envia os dados para uma URL que você especifica. Isso permite que você construa automações poderosas sem nenhuma programação.
Por exemplo, você poderia automaticamente:
-
Salvar transcrições de reuniões no Google Docs ou Notion
-
Publicar recapitulativos de sessão em um canal do Slack
-
Criar tarefas no Asana ou Todoist a partir de itens de ação
-
Registrar dados de sessão em uma planilha
Requisitos
-
Assinatura Hedy Pro - Webhooks são um recurso Pro
-
Cloud Sync ativado - Necessário para que o Hedy possa processar eventos de webhook através da nuvem
Você pode visualizar seus webhooks sem Cloud Sync, mas precisa dele ativado para criar, editar ou acionar webhooks.
Configurando um Webhook
-
Abra o Hedy e vá para Settings
-
Role para baixo até a seção API Access
-
Toque em Manage Webhooks
-
Toque no botão + para adicionar um novo webhook
-
Insira um name (opcional) - um rótulo para ajudá-lo a lembrar para que serve este webhook (ex.: “Zapier — Meeting Notes”)
-
Cole a webhook URL do seu serviço externo - esta deve ser uma URL HTTPS
-
Selecione os events que deseja assinar (veja abaixo)
-
Toque em Create
Você pode criar até 10 webhooks.
Eventos Disponíveis
Escolha quais eventos acionam seu webhook:
Session Created - Dispara quando você inicia uma nova gravação. Envia o título da sessão e horário de início.
Session Ended - Dispara quando uma gravação termina. Envia os dados completos da sessão incluindo transcrição, recapitulativo, atas de reunião, destaques e informações do tópico. Este é o evento mais abrangente.
Session Exported - Dispara quando você exporta manualmente uma sessão para seus webhooks. Envia dados semelhantes ao Session Ended (transcrição, recapitulativo, destaques, etc.).
Highlight Created - Dispara cada vez que um destaque é capturado durante uma sessão. Envia o texto do destaque, insight de IA e timestamp.
Todo Exported - Dispara quando você exporta um item de ação. Envia o texto da tarefa, data de vencimento e sessão associada.
Exportando uma Sessão Manualmente
Além dos eventos automáticos, você pode enviar manualmente qualquer sessão para seus webhooks:
-
Abra uma sessão concluída
-
Toque em Export to Webhook
-
Se você tiver múltiplos webhooks inscritos no evento Session Exported, selecione para quais enviar
-
Confirme a exportação
Testando Seu Webhook
Antes de confiar em um webhook, você pode verificar se funciona:
-
Vá para Settings > API Access > Manage Webhooks
-
Toque no botão test em qualquer webhook
-
O Hedy envia um payload de teste para sua URL e mostra se teve sucesso, junto com o código de status da resposta
Se o teste falhar, verifique se a URL está correta e se seu serviço externo está pronto para receber requisições.
Quais Dados são Enviados?
Cada requisição de webhook é um HTTP POST com um corpo JSON. Os dados dependem do tipo de evento, mas um evento Session Ended inclui:
-
Detalhes da Sessão - Título, horário de início, horário de término, duração
-
Transcrição - O texto completo da sua sessão
-
Conversas - Diálogo estruturado participante por participante
-
Atas de Reunião - Principais pontos de discussão
-
Recapitulativo - Resumo gerado por IA
-
Destaques - Cada destaque com seu insight de IA, citação e timestamp
-
Tópico - O nome do tópico e insights, se a sessão estiver atribuída a um tópico
Segurança e Verificação
Cada requisição de webhook inclui uma assinatura para que você possa verificar que genuinamente veio do Hedy:
-
X-Hedy-Signature header - Um hash HMAC-SHA256 do corpo da requisição, assinado com o secret único do seu webhook
-
X-Hedy-Event header - O tipo de evento (ex.: session.ended)
Todas as URLs de webhook devem usar HTTPS para garantir que seus dados estejam criptografados em trânsito. O Hedy não enviará dados para endpoints HTTP.
Usando Webhooks com Plataformas Populares
Zapier - Crie um Zap com “Webhooks by Zapier” como trigger. Escolha “Catch Hook”, copie a URL do webhook e cole no Hedy.
Make (anteriormente Integromat) - Adicione um módulo “Custom Webhook” como trigger do seu cenário. Copie a URL gerada e cole no Hedy.
n8n - Adicione um nó trigger “Webhook” ao seu workflow. Copie a URL de produção e cole no Hedy.
Entrega e Tentativas
O Hedy automaticamente faz novas tentativas em entregas que falharam:
-
Erros do servidor (5xx) - Retentado até 2 vezes com atrasos crescentes
-
Rate limited (429) - Retentado uma vez, respeitando o timing de retry do serviço
-
Erros do cliente (4xx) - Não retentado, pois normalmente indicam um problema de configuração
Solução de Problemas
Teste do webhook falha - Verifique se a URL está correta, usa HTTPS e se seu serviço externo está ativamente escutando requisições.
Não recebendo eventos - Verifique se o Cloud Sync está ativado, se o webhook está inscrito no evento correto e se sua assinatura Pro está ativa.
Mensagem “Webhooks require Pro” - Faça upgrade para Hedy Pro em Settings > Subscription para acessar webhooks.
Mensagem “Cloud Sync required” - Ative o Cloud Sync em Settings > Cloud Sync, ou toque no botão Enable no banner de aviso mostrado no topo da tela de Webhooks.
Dica Pro: Comece inscrevendo-se no evento Session Ended - ele inclui os dados mais abrangentes e é o mais útil para construir automações em torno das suas notas de reunião.
