Como funciona um webhook de SMS
Quando você envia um SMS, a operadora informa o status (enviado, entregue, falhou). A SMSGo recebe esse status e faz uma requisição HTTP POST para a URL que você cadastrou, enviando os dados em JSON.
Definição
Webhook é um mecanismo de comunicação entre sistemas onde um evento em uma aplicação dispara automaticamente o envio de dados para uma URL configurada em outra aplicação. Ao contrário de APIs onde você precisa consultar, o webhook avisa quando algo acontece.
Principais status de entrega
Os status mais comuns são: queued (na fila), sending (enviando), delivered (entregue), failed (falhou) e expired (expirado). Com esses dados você pode atualizar seu painel, reenviar ou alertar o usuário.
Segurança de webhooks
A SMSGo assina os webhooks com HMAC-SHA256. Seu backend pode validar a assinatura para garantir que o payload realmente veio da SMSGo e não foi adulterado.
Perguntas frequentes
Preciso de endpoint HTTPS?
Sim, recomendamos HTTPS para segurança. O endpoint deve aceitar requisições POST e responder com status 2xx.
O que acontece se meu endpoint falhar?
A SMSGo tenta entregar o webhook algumas vezes com backoff. Se o endpoint continuar falhando, o retry é interrompido.
Posso configurar múltiplos webhooks?
Geralmente você configura um webhook por conta, mas pode encaminhar os eventos para vários sistemas internos a partir do seu endpoint.
Webhooks são gratuitos?
Sim. O recebimento de webhooks de status de entrega é um recurso incluído na SMSGo.
Comece agora com R$ 10 grátis
Sem cartão de crédito. Sem mensalidade. Créditos não expiram.
Criar conta grátis