Documentación de la API REST
APIs REST de SMS y MMS
Envíe mensajes aprobados de la aplicación y gestione la aceptación, los eventos de entrega, la segmentación y los cargos.
Elija juntos la API y la credencial
Las cuentas aprobadas de Desarrolladores y Automatización, Empresa y Proveedores de comunicaciones pueden integrar los servicios habilitados. Un desarrollador individual no necesita fingir que es una empresa. Los SMS/MMS de aplicación requieren la aprobación de envío y el registro aplicables. El servicio Particulares y familias no dispone de ninguna API accesible al cliente para iniciar el envío de mensajes.
| Familia de API | URL base | Autenticación y resultado |
|---|---|---|
| Communications v3 | https://api.multitel.net/v3 | Credenciales Basic aprobadas; tokens provisionados admisibles solo para las operaciones que los admitan. JSON con status y response. |
| Registro del servicio de llamadas de emergencia | https://api.multi.tel/emergency | Credenciales Basic aprobadas o acceso bearer provisionado específicamente. JSON con code, message y data. |
| Integraciones REST del portal | Host y operación indicados en la referencia para desarrolladores de su cuenta | Utilice la credencial, los ámbitos y el esquema documentados para esa operación. Las solicitudes de sesión del navegador utilizan una interfaz aparte. |
Configure MULTITEL_API_USERNAME y MULTITEL_API_PASSWORD mediante la configuración de secretos de su servidor antes de utilizar los ejemplos. No los incluya nunca en código JavaScript público del navegador, en URL ni en el control de versiones. Las credenciales dedicadas se gestionan en los ajustes de integración de API.
Preparar una solicitud de SMS
Utilice un número de envío habilitado para SMS, aprobado y propiedad de la cuenta, y un destinatario que haya aceptado recibir el mensaje. Complete el registro de marca y campaña (Brand/Campaign) o la verificación del número gratuito para quien llama, según corresponda. El siguiente ejemplo envía un mensaje real cuando se completa con credenciales y números válidos; no es un entorno de pruebas.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
--request POST \
--header "Content-Type: application/json" \
--data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
"https://api.multitel.net/v3/sendsms"Sustituya los marcadores de remitente y destinatario por números telefónicos en formato internacional, solo con dígitos e incluido el código de país. Para un MMS, indique en media la URL multimedia compatible y de acceso público, y compruebe antes la admisibilidad y los precios de MMS.
La aceptación no es la entrega
Compruebe tanto el estado de aplicación exterior como el resultado de mensajería devuelto. Registre el identificador de mensaje proporcionado por el servicio y siga el estado de entrega y los eventos de webhook. Un envío aceptado correctamente no demuestra que el terminal del destinatario haya recibido el mensaje.
La facturación de SMS se realiza por segmento. La codificación y la longitud del mensaje pueden producir varios segmentos; los cargos por contenido multimedia y los cargos relacionados con el operador pueden diferir de los de SMS. Consulte el precio de venta vigente de la cuenta antes de enviar. No reintente nunca a ciegas un envío con tiempo de espera agotado: compruebe primero su resultado registrado.
Gestión de errores y reintentos
- Fallo de autenticación o de permiso
- Compruebe el estado habilitado de la credencial de API, el servicio permitido y la restricción de IP de origen. Una cookie de sesión del portal no es una credencial de integración.
- Crédito insuficiente o aprobación pendiente
- Resuelva el saldo de la cuenta, la aprobación de envío o el requisito de documentación antes de repetir la operación.
- Sin resultado
- Trate el inventario vacío o la falta de nombre del llamante como un resultado normal. No suponga que un número sintácticamente válido dispone de todos los servicios.
- Tiempo de espera de red o fallo del servicio
- Utilice reintentos limitados con espera progresiva para las lecturas. Para una compra, un envío o un registro, compruebe primero el estado de la operación; reintentar una solicitud aceptada puede duplicar una acción facturable.
La compatibilidad con la idempotencia pertenece a cada familia de API. La API de emergencias admite claves de reintento; esto no hace que las solicitudes arbitrarias de la v3 sean idempotentes. Conserve las marcas de tiempo, los identificadores devueltos y las respuestas expurgadas para el soporte.
Continúe con la referencia de su cuenta
La referencia disponible tras iniciar sesión filtra las operaciones según sus permisos y servicios habilitados. Utilice el host exacto, el tipo de credencial, los campos de solicitud y el esquema de respuesta indicados. Las consolas pueden ejecutar operaciones reales, incluidas compras y envíos de mensajes.