Webhooks: reenvía los SMS recibidos a tu sistema

Gracias a los webhooks, SureSMS puede reenviar automáticamente los SMS entrantes a otro sistema. Esto resulta muy práctico cuando es necesario guardar las respuestas de los clientes o iniciar una acción sin necesidad de intervención manual.

1. ¿Qué es un webhook?

Un webhook es un mensaje automático que se envía de un sistema a otro. Cuando un cliente responde a tu SMS, SureSMS reenvía automáticamente el mensaje a tu sistema, sin que tengas que iniciar sesión para recuperarlo.

Flujo: El cliente envía un SMS → SureSMS lo recibe → tu sistema recibe la notificación.

Por ejemplo, puedes utilizar los webhooks para:

• guardar respuestas en un CRM
• iniciar un flujo en Zapier o Make
• registrar las inscripciones para un concurso
• abrir un caso de asistencia técnica

2. Esto es lo primero que tienes que tener claro

1. Una cuenta de SureSMS con un número capaz de recibir SMS. Puede ser tu propio número virtual, una SIM alojada o una contraseña asociada a un número corto, por ejemplo: TAXA en 1414.
2. Una dirección web, es decir, una URL, que pueda recibir el mensaje. Normalmente procede del sistema al que quieres enviarlo, por ejemplo, Zapier, Make, HubSpot o vuestro CRM. También puede proceder de vuestro desarrollador.
3. La dirección debe ser accesible desde Internet y, a ser posible, empezar por https://.

3. Cómo configurar el webhook

1. Inicia sesión en el portal de SureSMS y ve a Integraciones → Webhooks.
2. Haz clic Crear un nuevo webhook.
3. Selecciona el tipo en el campo Descripción:
   • NOTIFICACIÓN por SMS recibido (recomendado), si quieres recibir los datos en formato JSON. Es compatible con la mayoría de los sistemas.
   • GET en los mensajes recibidos (recomendado), si tu sistema solo puede recibir datos en la propia dirección web.
4. Introduce tu dirección web en URI. El portal muestra un ejemplo que debes sustituir por tu propia dirección.
5. Selecciona en Todos los números, si el webhook debe aplicarse a todos tus números o solo a un número o contraseña concretos. Una contraseña solo se considera válida si es la primera palabra del SMS.
6. Si has seleccionado POST, debes rellenar Valor POST. Ese es el JSON que SureSMS envía a tu URL. Utiliza el botón Insertar campo de combinación para introducir valores dinámicos. El campo puede contener un máximo de 1000 caracteres.
7. Haz clic Gema.

4. Campos de combinación

Los campos de fusión se sustituyen por los valores correctos cuando se recibe un SMS. Estos son los más utilizados:

Campo trenzado	Contenido
<%bodyjson%>	El texto del SMS, listo para JSON. Úsalo en JSON.
<%body%>	El texto del SMS
<%fromphonenumber%>	Número del remitente
<%receivedbyphonenumber%>	Tu número, al que se envió el SMS
<%countrycode%>	Código de país del remitente
<%receivedutcdatetime%>	Hora de recepción (UTC)

Utiliza el menú desplegable del portal para ver la lista completa.

Ejemplo: GET

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

Ejemplo: POST

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

Si los valores de la prueba son del remitente +4512345678, recibe +4587654321 y el texto Prueba de SureSMS, el ejemplo POST se presenta así:

{
  "hora": "2026-10-23T07:54:00Z",
  "remitente": "+4512345678",
  "destinatario": "+4587654321",
  "mensaje": "Prueba de SureSMS"
}

5. Cómo realizar la prueba

a) Pulsa el botón «Probar»

En la ventana de configuración, puedes hacer clic en Prueba, antes de guardar. SureSMS envía una llamada de prueba a tu dirección con los valores de prueba indicados anteriormente. Se te indicará si la operación se ha realizado correctamente y qué código de estado HTTP ha devuelto tu sistema. Cualquier código de la serie 200 significa que funciona.

b) Haz una prueba de verdad

Envía un SMS desde tu propio móvil a ese número. Recuerda la contraseña, si utilizas una. A continuación, abre la pestaña Iniciar sesión en la página «Webhooks» y haz clic en Actualizar. Aquí puedes ver exactamente qué se envió, qué respondió tu sistema y cuándo.

c) ¿Aún no tienes un sistema preparado?

Puedes utilizar un servicio de pruebas gratuito como webhook.site. Te proporciona una dirección temporal. Introduce la dirección como URI, envía un SMS de prueba y consulta el mensaje en tiempo real en webhook.site.

6. Si no funciona

• La prueba falla con el error 400 «Bad Request»: ¿Utilizas <%bodyjson%> ¿En JSON? ¿Es válido el JSON con comillas y comas correctas?
• La prueba funciona, pero no se recibe nada en un SMS de verdad: ¿Es ese el número correcto? ¿Empieza el SMS con la contraseña? ¿Se ha eliminado el webhook?
• Tiempo de espera: Tu sistema debe responder en pocos segundos. Realiza los procesos más pesados después, no mientras SureSMS espera la respuesta.
• Dirección no válida: La dirección debe empezar por http:// o https://.
• Tu sistema está temporalmente fuera de servicio: SureSMS lo intenta tres veces con un intervalo de un minuto entre cada intento.
• Cortafuegos: Si necesitas autorizar direcciones IP fijas, puedes solicitarlas poniéndote en contacto con SureSMS.

El webhook se envía inmediatamente después de recibir el mensaje SMS. Los webhooks no requieren ninguna suscripción especial, pero es necesario disponer de un servicio de recepción de SMS.