O que são webhooks?
Webhooks permitem que a SocialSell envie notificações automáticas para o seu sistema quando eventos ocorrem — como um novo contato criado, um negócio ganho ou uma mensagem recebida. Em vez de fazer polling constante na API, você recebe os dados imediatamente.Eventos disponíveis
Mais eventos serão adicionados em versões futuras. Acompanhe o roadmap em socialsell.canny.io.
Criando uma assinatura
Requer o escopowrite:webhooks e plano Growth ou superior.
secret — armazene-o com segurança para validar as entregas:
Formato do payload
Cada evento entregue tem o seguinte formato:Validando a assinatura
Cada requisição inclui o headerX-SocialSell-Signature com um HMAC-SHA256 do corpo usando seu secret:
Política de retentativas
A SocialSell tenta entregar cada evento com as seguintes regras:- Timeout: 10 segundos para o endpoint responder
- Sucesso: resposta HTTP
2xx - Falha: qualquer outro status ou timeout
- Retentativas: após falha, tenta novamente com backoff exponencial
- Desativação automática: após múltiplas falhas consecutivas, a assinatura é pausada automaticamente (campo
consecutive_failures)
Gerenciamento de assinaturas
Idempotência
Eventos podem ser entregues mais de uma vez em casos de falha. Use o campoid do evento para garantir idempotência no processamento:

