Compartir:
){kind=small}
Max es un gestor de comunidades con más de una década de experiencia en la creación y ampliación de programas comunitarios en todo el mundo. Le apasiona conectar a la gente, crear espacios para compartir ideas y asegurarse de que las voces de la comunidad den forma al futuro de los productos que utilizan. Originario de Londres, ahora vive en Carolina del Norte con su mujer, sus dos hijas y su golden retriever, Sadie.
Enviar verificaciones RCS con el agente predeterminado de Vonage Verify RCS
Tiempo de lectura: 7 minutos
Vonage Verify El agente predeterminado de RCS (Servicios de Comunicación Enriquecida) es un agente RCS pre-registrado y gestionado de forma centralizada que cualquier cliente de la Verify API puede utilizar para empezar a enviar mensajes RCS al instante sin necesidad de pasar por el proceso tradicional de registro de agentes, que suele llevar mucho tiempo.
En esta entrada, aprenderás a utilizar el agente predeterminado de Vonage Verify RCS para empezar a enviar mensajes de autenticación RCS fiables el mismo día en que realices la integración.
Si tu empresa quiere incorporar RCS a sus flujos de autenticación pero no quiere esperar semanas a que el operador dé su aprobación, o si ya utilizas Vonage Verify para SMS o WhatsApp y quieres añadir un canal de mensajería enriquecida con el mínimo esfuerzo, esta publicación es para ti. Lo mismo ocurre si actualmente solo utilizas SMS y quieres empezar a probar RCS como canal adicional.
Si ya has intentado dar tus primeros pasos con RCS y te has topado con dificultades en el proceso de registro, no te rindas todavía. Sigue leyendo para saber más sobre el agente predeterminado de RCS de Vonage Verify.
Una integración con la API de Verify V2 en uno o varios de los países compatibles.
Nota: Para utilizar el agente predeterminado de RCS de Vonage Verify, omite el parámetro «from» en tus solicitudes a la Verify API. Puedes empezar a enviar mensajes de verificación RCS de inmediato, mientras se lleva a cabo en paralelo el registro de tu agente con tu marca.
Si ya estás integrado con la API de Vonage Verify v2, puedes empezar a enviar mensajes RCS a través del agente predeterminado con un único cambio: omite el from campo, ya que Vonage redirige automáticamente el mensaje a través del agente predeterminado y no se necesita ningún ID de agente.
curl -X POST "https://api.nexmo.com/v2/verify" \
-H "Authorization: Bearer $JWT" \
-H 'Content-Type: application/json' \
-d $'{
"brand": "TestVerify",
"code_length": 5,
"channel_timeout": 30,
"workflow": [
{
"channel": "rcs",
"to": "+447700900000"
}
]
}'JWT (JSON Web Token): puedes generar un nuevo JWT utilizando el generador de JWT en línea o la herramienta CLI de Vonage.
marca: el nombre de tu empresa tal y como quieres que aparezca en el cuerpo del mensaje.
canal: debe ser «rcs» para que el tráfico se redirija a través del agente predeterminado de RCS.
a - Número de teléfono del usuario final en formato E.164.
Abra su Página de configuración de API para acceder a tu clave y secreto de API de Vonage, que aparecen como se muestra en la captura de pantalla a continuación. La clave de API se encuentra en la parte superior de la página, y para acceder a tu secreto de API, consulta la subsección "Secreto de Account".
Nota: En caso de que no recuerde su secreto de API creado anteriormente, haga clic en "+ Crear nuevo secreto" y guárdelo de forma segura.
Una respuesta 202 «Accepted» confirma que la solicitud de verificación se ha enviado. Una respuesta 200 OK confirma que el código coincide y que el usuario ha sido Verify. Comprueba el código utilizando el request_id exactamente igual que lo harías con cualquier otro canal de Verify, comprueba el código de verificación facilitado.
{
"request_id": "c11236f4-00bf-4b89-84ba-88b25df97315"
}Guarda el request_id, lo necesitarás para comprobar el código enviado por el usuario final.
Para obtener información detallada sobre los parámetros, consulta la Referencia de la API de Verify V2.
Una vez que el usuario final reciba el código OTP, debes enviar una solicitud POST al /v2/verify/{request_id} punto final. Sustituye el {request_id} por el ID que recibiste en la llamada anterior:
curl -X POST "https://api.nexmo.com/v2/verify/$VERIFY_REQUEST_ID" \
-H "Authorization: Bearer $JWT"\
-H 'Content-Type: application/json' \
-d $'{
"code": "'$VERIFY_CODE'"
}'
Para las implementaciones en entorno de producción, recomendamos añadir un canal alternativo por si RCS no estuviera disponible en el dispositivo del destinatario. El flujo de trabajo que se muestra a continuación intenta primero utilizar RCS y, en su defecto, recurre a SMS. No se requiere ninguna configuración adicional, ya que Vonage se encarga de la selección del canal de forma automática. En la mayoría de los países, el mensaje lo envía el agente «Vonage Verify».
curl -X POST "https://api.nexmo.com/v2/verify" \
-H "Authorization: Bearer $JWT" \
-H 'Content-Type: application/json' \
-d $'{
"brand": "YOUR_BRAND",
"workflow": [
{
"channel": "rcs",
"to": "'$PHONE_NUMBER'"
},
{
"channel": "sms",
"to": "'$PHONE_NUMBER'"
}
]
}'
RCS ConversationRCS está integrado en la aplicación «Mensajes» predeterminada de Android y también está disponible en las últimas versiones de iOS. En las versiones compatibles de Android, Google Messages puede mostrar el código encima del teclado como una sugerencia de autocompletado con un solo toque, de modo que los usuarios puedan Verifylo con un solo toque sin tener que cambiar de aplicación.
Si utilizas el diseño de tarjeta enriquecida, el OTP aparece destacado en una tarjeta con estilo, e incluso puedes añadir un botón «Copiar código» con un solo toque, que es una sugerencia que aparece debajo del mensaje y permite a los usuarios copiar el código directamente al portapapeles, lo que reduce las dificultades y los errores de introducción de datos en los formularios de inicio de sesión.
El cuerpo del mensaje de marca es el valor que establezcas en la llamada a la API y que se muestra dentro del cuerpo del mensaje, de modo que los usuarios finales vean el nombre de tu empresa en contexto.
Característica | RCS (agente predeterminado) | SMS |
Identidad del remitente | Agente verificado de «Vonage Verify» | Código numérico corto/largo |
Formato del mensaje | Tarjeta con numerosas funciones y pantalla de OTP bien visible | Cadena de texto sin formato |
Copiar con un solo toque | Botón «Copiar código» | Copia del manual |
Sugerencia de autocompletado | En dispositivos compatibles | En los dispositivos compatibles |
Resistencia al phishing | Remitente verificado por el operador | Más fácil de falsificar |
P: ¿Puede cualquier cliente de Verify V2 utilizar esta función?
R: Sí, todos los clientes de Verify API en países compatibles pueden utilizar el agente predeterminado sin necesidad de realizar ningún paso adicional de activación.
P: ¿Verá el usuario final «Vonage Verify» en lugar de la marca del cliente?
R: Sí, aparecerán mensajes del agente «Vonage Verify». Este es el comportamiento previsto para el agente predeterminado. Si deseas que aparezca el nombre de tu propia marca como remitente, registra un agente personalizado. La aprobación de tu agente con marca propia puede llevarse a cabo en paralelo mientras utilizas el agente predeterminado. Aun así, puedes utilizar el parámetro «brand» para incluir el nombre de tu marca en el cuerpo del mensaje RCS.
P: ¿Hay algún límite de volumen?
R: No hay límites de volumen específicos asociados al uso del agente predeterminado. Se aplican los límites de uso estándar de la Verify API de Vonage Verify y las políticas de uso razonable. La facturación de los mensajes RCS enviados a través del agente predeterminado es idéntica a la tarifa estándar de RCS de Vonage Verify. No se aplica ningún recargo ni suplemento por utilizar el agente predeterminado. Todo el uso se atribuye a la clave de API individual del cliente, por lo que no existe riesgo de facturación compartida. La facturación es la misma independientemente de si el cliente utiliza el agente predeterminado o su propio ID de agente registrado.
P: ¿Qué ocurre con los países que no figuran en la lista aprobada?
R: En el caso de los países que aún no están incluidos, los clientes deben iniciar por su cuenta el registro del agente RCS. El equipo de Verify amplía continuamente la cobertura del agente predeterminado. Comprueba si el país de destino está incluido.
El agente predeterminado de Vonage Verify RCS te permite empezar a utilizar RCS el mismo día, y puedes pasar a utilizar tu propio agente con tu marca en cualquier momento. No es necesario presentar documentación sobre la marca ni detalles sobre los casos de uso, ni pasar por procesos de aprobación de los operadores que varían de un país a otro, ni evitar las idas y venidas con los agregadores antes de poder enviar un mensaje.
Cómo utilizar el agente predeterminado de Vonage Verify RCS
¿Tiene alguna pregunta o quiere compartir lo que está construyendo?
Suscríbase al Boletín para desarrolladores
Síguenos en X (antes Twitter) para estar al día
Ver tutoriales en nuestro canal de YouTube
Conéctese con nosotros en la página Vonage Developer en LinkedIn
Ayúdanos a mejorar nuestra experiencia como desarrolladores rellenando nuestro cuestionario «La voz del desarrollador»
Mantente conectado y entérate de las últimas noticias, consejos y eventos para desarrolladores.
Compartir:
Max es un gestor de comunidades con más de una década de experiencia en la creación y ampliación de programas comunitarios en todo el mundo. Le apasiona conectar a la gente, crear espacios para compartir ideas y asegurarse de que las voces de la comunidad den forma al futuro de los productos que utilizan. Originario de Londres, ahora vive en Carolina del Norte con su mujer, sus dos hijas y su golden retriever, Sadie.