​
Webhooks

Os webhooks são uma forma de receber notificações em tempo real quando certos eventos ocorrem na plataforma Salvy. Em vez de solicitar constantemente atualizações à API (polling), os webhooks permitem que a Salvy envie informações diretamente para seu sistema assim que um evento acontece.

​
Como funcionam os webhooks

  1. Crie uma URL em seu sistema para receber as requisições de webhook
  2. Entre em contato com a Salvy para registrar essa URL na plataforma
  3. Quando um evento relevante ocorre (como o recebimento de um SMS), a Salvy envia uma requisição HTTP POST para sua URL
  4. Seu sistema processa os dados recebidos e responde com um código de status HTTP 2xx para confirmar o recebimento

​
Formato da requisição

Todas as requisições de webhook seguem o mesmo formato padrão: 
{
  "type": "event.name",
  "timestamp": "2025-09-03T12:34:56Z",
  "data": {
    // Dados específicos do evento
  }
}
CampoDescrição
typeIdentificador do tipo de evento (ex: sms.received)
timestampData e hora em que o evento foi gerado, em formato ISO8601
dataObjeto contendo os dados específicos do evento

​
Segurança

Para garantir a autenticidade das requisições de webhook, recomendamos:
  1. Utilizar HTTPS para sua URL de webhook
  2. Validar a origem da requisição verificando os cabeçalhos HTTP
  3. Implementar um mecanismo de retry e timeout adequado para lidar com falhas temporárias

​
Eventos disponíveis

Atualmente, a Salvy oferece os seguintes eventos via webhook:
  • SMS Recebido: notifica quando um SMS é recebido por um número virtual
Para mais detalhes sobre cada evento, consulte a documentação específica.

​
Testes

Para realizar testes na sua integração de Webhooks, recomendamos o uso da seguinte ferramenta: Standard Webhooks - Simulate Webhooks