Compartir:
){kind=small}
Antiguo educador de desarrolladores @Vonage. Procedente de PHP, pero no limitado a un solo lenguaje. Un ávido jugador y un entusiasta de Raspberry pi. A menudo se le encuentra practicando escalada en rocódromo.
Guía técnica para la desaparición de la API de US Short Codes
Tiempo de lectura: 7 minutos
En el sector se están produciendo cambios en la mensajería de aplicación a persona (A2P). Vonage está eliminando la API de US Short Codes compartidos debido al nuevo código de conducta de T-Mobile y AT&T que sondea al usuario de originadores compartidos de tráfico A2P. Esta eliminación se produce junto con el nuevo código de conducta A2P 10DLC que ofrece más flexibilidad para los códigos largos y limita el uso de códigos cortos por parte de las empresas.
Por consiguiente, los operadores estadounidenses ya no admitirán el tráfico de códigos cortos compartidos (SSC). Tenga en cuenta que esto no afecta a los códigos cortos dedicados.
Los clientes que usan la API de código corto compartido de EE. UU. de Vonage deberán migrar a una de las otras API disponibles. Si estás usando la API de código corto compartido de EE. UU. para comunicaciones por SMS, deberás realizar ajustes en tu código y configuraciones para usar la SMS API. Además, si la está utilizando para la autenticación de dos factores, tendrá que realizar ajustes en su código para utilizar la SMS API o la Verify API.
Si no deseas utilizar los SDK admitidos por Vonage, las API están disponibles. Para obtener más información sobre estas API, consulta la Referencia de SMS API y la Referencia de Verify API.
Vonage cuenta con bibliotecas para admitir varios idiomas, que puedes encontrar en el Descripción general de SMS del panel para desarrolladores. Sin embargo, para esta página, mostraremos algunos ejemplos usando Node.js.
El SDK puede instalarse con el siguiente comando:
El siguiente fragmento de código es un ejemplo de cómo enviar un SMS a un número de teléfono predeterminado:
const Vonage = require('@vonage/server-sdk')
const vonage = new Vonage({
apiKey: VONAGE_API_KEY,
apiSecret: VONAGE_API_SECRET
})
const from = VONAGE_BRAND_NAME
const to = TO_NUMBER
const text = 'A text message sent using the Vonage SMS API'
vonage.message.sendSms(from, to, text, (err, responseData) => {
if (err) {
console.log(err);
} else {
if(responseData.messages[0]['status'] === "0") {
console.log("Message sent successfully.");
} else {
console.log(`Message failed with error: ${responseData.messages[0]['error-text']}`);
}
}
})
Recibir un SMS requiere que tu proyecto tenga un webhook de acceso público. Para fines de desarrollo, nuestra recomendación es utilizar ngrok, que tenemos un tutorial sobre cómo utilizarlo con nuestros servicios aquí.
En primer lugar, el proyecto requiere dos librerías de terceros express y body-parser que puedes instalar ejecutando lo siguiente:
El siguiente fragmento de código muestra un ejemplo de cómo gestionar la recepción de un SMS entrante con el webhook: /webhooks/inbound-sms
const app = require('express')()
const bodyParser = require('body-parser')
app.use(bodyParser.json())
app.use(bodyParser.urlencoded({ extended: true }))
app
.route('/webhooks/inbound-sms')
.get(handleInboundSms)
.post(handleInboundSms)
function handleInboundSms(request, response) {
const params = Object.assign(request.query, request.body)
console.log(params)
response.status(204).send()
}
app.listen(process.env.PORT || 3000)La SMS API no permite que los usuarios se den de alta o de baja en las comunicaciones. Este cambio significa que los desarrolladores tendrán que gestionar esta funcionalidad por su cuenta ajustando el ejemplo anterior y estableciendo un método para almacenar las preferencias de contacto de los usuarios, por ejemplo en una base de datos.
Con la eliminación de los US Short Codes compartidos, los clientes tendrán que comprar un nuevo número para enviar y recibir mensajes SMS. Puede comprar Numbers en el Panel de control para desarrolladores. Asegúrese de elegir un número con capacidad para enviar SMS.
Puede encontrar las opciones de migración con las directrices de nuestros expertos en la materia.
US Short Codes API tiene una funcionalidad en el panel de control para registrar plantillas para utilizar diferentes tipos de alerta, como alertas, marketing o autenticación de 2 factores. Esta función ya no está disponible, por lo que deberá crear estas plantillas en su proyecto.
Para más información sobre el uso de la SMS API, puede encontrar toda la información necesaria en el Panel del desarrollador.
Si desea obtener información sobre los precios de la SMS API, consulte la página Página de precios.
Vonage tiene bibliotecas compatibles con varios lenguajes, que puedes ver en la descripción general de Developer Docs Verify. Sin embargo, para esta página, mostraremos algunos ejemplos usando Node.js.
En primer lugar, el proyecto requiere el SDK de Vonage Node @vonage/server-sdkque puedes instalar ejecutando lo siguiente:
El siguiente fragmento de código muestra un ejemplo de cómo solicitar la verificación de un usuario, asegurándose de sustituir lo siguiente:
tu clave API de Vonage
tu secreto de API de Vonage
el número de destinatario
y su Marca / Su Número
const Vonage = require('@vonage/server-sdk');
const vonage = new Vonage({
apiKey: VONAGE_API_KEY,
apiSecret: VONAGE_API_SECRET
});
vonage.verify.request({
number: RECIPIENT_NUMBER,
brand: BRAND_NAME
}, (err, result) => {
if (err) {
console.error(err);
} else {
const verifyRequestId = result.request_id;
console.log('request_id', verifyRequestId);
}
});
El código a continuación también requiere la instanciación de Vonage en el ejemplo que se encuentra en el paso anterior. Pero para comprobar el código de verificación introducido por el usuario, el siguiente fragmento de código muestra esta funcionalidad.
Asegúrese de actualizar los REQUEST_ID y CODE con valores válidos.
vonage.verify.check({
request_id: REQUEST_ID,
code: CODE
}, (err, result) => {
if (err) {
console.error(err);
} else {
console.log(result);
}
});
Tenga en cuenta que Verify API ofrece por defecto la posibilidad de gestionar una lista de no permitidos. Esta capacidad significa que hay una función integrada para responder automáticamente a los usuarios finales que responden con STOP y marcar a esos usuarios finales para que no reciban más mensajes.
Si eras cliente de Vonage y usabas tu plantilla 2FA con la API de USSC, es posible que puedas personalizar una plantilla con Verify API. Revisa nuestra documentación de Verify para comprender los requisitos de la plantilla.
US Short Codes API tiene una funcionalidad en el panel de control para registrar plantillas para utilizar diferentes tipos de alerta, como alertas, marketing o autenticación de 2 factores. Esta función ya no está disponible, por lo que deberá crear estas plantillas en su proyecto.
Para más información sobre el uso de Verify API, puede encontrar toda la información necesaria en el Panel del desarrollador.
Si desea obtener información sobre los precios de Verify API, consulte la página Página de precios.