Pular para o conteúdo
ArkSales
Operação2 min de leitura

Webhooks do workspace

Cadastre a URL, escolha eventos de contato e negócio e copie o secret HMAC na criação.

Webhook avisa outro sistema quando algo muda na conta. O cadastro fica em Configurações, seção Desenvolvedor, card Webhooks.

Criar

  1. Abra Configurações e clique em Webhooks.
  2. Clique em Novo webhook.
  3. No painel Novo webhook, preencha URL (https://seu-servidor.com/webhook).
  4. Em Descrição (opcional), anote o destino (ERP, planilha, middleware).
  5. Deixe Ativo ligado se quiser receber na hora.
  6. Nos grupos Contato e Negócio, marque os eventos (criação, atualização, exclusão — os tipos técnicos seguem o catálogo da API).
  7. Clique em Criar.

O diálogo Webhook criado avisa: "Copie o secret HMAC antes de fechar. Só aparece agora." Copie Secret HMAC e guarde no servidor que valida a assinatura.

Aviso: Webhook criado com sucesso.

Operar

Na lista, o status é Ativo ou Inativo. Entregas aparecem como Entregue, Falhou (sem retry) ou Pendente / retry.

  • Testar enfileira um envio de prova. O aviso indica teste enfileirado.
  • Editar abre Editar webhook (Salvar, aviso Webhook atualizado.).
  • Remover pede Remover webhook? e confirma com Webhook removido.

Se não funcionar

URL inválida ou fora de HTTPS: corrija o endereço e salve de novo.

Entrega Falhou (sem retry): confira se o endpoint responde 2xx e se a validação HMAC usa o secret copiado na criação. Secret perdido exige criar outro webhook (o valor só aparece uma vez).

Sem acesso ao card: o papel precisa liberar a área de webhooks na matriz de Ver permissões.

Continue aprendendo

Outros tutoriais de Operação