Tarefa · Console de administração

Configurar webhooks para desenvolvedores

Receba os eventos do Bridge no seu próprio serviço

Tela
Webhooks
Seção
Integração com o HubSpot
Passos
9
Versão
1.0
Atualizado

Também buscado como: webhooks, desenvolvedores, api, callback url, api key, client secret, hmac, assinatura, eventos, automações, integração personalizada, test

Você abriu o passo 6: Verifique e salve

O que você pode fazer

Receba os eventos do Bridge no seu próprio serviço

Em Developers › Webhooks você registra seu endpoint, protege cada envio com uma assinatura HMAC e escolhe os eventos das suas automações. Em 9 passos.

  • Seu endpoint em Callback URL
  • Assinatura HMAC com Client Secret
  • Recursos do CRM e personalizados
  • Testes com Test

Passos

  1. Passo 1 de 9

    Abra Developers › Webhooks

    Os webhooks são configurados na seção Developers.

    Os webhooks ampliam a integração com automações personalizadas e são voltados a desenvolvedores e administradores técnicos. No console de administração do Bridge, abra Developers › Webhooks no menu lateral.

    • Developers › Webhooks
    • Para desenvolvedores e administradores técnicos

    Ver o passo 1 na tela

  2. Passo 2 de 9

    Informe a Callback URL

    O Bridge envia os eventos ao seu endpoint.

    Em Callback URL, informe o endpoint que receberá os eventos de webhook, por exemplo https://your-service.example.com/webhook. É um campo obrigatório.

    • Endpoint que recebe os eventos
    • Campo obrigatório

    Ver o passo 2 na tela

  3. Passo 3 de 9

    Informe a Bridge-API-Key

    A chave de API autentica a inscrição.

    Em Bridge-API-Key, informe a chave de API. É o cabeçalho de autenticação usado para autenticar as solicitações de inscrição em webhooks. É um campo obrigatório.

    • Cabeçalho de autenticação
    • Autentica as solicitações de inscrição
    • Campo obrigatório

    Ver o passo 3 na tela

  4. Passo 4 de 9

    Informe o Client Secret

    O segredo protege cada envio.

    Em Client Secret, informe o segredo usado para criar uma assinatura HMAC (código de autenticação de mensagens baseado em hash). A assinatura verifica a integridade de cada payload de webhook e evita falsificações. É um campo obrigatório.

    • Cria a assinatura HMAC
    • Verifica a integridade e evita falsificações
    • Campo obrigatório

    Ver o passo 4 na tela

  5. Passo 5 de 9

    Verifique a assinatura no seu endpoint

    Seu serviço confirma que o evento vem do Bridge.

    Cada payload de webhook é assinado com HMAC usando o Client Secret. Seu endpoint deve verificar a assinatura antes de processar o payload, para confirmar que ele vem do Bridge.

    • Cada payload é assinado com HMAC
    • Verifique a assinatura antes de processar

    Ver o passo 5 na tela

  6. Passo 6 de 9

    Verifique e salve

    Salve a configuração do webhook.

    Com os três campos preenchidos, clique em Verify and save.

    • Preencha os três campos
    • Clique em Verify and save

    Ver o passo 6 na tela

  7. Passo 7 de 9

    Revise CRM Connected Features

    Alguns recursos já são reportados com o CRM conectado.

    CRM Connected Features reúne os recursos reportados automaticamente quando há um CRM conectado, como Contact Updates. Você também pode configurá-los para um webhook personalizado se precisar enviá-los a outro destino.

    • Reportados com o CRM conectado
    • Contact Updates
    • Configuráveis para um webhook personalizado

    Ver o passo 7 na tela

  8. Passo 8 de 9

    Escolha Custom Integration Features

    Outros recursos são ativados conforme sua necessidade.

    Custom Integration Features são webhooks opcionais para criar automações por tipos de eventos específicos, todos na versão V1. Task Notifications é disparado quando uma tarefa é criada, atualizada ou concluída; Call Notifications, quando uma chamada é registrada no Bridge; Meeting Notifications, quando uma reunião é criada ou atualizada; Email Notifications, quando uma atividade de e-mail é registrada; e Conversation Summary Notifications, quando um resumo diário da conversa gerado por IA é criado.

    • Webhooks opcionais, versão V1
    • Tarefas, chamadas, reuniões, e-mails e resumos

    Ver o passo 8 na tela

  9. Passo 9 de 9

    Teste cada recurso com Test

    Verifique a integração antes de usá-la.

    Cada recurso configurado tem um botão Test na tela de webhooks. Use-o para enviar um payload de exemplo ao seu endpoint e verificar se a integração funciona corretamente. Se precisar de ajuda, escreva ao suporte em support@sainapsis.com.

    • Clique em Test
    • Seu endpoint recebe um payload de exemplo
    • Verifique se a integração funciona

    Ver o passo 9 na tela