Cómo utilizar el agente predeterminado de Vonage Verify RCS

Si ya estás enviando códigos OTP con la API de Vonage Verify, puedes empezar a enviar mensajes RCS al instante, sin necesidad de registrar a ningún agente ni de pasar primero por un proceso de aprobación por parte del operador. El Agente predeterminado de Vonage Verify RCS es un agente RCS preinscrito y gestionado de forma centralizada, operado por Vonage bajo el nombre de Vonage Verify. Cualquier cliente de Verify API que se encuentre en un país compatible puede utilizarla simplemente omitiendo el from campo en su solicitud actual de Verify V2.

Requisitos previos

• A Account de Vonage con un Aplicación de Vonage configurado (ID de la aplicación y clave privada, para Autenticación JWT).
• Un ya existente integración con la API de Verify V2.

Comprueba si tu país de destino está incluido entre los admitidos

En primer lugar, comprueba que tus usuarios finales se encuentren en uno de los países en los que está disponible el agente predeterminado. En directo:

Incorpora RCS a tu flujo de trabajo de Verify

En tu solicitud actual de Verify V2, añade "channel": "rcs" a la matriz de flujos de trabajo. Omite el from campo ya que Vonage desvía automáticamente el mensaje a través del agente predeterminado. No es necesario indicar 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": "YOUR_BRAND",
        "workflow": [
        {
            "channel": "rcs",
            "to": "'$PHONE_NUMBER'"
        },
        {
            "channel": "sms",
            "to": "'$PHONE_NUMBER'"
        }
    ]
}'

Gestionar la respuesta

Una solicitud que se ha realizado correctamente devuelve un request_id:

{
  "request_id": "REQUEST_ID"
}

Una vez que el usuario final haya introducido la contraseña de un solo uso (OTP), comprueba el código utilizando el request_id exactamente igual que con cualquier otro canal de Verify; consulta Comprobar el código de verificación suministrado.

Experiencia del usuario final con RCS

Cuando se envía un mensaje de verificación a través del agente predeterminado, los usuarios finales que utilicen dispositivos Android compatibles reciben un mensaje RCS enriquecido con las siguientes características:

• Insignia de remitente verificado — el mensaje llega tras haber sido verificado por el operador Vonage Verify agente (VonageVFY en Singapur), lo que aumenta la confianza de los usuarios.
• Diseño de tarjeta con gran cantidad de elementos — El OTP aparece destacado en una tarjeta con diseño específico, lo que facilita su lectura de un solo vistazo.
• Botón «Copiar código» con un solo toque — Una función de sugerencias permite a los usuarios copiar el código directamente al portapapeles, lo que reduce los errores de introducción de datos.
• Sugerencia automática de OTP — 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.
• Cuerpo del mensaje de marca — tu brand Este valor aparece en el cuerpo del mensaje, por lo que los usuarios ven el nombre de tu empresa en su contexto, aunque el nombre del agente sea Vonage Verify.
• No es necesario instalar ninguna aplicación — RCS está integrado en la aplicación «Mensajes» predeterminada de Android. El usuario no tiene que descargar nada ni realizar ningún paso adicional.

Comportamiento y limitaciones

• El nombre del remitente del agente RCS es siempre Vonage Verify (VonageVFY en Singapur) y no se puede personalizar cuando se utiliza el agente predeterminado. Sin embargo, el nombre de tu marca sí aparece en el cuerpo del mensaje a través de la brand parámetro: Your {brand} code is: {code}.
• Las exclusiones se aplican únicamente al usuario final concreto y a tu clave de API; no afectan a otros clientes que utilicen el mismo agente predeterminado.
• No es necesario realizar ninguna configuración adicional, añadir la API a la lista de permitidos ni llevar a cabo ningún paso de activación. Todos los clientes de la API de Verify de los países compatibles pueden utilizar el agente predeterminado de forma inmediata.
• Se aplican los límites de uso estándar de la API de Vonage Verify y las políticas de uso razonable.
• La facturación es idéntica a la de los precios estándar de Vonage Verify RCS. El uso se atribuye a tu clave API individual.

Registra tu propio agente RCS

El agente predeterminado es un punto de partida recomendado y sirve de puente mientras se configura tu agente personalizado. Puedes llevar a cabo el registro de tu propio agente en paralelo mientras utilizas el agente predeterminado, sin que ello afecte al tráfico existente. Para empezar, utiliza el RCS Agent Builder en el panel de control de la API de Vonage.

Véase también

• Referencia de la API Verify V2
• Flujo de trabajo de Verify
• Conceptos de canales RCS
• Integra RCS en tus procesos de autenticación
• Guía de RCS Agent Builder