Planejar os eventos necessários

Um webhook envia informações da operação para outro sistema quando os eventos selecionados ocorrem. Antes de ativar, defina a finalidade, o responsável técnico e quais dados o sistema receptor realmente precisa receber.

  • Use uma URL mantida pela empresa ou por um fornecedor autorizado.
  • Comece apenas com os eventos indispensáveis.
  • Defina como falhas e ações repetidas serão identificadas no sistema receptor.
  • Prepare registros fictícios para a validação inicial.

Configurar o webhook

  1. 1

    Acesse Configuração > Configurações e abra Integrações > Webhooks.

  2. 2

    Informe a URL que receberá os eventos.

  3. 3

    Ative a opção Ativar webhook.

  4. 4

    Ative Webhook mensagens somente se a integração precisa receber eventos de mensagens.

  5. 5

    Escolha separadamente os eventos de criar canal e atualizar canal.

  6. 6

    Escolha separadamente os eventos de criar usuário e atualizar usuário.

  7. 7

    Quando necessário, ative criar API, atualizar API e renovar API.

  8. 8

    Revise o conjunto selecionado e salve a configuração.

Validar com eventos controlados

  1. 1

    Crie ou altere um registro fictício correspondente a um dos eventos ativados.

  2. 2

    Confirme no sistema receptor se o evento foi registrado.

  3. 3

    Compare tipo, data e identificação do registro com a ação realizada no Atendeu Rápido.

  4. 4

    Repita o teste para cada grupo de eventos necessário.

  5. 5

    Consulte o log de auditoria para relacionar a alteração ao usuário responsável.

  6. 6

    Desative os eventos que não forem usados depois da validação.

Proteger os dados enviados

  • Documente a finalidade e o responsável por cada webhook ativo.
  • Restrinja no sistema receptor quem pode visualizar mensagens e dados de usuários.
  • Evite registrar conteúdos completos em logs quando apenas a identificação do evento for necessária.
  • Monitore indisponibilidade e crescimento inesperado do volume recebido.
  • Antes de trocar ou desativar a URL, combine a mudança com a equipe que mantém o sistema receptor.