Cubra SMS, chamadas, WhatsApp e e‑mail com nomes de evento precisos.
WEBHOOK V2 · Todo evento móvel entregue ao seu software
Transforme cada evento do seu móvel conectado em uma ação instantânea.
SMSMobileAPI Webhook V2 envia eventos estruturados HTTPS para suas aplicações quando um SMS é submetido, enviado, falha ou é recebido, quando uma chamada móvel é perdida, entrante ou de saída, e quando ocorrem atividades suportadas de WhatsApp ou e‑mail. Configure tudo visualmente a partir do seu painel — sem necessidade de polling.
Leia a documentação de APIEscolha os eventos que cada destino recebe. Teste, pause, monitore e rotacione o segredo de assinatura a partir de um único espaço de trabalho.
SMSChamadaWAE‑mail
JSON assinado
SMSMobileAPIWebhookV2Fila de eventos persistente
Ao vivo
HTTPS POST
CRMSuporteAutomaçãoAnálises
Envie diferentes grupos de eventos para diferentes destinos HTTPS.
Verifique cada requisição usando sua assinatura HMAC-SHA256 e o carimbo de data/hora.
Falhas temporárias de destino são tentadas novamente sem bloquear outras contas.
Como o WEBHOOK V2 funciona
De um evento móvel real até a sua aplicação em três passos claros.
Seu móvel conectado e os serviços SMSMobileAPI produzem eventos operacionais. Webhook V2 coloca cada evento elegível em uma fila de entrega persistente e envia um payload JSON assinado para os HTTPS URL que você selecionou.
- 1
Um evento acontece
Uma mensagem é submetida, um móvel envia ou recebe um SMS, uma chamada muda de estado, ou atividades suportadas de WhatsApp e e‑mail são registradas.
- 2
Webhook V2 roteia o evento
SMSMobileAPI cria um ID de evento estável e enfileira uma entrega apenas para destinos inscritos nesse tipo de evento.
- 3
Seu software reage
Seu endpoint público HTTPS verifica a assinatura, armazena o ID do evento e inicia seu fluxo de trabalho de CRM, suporte, alertas ou automação.
15 tipos de eventos precisos
Inscreva‑se apenas nos eventos móveis que seu fluxo de trabalho precisa.
Um destino pode receber tudo, ou você pode separar sistemas de produção, análises e alertas operacionais. Cada evento tem um nome preciso para que sua aplicação possa tratá‑lo de forma previsível.
SMS
5sms.api.submittedSMS submetido via API
Uma requisição API criou um trabalho de envio SMS. Útil para confirmar que a requisição entrou na plataforma.
sms.sentSMS enviado
O móvel conectado confirmou a operação de envio de SMS.
sms.failedSMS falhou
O dispositivo móvel conectado devolveu um erro de envio SMS.
sms.receivedSMS recebido
Um dispositivo móvel conectado sincronizou um SMS de entrada.
sms.mobile.sentSMS enviado do dispositivo móvel
Um SMS foi enviado manualmente a partir do dispositivo móvel conectado.
Chamadas
3call.missedChamada perdida
Uma chamada perdida foi sincronizada de um dispositivo móvel conectado.
call.incomingChamada recebida
Uma chamada recebida foi sincronizada de um dispositivo móvel conectado.
call.outgoingChamada de saída
Uma chamada de saída foi sincronizada de um dispositivo móvel conectado.
whatsapp.submittedWhatsApp submetido
Um trabalho de envio de WhatsApp foi criado.
whatsapp.sentWhatsApp enviado
O ambiente WhatsApp conectado confirmou que a mensagem foi enviada.
whatsapp.failedWhatsApp falhou
A operação de envio de WhatsApp falhou.
whatsapp.receivedWhatsApp recebido
Uma mensagem WhatsApp foi recuperada após a conta solicitar sincronização.
whatsapp.voice.transcribedMensagem de voz transcrita
Uma mensagem de voz WhatsApp recuperada e elegível foi convertida em texto utilizável.
email.sentE-mail enviado
Um pedido de envio de e-mail foi criado por SMSMobileAPI.
email.receivedE-mail recebido
Uma caixa de correio conectada recebeu um e-mail.
Configure tudo visualmente
Gestão profissional de webhooks sem editar ficheiros de configuração.
Abra Webhook V2 no painel SMSMobileAPI, adicione um nome de destino e um HTTPS público URL, selecione os eventos e depois guarde. O painel fornece os controlos necessários para a operação diária e resolução de problemas.
Vários destinos
Crie destinos dedicados para o seu CRM, monitorização, análise ou aplicações de clientes.
Filtros de eventos
Selecione exatamente quais eventos de SMS, chamadas, WhatsApp e e-mails cada URL recebe.
Teste de entrega
Envie um evento de teste controlado antes de confiar no destino em produção.
Pausar e reativar
Pause um destino instantaneamente sem eliminar a sua configuração.
Rotação de segredo
Gere um novo segredo de assinatura quando o seu processo de segurança o exigir.
Atividade de entrega
Revise entregas na fila, entregues, em nova tentativa e falhadas, com informações sobre tentativas e estado HTTP.
Webhook V23 ativos
CRM de produção
https://crm.example.com/hooks/mobileAtivosms.receivedcall.missedwhatsapp.received
Alertas operacionais
https://ops.example.com/eventsAtivosms.failedwhatsapp.failed
Confiabilidade por design
Projetado para entregas confiáveis e independentes.
A entrega por webhook é assíncrona. Seu fluxo de trabalho móvel não espera que um terceiro URL responda, e um destino com falha não bloqueia outro cliente ou destino.
Fila durável
Eventos elegíveis são armazenados antes da entrega para que a indisponibilidade temporária do receptor não apague o evento.
Entrega pelo menos uma vez
Uma entrega pode ser reenviada. Armazene o ID do evento e processe-o apenas uma vez na sua aplicação.
Retentativas progressivas
Falhas temporárias são retentadas com atrasos crescentes, até o limite de tentativas da plataforma.
Isolamento de falhas
Um endpoint lento ou indisponível não pode impedir a entrega para destinos não relacionados.
Proteção automática
Um destino com falhas contínuas pode ser pausado para proteger a fila e sua infraestrutura.
Visibilidade operacional
O painel e o monitoramento do webmaster exibem a saúde da fila, os resultados e os erros de entrega recentes.
Assinado e verificável
Verifique a requisição antes de confiar no evento.
Cada entrega inclui um carimbo de data/hora, identificador de entrega, tipo de evento, chave de idempotência estável e assinatura HMAC-SHA256. Mantenha o segredo de assinatura no seu servidor, calcule a assinatura a partir do corpo bruto da requisição e rejeite requisições inválidas ou obsoletas.
X-SMSMobileAPI-EventO tipo de evento, como sms.received.X-SMSMobileAPI-DeliveryO identificador único de entrega para este destino.X-SMSMobileAPI-TimestampUnix timestamp usado durante a verificação da assinatura.X-SMSMobileAPI-SignatureAssinatura HMAC-SHA256 para comparação segura.Idempotency-KeyUUID estável do evento usado para prevenir processamento duplicado.Envelope de evento consistente
Um envelope JSON consistente para cada canal.
O envelope permanece previsível através de SMS, chamadas, WhatsApp e e-mail. O objeto data contém os campos relevantes para o tipo de evento, enquanto os identificadores de nível superior permitem rotear e desduplicar cada entrega.
id— identificador de evento estáveltype— tipo de evento exatooccurred_at— quando a atividade ocorreudata— informações específicas do canal
{
"id": "whv2_01J...",
"type": "sms.received",
"api_version": "2026-09-22",
"created_at": "2026-09-22T12:00:00Z",
"occurred_at": "2026-09-22T11:59:58Z",
"data": {
"guid": "...",
"from": "+32...",
"message": "Can you call me back?"
}
}Do evento ao resultado de negócio
Faça a comunicação móvel acionar a próxima ação de negócio.
Conversas no CRM
Adicione uma mensagem SMS ou WhatsApp recebida ao contato correto e alerte o responsável designado.
Recuperação de chamadas perdidas
Crie uma tarefa de retorno, envie um SMS de acompanhamento ou notifique a equipe de plantão após uma chamada perdida.
Suporte ao cliente
Abra ou atualize um ticket de suporte quando um cliente responder pelo seu dispositivo móvel.
Operações de e-commerce
Atualize os fluxos de comunicação de pedidos após uma mensagem móvel ser enviada, confirmada ou falhar.
Monitoramento e alertas
Envie falhas de entrega ou atividade de chamadas incomum para suas ferramentas de observabilidade e gerenciamento de incidentes.
Fluxos de trabalho de IA e dados
Alimente eventos autorizados em fluxos de classificação, relatórios ou assistência sem consultar repetidamente o API.
Pare de consultar por alterações
A consulta faz solicitações repetidas. Os webhooks notificam seu software quando algo muda.
A consulta consome requisições mesmo quando nada aconteceu e acrescenta atraso entre as verificações. Webhook V2 envia o evento relevante para seu endpoint, tornando a automação mais rápida, simples e fácil de escalar.
Algum evento novo?Solicitações repetidas · atraso adicional
Evento
Notifique-me quando acontecer.Evento relevante · fluxo de trabalho imediatoFAQ do Webhook V2
Dúvidas antes de conectar seu endpoint.
Preciso criar um loop de consulta?＋
Não. Webhook V2 envia os eventos aos quais você se inscreveu para seu endpoint público HTTPS. Você ainda pode usar as APIs quando precisar consultar histórico ou detalhes.
Posso configurar vários URLs de webhook?＋
Sim. Você pode criar múltiplos destinos e escolher um conjunto diferente de eventos para cada um, dentro dos limites da conta exibidos no painel.
Como sei que um SMS foi realmente enviado?＋
Use sms.api.submitted para saber que a tarefa foi criada e sms.sent para a confirmação enviada pelo dispositivo móvel conectado. Trate-os como duas fases operacionais diferentes.
Um webhook pode ser entregue mais de uma vez?＋
Sim. Webhook V2 utiliza entrega 'pelo menos uma vez' (at-least-once). Salve o ID estável do evento ou o Idempotency-Key e ignore uma entrega que você já processou.
O que meu endpoint deve retornar?＋
Retorne uma resposta 2xx HTTP após aceitar o evento com segurança. O processamento pode continuar assincronamente na sua aplicação.
Os eventos WhatsApp recebidos são coletados continuamente?＋
Não. A recuperação de mensagens recebidas do WhatsApp segue um processo próprio de sincronização baseado em consentimento. O evento whatsapp.received fica disponível depois que uma mensagem elegível for recuperada.
Seus eventos móveis. Seu software. Suas ações.
Conecte seu software à atividade do seu dispositivo móvel real agora.
Crie sua conta ou faça login, abra o Webhook V2, adicione um destino HTTPS público e escolha os eventos que importam para seu fluxo de trabalho. Envie um evento de teste, verifique sua assinatura e ative sua integração.
