Enviar SMS

Reenviar SMS no enviados

REGISTRO de SMS enviados

Recibir SMS

Eliminar SMS

SMS recibido - Webhook

Autenticación

Enviar SMS

Punto final: 

Parámetros:

Ejemplo:

Reenviar un SMS no enviado

 Este punto final de API se utiliza para reenviar un SMS no enviado (solo si el mensaje tiene un estado de error)

Punto final:

Parámetro: 

Ejemplo:

Registro de SMS enviados desde la API  

Este punto final de API se utiliza para recuperar el registro de mensajes SMS enviados a través de la API.

Punto final:  

Parámetro:

Ejemplo:

SMS recibido

Este punto final de API se utiliza para recuperar mensajes SMS recibidos en el teléfono inteligente. 

Punto final:

Parámetro: 

Ejemplo:

Eliminar SMS

Este punto final de API se utiliza para eliminar mensajes SMS del registro del servidor de SMS Mobile API

Punto final:  

Parámetro:

Ejemplo:

Nota: Los SMS eliminados son solo aquellos almacenados en los registros de su cuenta de la aplicación móvil. Los SMS del dispositivo móvil en sí no se eliminarán, ya que no tenemos acceso a ellos.

Webhook – SMS recibidos

Este sistema de webhook envía una solicitud POST a la URL configurada cada vez que se recibe un SMS. El sistema garantiza actualizaciones en tiempo real al enviar los detalles del SMS a la URL del webhook especificado.

Cómo configurar el webhook en el panel de control

Siga estos pasos para configurar la URL de su webhook en el panel de control:

1. Inicie sesión en su cuenta en Panel de control de API de SMS para dispositivos móviles.
2. Navegar hasta el Configuración de webhook sección.
3. Ingrese la URL de su webhook (por ejemplo, https://example.com/webhook-endpoint
4. Haga clic en el Guardar Webhook botón. 
5. Una vez guardado, el sistema comenzará a enviar detalles SMS a la URL configurada.

Carga útil del webhook

Cuando se recibe un SMS, el sistema envía la siguiente carga JSON a la URL de su webhook:

{

    "fecha": "2025-01-20",

    "hora": "10:15:00",

    "hora_recibida": "2025-01-20 10:14:50",

    "mensaje": "Hola, esto es una prueba.",

    "número": "+123456789",

    "guid": "abcde12345"

}

Campos de carga útil:

• fecha: Fecha en la que se agregó el SMS (AAAA-MM-DD).
• hora: Hora en que se añadió el SMS (HH:mm:ss).
• tiempo_recibido: Hora en que se recibió el SMS.
• mensaje: Contenido del SMS. 
• número: Número de teléfono del remitente.
• guía: Identificador único del SMS.

Ejemplo de punto final de webhook

Su servidor debería estar listo para manejar solicitudes POST entrantes. A continuación, se muestra un ejemplo de script PHP para procesar la carga útil del webhook:

<?php

// Leer la carga útil entrante

$payload = archivo_get_contents('php://entrada');

$data = json_decode($payload, verdadero);




// Procesar los datos del SMS

si ($data) {

    // Ejemplo: Registrar los datos de SMS en un archivo

    archivo_poner_contenido('sms_log.txt', print_r($data, verdadero), ARCHIVO_APPEND);




    // Responder con estado HTTP 200

    código_de_respuesta_http(200);

    echo "Webhook recibido exitosamente.";

} demás {

    // Responder con estado HTTP 400 para solicitudes incorrectas

    código_de_respuesta_http(400);


    echo "Carga útil no válida.";

}

?>

Probando el Webhook

Para probar la configuración de su webhook, utilice herramientas como:

• Sitio webhook
• SolicitudBin

Estas herramientas le permiten inspeccionar la carga útil enviada por el sistema y depurar cualquier problema con la configuración de su webhook.

Solución de problemas

• Asegúrese de que la URL del webhook sea correcta y de acceso público.
• Verifique que su servidor esté devolviendo un código de estado HTTP 200 para solicitudes exitosas.
• Revise los registros de su servidor para detectar cualquier error en el procesamiento de la carga útil.

Autenticación

La API de SMSMobile admite dos métodos de autenticación: utilizando una clave API simple o el protocolo OAuth2 con un ID de cliente y un secreto de cliente.

1. Autenticación de clave API

 Este método requiere una clave API que se puede incluir como parámetro en una solicitud GET o POST. Es una forma sencilla de autenticar sus solicitudes API.

2. Autenticación OAuth2

OAuth2 proporciona un método de autenticación más seguro y escalable.
Necesitará utilizar un ID de cliente y un secreto de cliente para obtener un token de acceso, que luego debe incluirse en sus solicitudes de API mediante el Autorización encabezamiento.

Obtención de un token de acceso

Para obtener un token de acceso, envíe una solicitud POST al punto final del token con su ID de cliente y su secreto de cliente.

Usando el token de acceso:

Una vez que tenga el token de acceso, inclúyalo en el Autorización encabezado de sus solicitudes de API:

¿Qué método deberías utilizar?

- Usar Autenticación de clave API para integraciones rápidas y sencillas.

- Usar Autenticación OAuth2 para una mayor seguridad y escalabilidad en sus integraciones.

Para obtener más detalles, consulte la documentación completa.