Tenga en cuenta que necesitará la ayuda de nuestro equipo para iniciar sus campañas de SMS incluso después de la integración de la API. Por lo tanto, le solicito que póngase en contacto después de la integración.
Introducción
Message Now es una API de mensajería versátil diseñada para facilitar el envío de mensajes por SMS y RCS.
Ayuda y soporte
Para obtener asistencia sobre la implementación y cualquier comentario, póngase en contacto con nosotros en: support@messagecentral.com
Parámetro de API para Message Now
RCS/SAUTH
Modos de envío de mensajes
Message Central ofrece dos modos principales para enviar mensajes a través de la API Message Now:
Enviar un mensaje a un solo número
Para enviar un mensaje a un solo número, rellena los siguientes campos de la API:
Número de teléfono móvil: el número de teléfono móvil del destinatario.
Mensaje: el contenido de texto del mensaje que se va a enviar.
Enviar un mensaje a varios números
Hay dos métodos para enviar mensajes a varios números:
a. Uso de la carga de archivos multiparte
Carga de archivos: utilice el parámetro API (archivo) para cargar un archivo de varias partes.
Mensaje: utilice el parámetro API (mensaje) para el texto que se va a enviar.
Formato de archivo: solo se admiten archivos.xlsx.
Personalización: este método admite mensajes personalizados por usuario, lo que permite un contenido de mensaje diferente para cada destinatario incluido en el archivo.
b. Uso del campo API para varios números
PhoneNumbers: utilice el parámetro de API (phoneNumbers) para especificar la lista de números de destinatarios. (formato: país <space>móvil: por ejemplo, 91 9816111111, 91 7715131105,...)
Mensaje: utilice el parámetro API (mensaje) para el texto que se va a enviar.
Formato de archivo: solo se admiten archivos.xlsx.
Personalización: este método admite mensajes personalizados por usuario, lo que permite un contenido de mensaje diferente para cada destinatario incluido en el archivo.
Diferencia entre la carga de archivos multiparte y el campo de números de teléfono:
Carga de archivos multiparte (.xlsx): permite enviar mensajes personalizados por usuario. Cada destinatario puede recibir un mensaje único, tal y como se especifica en el archivo.xlsx cargado.
Campo PhoneNumbers: envía el mismo texto a todos los destinatarios. El mensaje especificado en el campo de mensajes se entregará de manera uniforme a todos los que aparezcan en el campo Números de teléfono.
A continuación encontrará el formato de archivo de muestra en formato XLXS:
Donde 'var1', 'var2' y 'var3' son marcadores de posición para las variables.
Si una empresa desea enviar un mensaje personalizado mediante la carga de archivos, el campo del mensaje debe tener el siguiente formato:
Ejemplo de mensaje - «Hola # #var ##, tu saldo es # #var2 ## en la fecha # #var3 ##
Aproveche la oportunidad
Si es un desarrollador o una agencia de desarrollo web, asóciese con nosotros para acelerar sus ganancias.
Conviértase en socio
Enviar SMS
RCS/SAUTH
Para enviar un SMS a un número de teléfono móvil, se requieren los siguientes parámetros de solicitud. Es necesario un token de autenticación, generado por la API de generación de tokens, para enviar el SMS.
https://cpaas.messagecentral.comAl usar la API de verificación por SMS de Verify Now para enviar códigos de verificación por SMS, la llamada inicial debe ser a la API de generación de tokens.
Esta API devuelve un token que debe incluirse en todas las llamadas posteriores. Se necesita un token de autenticación para validar al usuario y debe incluirse en la sección de encabezado de cada solicitud.
Ruta URL de solicitud:
Una respuesta correcta devolverá un código de estado 200.
/verification/v3/sendParámetros de solicitud:
Una respuesta correcta devolverá un código de estado 200.
NOTA: El ID de plantilla y el ID de entidad son obligatorios si la plantilla no está registrada en Message Central. Además, tanto TemplateID como EntityID deben estar presentes o ambos deben estar ausentes.
cURL
1curl --location --request POST 'https://cpaas.messagecentral.com/verification/v3/send?countryCode=91&flowT ype=SMS&mobileNumber=9999999999&senderId=UTOMOB&type=SMS&message=%3CYour%20 Message%20Template%3E&messageType=PROMOTIONAL' \--header 'authToken: eyJhbGciOiJIUzUxMiJ9.thisisatesttoken.IgGu7Sb4lovBSql5LIXZU3jlwPG4giAMZ2kTI Mg_EAaKVsVcCdpW_TYzyzdTd94GdEJMt5WntEGcEX4w0hITng'
NOTA: Para convertir un comando cURL en código con Postman, abre Postman, importa el comando cURL mediante el botón «Importar» y, a continuación, genera el código en tu idioma preferido haciendo clic en el botón «Código» situado a la derecha de la solicitud.
Respuesta JSON
Una respuesta correcta devolverá un código de estado 200.
1{
2 "responseCode": 200,
3 "message": "SUCCESS",
4 "data": {
5 "verificationId": "1234",
6 "mobileNumber": "9999999999",
7 "responseCode": "200",
8 "errorMessage": null,
9 "timeout": "30.0",
10 "smsCLI": null,
11 "transactionId": "1c9c56ec-5cd3-48b5-9e32-a15499fb77a2"
12 }
13}Códigos de ejemplo
curl --location 'https://cpaas.messagecentral.com/verification/v3/send?countryCode=91&flowType=SMS&mobileNumber=9999999999&senderId=UTOMOB&type=SMS&message=%3CYour%20Message%20Template%3E&messageType=PROMOTIONAL' \
--header 'authToken: eyJhbGciOiJIUzUxMiJ9.thisisatesttoken.IgGu7Sb4lovBSql5LIXZU3jlwPG4giAMZ2kTIMg_EAaKVsVcCdpW_TYzyzdTd94GdEJMt5WntEGcEX4w0hITng' \
--form 'file=@"/C:/Users/Kunal Suryawanshi/Downloads/Sample_MessageNow.xlsx"'OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
.url("https://cpaas.messagecentral.com/auth/v1/authentication/token?customerId=<CustomerId>&key=<Base64 Encrypted password>&scope=NEW&country=91&email=test@messagecentral.com")
.method("GET", body)
.addHeader("accept", "*/*")
.build();
Response response = client.newCall(request).execute();var request = require('request');
var options = {
'method': 'GET',
'url': 'https://cpaas.messagecentral.com/auth/v1/authentication/token?customerId=<CustomerId>&key=<Base64 Encrypted password>&scope=NEW&country=91&email=test@messagecentral.com',
'headers': {
'accept': '*/*'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://cpaas.messagecentral.com/auth/v1/authentication/token?customerId=<CustomerId>&key=<Base64 Encrypted password>&scope=NEW&country=91&email=test@messagecentral.com');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'accept' => '*/*'
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}import requests
url = "https://cpaas.messagecentral.com/auth/v1/authentication/token?customerId=<CustomerId>&key=<Base64 Encrypted password>&scope=NEW&country=91&email=test@messagecentral.com"
payload = {}
headers = {
'accept': '*/*'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "net/http"
url = URI("https://cpaas.messagecentral.com/auth/v1/authentication/token?customerId=<CustomerId>&key=<Base64 Encrypted password>&scope=NEW&country=91&email=test@messagecentral.com")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
request["accept"] = "*/*"
response = https.request(request)
puts response.read_body
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://cpaas.messagecentral.com/auth/v1/authentication/token?customerId=<CustomerId>&key=<Base64 Encrypted password>&scope=NEW&country=91&email=test@messagecentral.com");
request.Headers.Add("accept", "*/*");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());Integración de devolución de llamadas por SMS con Message Central
Para recibir llamadas por SMS y mantenerlas en su propio sistema para recibir actualizaciones de estado de todos los mensajes enviados a través de nuestro servicio, siga estos pasos:
1. Información requerida:
a. ID de cliente
b. Nombre de la marca
c. ID de correo electrónico registrado
d. URL de devolución de llamada
2. Instrucciones de envío: Envíe la información anterior a operations@messagecentral.com con el asunto «Integración de devolución de llamadas por SMS con Message Central».
3. Especificaciones de la URL de devolución de llamada: Asegúrese de que la URL de devolución de llamada sea accesible y capaz de recibir solicitudes HTTP POST que contengan cargas útiles JSON con actualizaciones de estado de los mensajes SMS enviados. Al activarse, el punto final recibirá la siguiente carga útil de JSON.
1{
2"apiKey": null,
3"clientId": null,
4"messageId": "a2e87214-d18c-4a2e-b7f4-802c4465a9b9",
5"status": "DELIVRD",
6"errorCode": 0,
7"countryCode": null,
8"mobile": "919999999999",
9"submitDate": "2023-11-02 13:59:18",
10"doneDate": "2023-11-02 13:59:22"
11}
4. Estado estándar: Estos son los siguientes estados que recibirá para todos los mensajes enviados.
a. ENTREGADO
b. CADUCADO
c. UNDELIV
d. DESCONOCIDO
e. RECHAZADO
Para obtener más ayuda o aclaraciones, póngase en contacto con nuestro equipo de soporte en: -support@messagecentral.com
¿Cómo autentico las solicitudes en la API de SMS?
Las solicitudes de API de SMS se autentican mediante Credenciales de API, normalmente un token o clave de API que se pasa en el encabezado o los parámetros de la solicitud. La autenticación garantiza que solo las aplicaciones autorizadas puedan enviar mensajes SMS y acceder a los informes de entrega. Las credenciales se generan en el panel de control y deben mantenerse seguras.
¿Qué formato de solicitud utiliza la API de SMS?
La mayoría API de SMS usa un Formato de solicitud basado en REST a través de HTTPS. Las solicitudes suelen enviarse como llamadas HTTP POST con parámetros formateados en formato JSON o codificados en URL. Esto hace que estas API de SMS masivos fácil de integrar con aplicaciones web y móviles.
¿Qué parámetros se requieren para enviar un SMS mediante la API?
Para enviar un SMS mediante una API o Puerta de enlace SMS, los parámetros requeridos suelen incluir número de teléfono del destinatario, contenido del mensaje, ID del remitente, y credenciales de autenticación. Algunas API también requieren un tipo de mensaje, como SMS transaccional o SMS promocionales.
¿Cómo envío una OTP mediante la API de SMS?
Puedes enviar una OTP usar la API de SMS pasando el número del destinatario, el contenido del mensaje OTP y el tipo de mensaje como parámetros en una solicitud de API. La API genera un identificador de mensaje, lo que permite a las aplicaciones rastrear la entrega y verificar la OTP durante autenticación de usuario.
¿Cómo envío SMS masivos con la API de SMS?
SMS masivos se puede enviar mediante una API de SMS enviando números de destinatarios múltiples en una sola solicitud o cargando una carga útil por lotes. La API procesa los mensajes de forma asincrónica y proporciona informes de entrega para cada destinatario.
¿Cómo compruebo el estado de entrega de los SMS mediante la API?
El estado de entrega de los SMS se puede comprobar mediante el ID de mensaje devuelto por la API. Las aplicaciones pueden consultar el punto final de un informe de entrega o recibir actualizaciones de entrega mediante llamadas o webhooks configurados durante la integración de la API.
¿La API de SMS admite webhooks o callbacks?
Sí. La mayoría de las API de SMS son compatibles webhooks o callbacks que notifican a la aplicación cuando un mensaje se entrega, falla o caduca. Las devoluciones de llamadas permiten el seguimiento de las entregas en tiempo real sin tener que consultar la API repetidamente.
¿Qué estados de entrega devuelve la API de SMS?
Una API de SMS normalmente devuelve estados de entrega como en cola, enviado, entregado, suspendió, o caducado. Estos estados ayudan a las aplicaciones a supervisar el progreso de los mensajes y a tomar medidas cuando se producen problemas de entrega.
¿Qué códigos de error devuelve la API de SMS?
Las API de SMS vuelven estandarizadas códigos de error por problemas como errores de autenticación, números no válidos, saldo insuficiente o rutas bloqueadas. Cada código de error va acompañado de una descripción para ayudar a los desarrolladores a depurar y gestionar los errores mediante programación.
¿La API de SMS tiene una tarifa limitada?
Sí. Las API de SMS suelen aplicarse límites de tarifas para evitar el abuso y garantizar la estabilidad del sistema. Los límites de frecuencia definen el número de solicitudes que puede realizar una aplicación en un período de tiempo determinado y pueden variar según el tipo de cuenta o el nivel de uso.
.png){kind=small}
