Enviar un mensaje de acción sugerida RCS (Abrir una URL en una vista web)

En este fragmento de código aprenderá a enviar un mensaje RCS Suggested Action utilizando el comando text del canal RCS de la Messages API. Este mensaje pedirá al destinatario que abra una URL en una vista web en el navegador predeterminado de su dispositivo o en la aplicación registrada.

Para más información sobre RCS Messaging Comprender la mensajería RCS
Para obtener una guía detallada sobre las fichas de sugerencias, consulte Sugerencias RCS Chips

Ejemplo

A continuación encontrará la descripción de todas las variables utilizadas en cada fragmento de código:

Clave	Descripción
`VONAGE_APPLICATION_ID`	The Vonage Application ID.
`VONAGE_PRIVATE_KEY_PATH`	Private key path.
`MESSAGES_API_URL`	There are two versions of the API, each with their own endpoints. For production the previous Messages API endpoint was `https://api.nexmo.com/v0.1/messages`, the new one is `https://api.nexmo.com/v1/messages`. For sandbox testing the Messages API endpoint is `https://messages-sandbox.nexmo.com/v0.1/messages` or `https://messages-sandbox.nexmo.com/v1/messages`, depending on which version you have set in the sandbox dashboard.
`JWT`	Used to authenticate your request. See Authentication for more information, including how to generate a JWT.
`TO_NUMBER`	The number you are sending the RCS message to in E.164 format. For example `447700900000`.
`RCS_SENDER_ID`	The sender ID for the RCS message.

NOTA: No utilice un + o 00 cuando introduzca un número de teléfono, empiece por el prefijo del país, por ejemplo 447700900000.

Requisitos previos

Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.

Escriba el código

Añada lo siguiente a send-suggested-action-open-url-webview.sh:

curl -X POST "${MESSAGES_API_URL}" \
  -H "Authorization: Bearer "$JWT\
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d $'{
    "to": "'${MESSAGES_TO_NUMBER}'",
    "from": "'${RCS_SENDER_ID}'",
    "channel": "rcs",
    "message_type": "text",
    "text": "Check out our latest offers!",
    "suggestions": [
      {
        "type": "open_url_in_webview",
        "text": "Open product page",
        "postback_data": "postback_data_1234",
        "url": "http://example.com/",
        "description": "A URL for the Example website",
        "view_mode": "FULL"
      }
    ]
  }'

Ver fuente completa

Ejecute su código

Guarde este archivo en su máquina y ejecútelo:

bash send-suggested-action-open-url-webview.sh

Pruébalo

Al ejecutar el código, se envía un mensaje al número de destino.