Cubra SMS, llamadas, WhatsApp y correo electrónico con nombres de eventos precisos.
Webhook V2 · Todos los eventos móviles entregados a su software
Convierta cada evento de su móvil conectado en una acción instantánea.
SMSMobileAPI Webhook V2 envía eventos HTTPS estructurados a sus aplicaciones cuando se envía, entrega, falla o recibe un SMS, cuando se pierde, entra o sale una llamada móvil, y cuando se registra actividad compatible de WhatsApp o correo electrónico. Configure todo de forma visual desde su panel—no se requiere bucle de sondeo.
Lee la documentación de APIElija los eventos que recibe cada destino. Pruebe, pause, supervise y rote su secreto de firma desde un único espacio de trabajo.
SMSLLAMARWACorreo electrónico
JSON firmado
SMSMobileAPIWebhookV2Cola de eventos persistente
EN VIVO
POST de HTTPS
Gestión de relaciones con el clienteSoporteAutomatizaciónANÁLISIS
Envíe distintos grupos de eventos a diferentes destinos HTTPS.
Verifique cada solicitud usando la firma HMAC-SHA256 y la marca de tiempo.
Los fallos temporales en un destino se reintentan sin bloquear otras cuentas.
Cómo funciona Webhook V2
De un evento móvil real a su aplicación en tres pasos claros.
Su móvil conectado y los servicios SMSMobileAPI generan eventos operativos. Webhook V2 coloca cada evento elegible en una cola de entrega persistente y envía una carga útil JSON firmada al HTTPS URL que seleccionó.
- 1
Ocurre un evento
Se envía un mensaje, un móvil envía o recibe un SMS, una llamada cambia de estado, o se registra actividad compatible de WhatsApp y correo electrónico.
- 2
Webhook V2 lo enruta
SMSMobileAPI crea un ID de evento estable y encola una entrega solo para los destinos suscritos a ese tipo de evento.
- 3
Su software reacciona
Su endpoint público HTTPS verifica la firma, almacena el ID del evento y activa su flujo de trabajo de CRM, soporte, alertas o automatización.
15 tipos de eventos precisos
Suscríbase solo a los eventos móviles que necesita su flujo de trabajo.
Un destino puede recibirlo todo, o puede separar sistemas de producción, analítica y alertas operativas. Cada evento tiene un nombre preciso para que su aplicación lo gestione de forma predecible.
SMS
5sms.api.submittedSMS enviado a través de API
Una solicitud API creó un trabajo de envío de SMS. Útil para reconocer que la solicitud entró en la plataforma.
sms.sentSMS enviado
El móvil conectado confirmó la operación de envío de SMS.
sms.failedSMS falló
El móvil conectado devolvió un error de envío SMS.
sms.receivedSMS recibido
Un móvil conectado sincronizó un SMS entrante.
sms.mobile.sentSMS enviado desde el móvil
Se envió un SMS manualmente desde el móvil conectado.
Llamadas
3call.missedLlamada perdida
Se sincronizó una llamada perdida desde un móvil conectado.
call.incomingLlamada entrante
Se sincronizó una llamada entrante desde un móvil conectado.
call.outgoingLlamada saliente
Se sincronizó una llamada saliente desde un móvil conectado.
whatsapp.submittedWhatsApp enviado
Se creó un trabajo de envío de WhatsApp.
whatsapp.sentWhatsApp enviado
El entorno WhatsApp conectado confirmó que el mensaje fue enviado.
whatsapp.failedWhatsApp falló
La operación de envío de WhatsApp falló.
whatsapp.receivedWhatsApp recibido
Se recuperó un mensaje WhatsApp después de que la cuenta solicitara la sincronización.
whatsapp.voice.transcribedMensaje de voz transcrito
Un mensaje de voz WhatsApp recuperado y elegible se convirtió en texto utilizable.
Correo electrónico
2email.sentCorreo enviado
Se creó una solicitud de envío de correo electrónico por SMSMobileAPI.
email.receivedCorreo recibido
Un buzón conectado recibió un correo electrónico.
Configura todo visualmente
Gestión profesional de webhooks sin editar archivos de configuración.
Abre Webhook V2 en el panel de control SMSMobileAPI, añade un nombre de destino y un HTTPS URL público, selecciona los eventos y guarda. El panel de control te proporciona los controles necesarios para la operación diaria y la resolución de problemas.
Múltiples destinos
Crea destinos dedicados para tu CRM, monitorización, analítica o aplicaciones de cliente.
Filtros de eventos
Selecciona exactamente qué eventos de SMS, llamadas, WhatsApp y correo electrónico recibe cada URL.
Probar la entrega
Envía un evento de prueba controlado antes de confiar en el destino en producción.
Pausar y reactivar
Detén un destino inmediatamente sin borrar su configuración.
Rotación de secretos
Genera un nuevo secreto de firma cuando tu proceso de seguridad lo requiera.
Actividad de entrega
Revisa entregas en cola, entregadas, en reintento y fallidas, con información de intentos y del estado HTTP.
Webhook V23 activos
CRM de producción
https://crm.example.com/hooks/mobileActivosms.receivedcall.missedwhatsapp.received
Alertas de operaciones
https://ops.example.com/eventsActivosms.failedwhatsapp.failed
Fiabilidad por diseño
Diseñado para una entrega fiable e independiente.
La entrega mediante webhook es asíncrona. Su flujo móvil no espera la respuesta de un tercero URL, y un destino que falle no bloquea a otro cliente o destino.
Cola duradera
Los eventos elegibles se almacenan antes de la entrega para que una indisponibilidad temporal del receptor no borre el evento.
Entrega al menos una vez
Una entrega puede reintentarse. Almacene el ID del evento y procese el evento solo una vez en su propia aplicación.
Reintentos progresivos
Los fallos temporales se reintentan con retrasos crecientes, hasta el límite de reintentos de la plataforma.
Aislamiento de fallos
Un endpoint lento o no disponible no puede detener la entrega a destinos no relacionados.
Protección automática
Un destino con fallos sostenidos puede pausarse para proteger la cola y su infraestructura.
Visibilidad operativa
El panel y la monitorización para webmasters muestran la salud de la cola, los resultados y los errores de entrega recientes.
Firmado y verificable
Verifique la solicitud antes de confiar en el evento.
Cada entrega incluye una marca de tiempo, un identificador de entrega, el tipo de evento, una clave de idempotencia estable y la firma HMAC-SHA256. Mantenga el secreto de firma en su servidor, calcule la firma a partir del cuerpo sin procesar de la solicitud y rechace las solicitudes inválidas o caducadas.
X-SMSMobileAPI-EventEl tipo de evento, por ejemplo sms.received.X-SMSMobileAPI-DeliveryEl identificador único de entrega para este destino.X-SMSMobileAPI-TimestampMarca de tiempo Unix utilizada durante la verificación de la firma.X-SMSMobileAPI-SignatureFirma HMAC-SHA256 para comparar de forma segura.Idempotency-KeyUUID estable del evento usado para evitar el procesamiento duplicado.Estructura consistente de evento
Una estructura JSON consistente para cada canal.
La estructura permanece predecible a través de SMS, llamadas, WhatsApp y correo electrónico. El objeto data contiene los campos relevantes según el tipo de evento, mientras que los identificadores de primer nivel le permiten enrutar y desduplicar cada entrega.
id— identificador estable del eventotype— tipo de evento exactooccurred_at— cuándo ocurrió la actividaddata— información específica del 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?"
}
}Del evento al resultado empresarial
Permita que la comunicación móvil desencadene la siguiente acción empresarial.
Conversaciones CRM
Añada un mensaje SMS o WhatsApp recibido al contacto correcto y notifique al responsable asignado.
Recuperación de llamadas perdidas
Cree una tarea de devolución de llamada, envíe un SMS de seguimiento o notifique a un equipo de guardia tras una llamada perdida.
Soporte al cliente
Abre o actualiza un ticket de soporte cuando un cliente responde desde su móvil.
Operaciones de comercio electrónico
Actualiza los flujos de comunicación de pedidos después de que se envíe, confirme o falle un mensaje móvil.
Monitorización y alertas
Envía fallos de entrega o actividad de llamadas inusual a tus herramientas de observabilidad y de gestión de incidentes.
Flujos de trabajo de IA y datos
Alimenta eventos autorizados en flujos de clasificación, informes o asistencia sin consultar repetidamente el API.
Deja de sondear en busca de cambios
El sondeo realiza solicitudes repetidas. Los webhooks notifican a tu software cuando hay un cambio.
El sondeo consume solicitudes incluso cuando no ocurre nada y añade retraso entre comprobaciones. Webhook V2 envía el evento relevante a tu endpoint, haciendo la automatización más rápida, más simple y más escalable.
¿Algún evento nuevo?Solicitudes repetidas · retraso adicional
Evento
Notifícame cuando ocurra.Evento relevante · flujo de trabajo inmediatoPreguntas frecuentes sobre Webhook V2
Preguntas antes de conectar tu endpoint.
¿Necesito implementar un bucle de sondeo?＋
No. Webhook V2 envía los eventos suscritos a tu endpoint público HTTPS. Aún puedes usar las API cuando necesites consultar el historial o detalles.
¿Puedo configurar varias URLs de webhook?＋
Sí. Puedes crear múltiples destinos y seleccionar un conjunto distinto de eventos para cada uno, dentro de los límites de la cuenta mostrados en el panel.
¿Cómo sé que se envió realmente un SMS?＋
Usa sms.api.submitted para saber que se creó el trabajo y sms.sent para la confirmación reportada por el móvil conectado. Trátalos como dos etapas operativas distintas.
¿Puede entregarse un webhook más de una vez?＋
Sí. Webhook V2 usa entrega al menos una vez (at-least-once). Guarda el ID de evento estable o el Idempotency-Key y omite cualquier entrega que ya hayas procesado.
¿Qué debe devolver mi endpoint?＋
Devuelve una respuesta 2xx HTTP después de aceptar el evento de forma segura. El procesamiento puede continuar de forma asíncrona dentro de tu aplicación.
¿Se recopilan continuamente los eventos WhatsApp recibidos?＋
No. La recuperación de mensajes recibidos de WhatsApp sigue su propio proceso de sincronización basado en el consentimiento. El evento whatsapp.received está disponible después de que se haya recuperado un mensaje elegible.
Tus eventos móviles. Tu software. Tus acciones.
Conecta tu software a la actividad de tu móvil real ahora.
Crea tu cuenta o inicia sesión, abre Webhook V2, añade un destino público HTTPS y elige los eventos que importan a tu flujo de trabajo. Envía un evento de prueba, verifica su firma y activa tu integración.
