Webhooks: reencaminhar SMS recebidas para o seu sistema

Com os webhooks, o SureSMS pode reencaminhar automaticamente as SMS recebidas para outro sistema. Isto é útil quando é necessário guardar as respostas dos clientes ou iniciar uma ação sem intervenção manual.

1. O que é um webhook?

Um webhook é uma mensagem automática enviada de um sistema para outro. Quando um cliente responde à sua SMS, o SureSMS reencaminha automaticamente a mensagem para o seu sistema, sem que seja necessário iniciar sessão para a recuperar.

Fluxo: O cliente envia um SMS → A SureSMS recebe-o → o seu sistema é notificado.

Podes, por exemplo, utilizar os webhooks para:

• guardar respostas num CRM
• iniciar um fluxo no Zapier ou no Make
• registar inscrições para um concurso
• abrir um pedido de assistência

2. É isto que tens de ter bem claro primeiro

1. Uma conta SureSMS com um número capaz de receber SMS. Pode ser o seu próprio número virtual, um SIM hospedado ou uma senha associada a um número curto, por exemplo TAXA em 1414.
2. Um endereço web, ou seja, um URL, que pode receber a mensagem. Normalmente, este provém do sistema para o qual pretende enviar a mensagem, por exemplo, o Zapier, o Make, o HubSpot ou o vosso CRM. Também pode ser fornecido pelo vosso programador.
3. O endereço deve estar acessível a partir da Internet e, de preferência, começar por https://.

3. Como configurar o webhook

1. Inicie sessão no portal SureSMS e aceda a Integrações → Webhooks.
2. Clique Criar um novo webhook.
3. Selecione o tipo no campo Descrição:
   • POST para SMS recebidas (recomendado), se quiser receber os dados em formato JSON. É compatível com a maioria dos sistemas.
   • GET para mensagens recebidas (recomendado), se o seu sistema só puder receber dados contidos no próprio endereço web.
4. Insira o seu endereço web em URI. O portal apresenta um exemplo que deve substituir pelo seu próprio endereço.
5. Selecione em Todos os números, se o webhook deve aplicar-se a todos os seus números ou apenas a um número ou palavra-passe específicos. Uma palavra-passe só é considerada válida se for a primeira palavra da mensagem SMS.
6. Se tiveres selecionado POST, deves preencher Valor POST. Este é o JSON que o SureSMS envia para a tua URL. Utiliza o botão Inserir campo de fusão para inserir valores dinâmicos. O campo pode conter, no máximo, 1000 caracteres.
7. Clique Gema.

4. Campos de junção

Os campos de fusão são substituídos pelos valores corretos quando é recebida uma SMS. Aqui estão os mais utilizados:

Campo trançado	Conteúdo
<%bodyjson%>	O texto da SMS, pronto para JSON. Utilize isto em JSON.
<%body%>	O texto da SMS
<%fromphonenumber%>	Número do remetente
<%receivedbyphonenumber%>	O teu número, para o qual a SMS foi enviada
<%countrycode%>	Código do país do remetente
<%receivedutcdatetime%>	Hora de receção (UTC)

Utilize o menu suspenso no portal para ver a lista completa.

Exemplo: GET

https://ditdomæne.dk/sms?fra=<%fromphonenumber%>&til=<%receivedbyphonenumber%>&tekst=<%body%>

Exemplo: POST

{
  "time": "",
  "sender": "",
  "receiver": "",
  "message": ""
}

Se os valores dos testes forem do remetente +4512345678, recebe +4587654321 e o texto Teste do SureSMS, o exemplo POST surge da seguinte forma:

{
  "time": "2026-10-23T07:54:00Z",
  "remetente": "+4512345678",
  "destinatário": "+4587654321",
  "mensagem": "Teste do SureSMS"
}

5. Como fazer o teste

a) Utilize o botão «Testar»

Na janela de configuração, pode clicar em Teste, antes de guardar. O SureSMS envia uma chamada de teste para o seu endereço com os valores de teste acima. Ser-lhe-á indicado se a operação foi bem-sucedida e qual o código de estado HTTP com que o seu sistema respondeu. Qualquer código da série 200 significa que está a funcionar.

b) Faça um teste a sério

Envie uma SMS do seu telemóvel para esse número. Lembre-se da palavra-passe, se utilizar uma. Em seguida, abra o separador Registo na página «Webhooks» e clique Atualizar. Aqui podes ver exatamente o que foi enviado, qual foi a resposta do teu sistema e quando.

c) Ainda não tens um sistema pronto?

Podes utilizar um serviço de teste gratuito como webhook.site. Este serviço fornece-lhe uma morada temporária. Insira a morada como URI, envie uma SMS de teste e veja a mensagem em tempo real no webhook.site.

6. Se não funcionar

• O teste falha com o erro 400 Bad Request: Utilizas <%bodyjson%> em JSON? O JSON está válido, com aspas e vírgulas corretas?
• O teste funciona, mas não se recebe nada quando se envia uma SMS a sério: É este o número certo? A mensagem SMS começa com a palavra-passe? O webhook foi eliminado?
• Tempo limite: O seu sistema deve responder em poucos segundos. Realize os processamentos mais pesados posteriormente, e não enquanto o SureSMS aguarda uma resposta.
• Endereço inválido: O endereço deve começar por http:// ou https://.
• O seu sistema está temporariamente indisponível: O SureSMS tenta 3 vezes, com intervalos de 1 minuto.
• Firewall: Se pretender autorizar endereços IP fixos, pode solicitá-los contactando a SureSMS.

O webhook é enviado imediatamente após a receção da mensagem SMS. Os webhooks não requerem qualquer subscrição específica, mas é necessário dispor de um meio para receber SMS.