Enviar uma mensagem RCS com sugestão de ação (abrir uma URL em um Webview)

Neste trecho de código, você aprenderá a enviar uma mensagem de ação sugerida do RCS usando o text tipo de mensagem do canal RCS da Messages API. Essa mensagem solicitará que o destinatário abra uma URL em uma visualização da web no navegador padrão do dispositivo ou em um aplicativo registrado.

Exemplo

Veja a seguir a descrição de todas as variáveis utilizadas em cada trecho de código:

ChaveDescrição
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: Não use um espaço à esquerda + ou 00 Ao digitar um número de telefone, comece com o código do país, por exemplo 447700900000.

Pré-requisitos

Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.

Escreva o código

Adicione o seguinte ao arquivo ` 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 código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

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

Pré-requisitos

Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.

Install-Package Vonage

Escreva o código

Adicione o seguinte ao arquivo ` SendRcsSuggestedActionOpenUrlWebviewMessage.cs`:

var request = new RcsTextRequest
{
    To = MESSAGES_TO_NUMBER,
    From = RCS_SENDER_ID,
    Text = "Check out our latest offers!",
    Suggestions =
    [
        new OpenWebviewUrlSuggestion(
            "Open product page", 
            "postback_data_1234",
            new Uri("http://example.com/"), 
            "A URL for the Example website")
            .WithViewMode(OpenWebviewUrlSuggestion.ViewModeValue.Full)
    ]
};
var response = await vonageClient.MessagesClient.SendAsync(request);

Ver código-fonte completo

Experimente

Ao executar o código, uma mensagem é enviada para o número de destino.