Envie mensagens

Os agentes do RCS for Business se comunicam com os usuários enviando e recebendo mensagens. Para enviar mensagens aos usuários, seu agente envia solicitações de mensagem para a API RCS Business Messaging. Uma única solicitação pode incluir texto, rich cards, arquivos de mídia e PDF, respostas sugeridas e ações sugeridas.

A plataforma RCS for Business retorna erros em determinadas situações para ajudar você a gerenciar a entrega de mensagens:

  • Se você enviar uma mensagem para um usuário cujo dispositivo não é compatível com RCS ou não tem o RCS ativado, a plataforma RCS for Business vai retornar um erro 404 NOT_FOUND. Nesse caso, tente entrar em contato com o usuário usando os métodos de fallback definidos na sua infraestrutura.
  • Se você enviar uma mensagem para um usuário de RCS em uma rede em que seu agente ainda não foi lançado ou em uma rede que não ativou o tráfego de RCS, a plataforma RCS for Business vai retornar um erro 404 NOT_FOUND.
  • Se você enviar uma mensagem com recursos que não são compatíveis com o dispositivo de um usuário, a plataforma RCS for Business vai retornar o erro 400 INVALID_ARGUMENT e não vai entregar a mensagem.

Como parte da sua estratégia de mensagens multicanal, é melhor revogar as mensagens que não forem entregues após um tempo razoável e enviá-las por um canal diferente. Para revogar mensagens automaticamente em um horário predefinido, defina uma validade de mensagem.

O destinatário está off-line

A plataforma RCS for Business ainda aceita uma mensagem para entrega se o destinatário estiver off-line. Você recebe uma resposta 200 OK, e a plataforma RCS for Business retém a mensagem e tenta reenviá-la por 30 dias. Não é necessário pedir que o RCS for Business envie a mensagem novamente.

O RCS for Business exclui as mensagens não entregues 30 dias após o envio.

Dependendo do caso de uso do agente, talvez você queira revogar uma mensagem não entregue antes desse tempo limite de 30 dias. A revogação pode impedir que usuários off-line recebam uma mensagem desatualizada quando voltarem a ficar on-line. Há várias maneiras de revogar uma mensagem:

Definir uma data de validade para a mensagem

A mensagem do agente é urgente? Por exemplo, as OTPs são válidas apenas por um curto período. As ofertas por tempo limitado expiram. E os lembretes de compromissos não são relevantes após a data do compromisso. Para manter as mensagens oportunas e relevantes, defina uma expiração de mensagem. Isso pode impedir que usuários off-line recebam conteúdo desatualizado quando voltarem a ficar on-line. A expiração também é um bom momento para invocar sua estratégia de mensagens de fallback para que os usuários recebam as informações de que precisam a tempo.

Para definir uma expiração de mensagem, especifique um dos seguintes campos na mensagem do agente:

  • expireTime: o horário exato em UTC em que a mensagem expira.
  • ttl (time to live): o tempo que leva para a mensagem expirar.

Para opções de formatação e valor, consulte AgentMessage.

O valor máximo para ttl e expireTime é de 15 dias após o envio da mensagem.

O valor mínimo para ttl e expireTime é de seis segundos após o envio da mensagem.

Recomendações para definir a validade das mensagens

  • Para mensagens de autenticação (OTP): defina ttl como 15 segundos ou mais após o envio da mensagem para reduzir significativamente a chance de disputas de entrega e revogação.

  • Para mensagens transacionais e promocionais: defina expirações mais longas (pelo menos 60 segundos ou minutos a horas, dependendo do caso de uso), porque os dispositivos precisam de mais tempo para verificar mensagens e baixar ou processar conteúdo de mídia avançada, e os usuários podem ter breves quedas de conectividade (por exemplo, em um elevador ou túnel).

Time to live (TTL) de uma mensagem

Ao definir um TTL para uma mensagem do RCS for Business, você especifica por quanto tempo a mensagem deve ser considerada válida e entregável. Se a mensagem não for entregue ao dispositivo do usuário dentro desse período de TTL, a plataforma RCS para empresas tentará revogá-la automaticamente.

Ao iniciar uma revogação de mensagem, você solicita que a plataforma RCS for Business interrompa a tentativa de entrega dessa mensagem específica. No entanto, essa ação afeta apenas as tentativas de entrega futuras. Se o dispositivo de um usuário já tiver recuperado a mensagem, ela estará sendo processada, e a plataforma RCS for Business não poderá revogar a mensagem do dispositivo do usuário.

Veja o que esperar das notificações:

  • Mensagem entregue dentro do TTL: se o dispositivo do usuário ficar on-line e receber a mensagem antes que o TTL expire, você vai receber uma notificação DELIVERED. Nenhuma notificação de revogação será enviada, porque a mensagem foi entregue. Esse é o cenário mais comum e esperado.

  • Mensagem não entregue antes do vencimento do TTL: se o TTL expirar antes que a mensagem chegue ao dispositivo do usuário (por exemplo, se o dispositivo estiver off-line), a plataforma RCS for Business vai tentar revogar a mensagem. Você recebe uma notificação TTL_EXPIRATION_REVOKED, indicando que a mensagem foi removida da fila de entrega. Nesse caso, o usuário não vai receber a mensagem.

Recomendações para lidar com casos extremos

Nosso sistema processa a entrega de mensagens do RCS for Business e as expirações de TTL em paralelo. Por isso, em casos muito raros, você pode notar casos extremos em que o tempo das notificações é inesperado. Por exemplo, você pode receber uma notificação de entrega e uma de TTL ou não receber nenhuma.

Confira nossas recomendações para lidar com notificações de mensagens do RCS for Business:

  • Notificação DELIVERED: se você receber uma notificação DELIVERED para uma mensagem, isso confirma que ela chegou ao usuário. Você pode ignorar com segurança todas as notificações de TTL subsequentes para essa mensagem específica.

  • Notificação TTL_EXPIRATION_REVOKED: se você receber uma notificação de TTL com o status TTL_EXPIRATION_REVOKED, isso significa que o sistema do RCS for Business parou de tentar entregar essa mensagem específica. Trate essa mensagem como não entregue e prossiga com sua estratégia de fallback, se necessário.

  • Notificação de TTL com qualquer outro status: se você receber uma notificação de TTL com qualquer outro status, isso indica uma tentativa de revogação inconclusiva.

    • Para mensagens críticas, como senhas únicas (OTPs), inicie o método de fallback.
    • Para mensagens não críticas, decida se quer ou não iniciar o substituto.
  • Sem notificações: em casos raros, o sistema pode não enviar uma notificação de TTL, e o cliente também pode não gerar uma notificação de entrega. Esse é um caso extremamente raro.

Definir o tipo de tráfego de mensagens

A API RBM inclui um campo messageTrafficType para categorizar mensagens. Embora os casos de uso do agente ainda definam o comportamento do agente e quais regras de negócios se aplicam, o messageTrafficType permite uma categorização mais detalhada do conteúdo da mensagem. Por fim, isso possibilita que um único agente lide com vários casos de uso. No momento, não há impacto nos casos de uso ou nas regras de negócios dos agentes.

Esse campo é opcional, mas recomendamos que você o defina agora para não receber um erro quando ele se tornar obrigatório.

Para definir o tipo de tráfego de mensagens, atribua o messageTrafficType adequado a cada mensagem com base no conteúdo dela. A tabela a seguir lista os tipos de tráfego compatíveis e os casos de uso esperados do agente. Esse mapeamento é uma orientação recomendada sobre o uso esperado, não uma restrição aplicada pela API no momento.

Tipo de tráfego Conteúdo da mensagem Caso de uso recomendado do agente
AUTHENTICATION Para mensagens de autenticação. OTP
TRANSACTION Para mensagens sobre os serviços ou produtos de um usuário. Por exemplo: confirmações, comprovantes de pagamento ou detalhes de reservas. Transacional ou de uso variado
PROMOTION Para mensagens promocionais, como ofertas, descontos, anúncios ou outro conteúdo promocional. Promocional ou de uso variado
SERVICEREQUEST Para mensagens sobre serviços que o usuário solicitou explicitamente. OTP, transacional, promocional ou multiuso
ACKNOWLEDGEMENT Para mensagens usadas para confirmar uma ação do usuário, especificamente um pedido de cancelamento de inscrição. Confirma que a solicitação do usuário foi recebida e está sendo processada. OTP, transacional, promocional ou multiuso

Se nenhum tipo de tráfego for definido, o sistema vai atribuir o tipo padrão para o caso de uso do agente.

Caso de uso do agente Tipo de tráfego padrão
OTP AUTHENTICATION
Transacional TRANSACTION
Promocional PROMOTION
Multiuso MESSAGE_TRAFFIC_TYPE_UNSPECIFIED

Os agentes multiuso não têm um tipo de tráfego padrão. Defina o tipo de tráfego explicitamente para cada mensagem com base no conteúdo dela. Se você não substituir o valor MESSAGE_TRAFFIC_TYPE_UNSPECIFIED, a mensagem ainda será aceita e entregue sem uma classificação de tipo de tráfego específica.

Limites de tamanho da mensagem

O tamanho máximo de toda a AgentMessage em string é de 250 KB. A parte de texto da mensagem tem um limite próprio de 3.072 caracteres.

Para evitar o consumo inesperado de dados pelos usuários, o tamanho máximo de um arquivo que pode ser enviado pelo RCS for Business é de 100 MiB, e o tamanho total combinado de todos os anexos de mídia e PDF em uma única mensagem do RCS for Business não pode exceder 100 MiB. (1 MiB = 1.048.576 bytes). Para mais informações, consulte arquivos de mídia e PDF.

Texto

As mensagens mais simples são feitas de texto. As mensagens de texto são mais adequadas para comunicar informações sem a necessidade de recursos visuais, interação complexa ou resposta.

Exemplo

O código a seguir envia uma mensagem de texto simples. Para opções de formatação e valor, consulte phones.agentMessages.create.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  },
  "messageTrafficType": "PROMOTION"
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
};

// Send a simple message to the device
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Send simple text message to user
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444"
   );
} catch(Exception e) {
   e.printStackTrace();
}
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a simple RBM text message
message_text = messages.TextMessage('Hello, world!')

# Send text message to the device
messages.MessageCluster().append_message(message_text).send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
);
Este código é um trecho de um agente de exemplo do RBM.

Conteúdo básico da mensagem: conversão de SMS

As operadoras introduziram modelos de faturamento para apoiar a migração de mensagens SMS para o RCS for Business. Uma mensagem do RCS for Business com até 160 caracteres UTF-8 é chamada de mensagem básica.

Ao criar uma solicitação para enviar uma mensagem básica, lembre-se de que os caracteres são contados como 1 byte (UTF-8). Se você enviar uma mensagem com caracteres especiais, como emojis ou um conjunto de caracteres multibyte, cada caractere vai contar como 2 a 4 caracteres UTF-8 ou mais.

Digite um texto na caixa para verificar o tamanho:

Os clientes RCS podem implementar prévias de links. Se uma mensagem de texto do RCS for Business incluir um URL para um site com tags openGraph, o cliente poderá gerar uma prévia (imagem, título etc.), proporcionando uma experiência mais rica. Por exemplo, confira uma mensagem básica com uma prévia de URL.

O cliente RCS pode permitir que o usuário desative as prévias de links.

Senhas únicas para verificação do usuário

Você pode usar o RCS para empresas para enviar senhas de uso único (OTPs) para verificação automática de usuários com a API SMS Retriever. Não há uma API dedicada para ler OTPs que chegam pelo RCS for Business.

Como funciona no Android

Para apps Android registrados na API SMS Retriever, a API detecta uma mensagem do RCS for Business formatada corretamente. Essa mensagem precisa conter a OTP e um hash exclusivo que identifique seu app.

Quando uma mensagem do RCS for Business é recebida no formato correto, a API SMS Retriever a processa da mesma forma que faria com uma OTP de SMS. Depois que o hash for associado ao app, a OTP será extraída e encaminhada ao app para verificação automática do usuário.

  • Exemplo de mensagem de texto do RCS for Business para verificação do usuário: Your code is <OTP><app hash>.
  • Exemplo: Your code is 123456 M8tue43FGT.

Para saber mais sobre o SMS Retriever e as APIs relacionadas, consulte a documentação do SMS Retriever. Para detalhes sobre a verificação automática de usuários em apps registrados com a API SMS Retriever, consulte este diagrama de fluxo.

Como funciona para iOS

No iOS, o processamento de OTP integrado do sistema detecta e sugere automaticamente OTPs do RCS for Business para preenchimento automático, assim como os OTPs de SMS. Nenhuma integração de API específica é necessária para que o app iOS leia a OTP.

Arquivos de mídia e PDF

Ao enviar uma mensagem com uma imagem, um vídeo, um áudio ou um arquivo PDF, seu agente precisa fornecer um URL acessível ao público para o conteúdo ou fazer upload direto do arquivo.

O tamanho máximo de um arquivo que pode ser enviado é de 100 MiB, e o tamanho total combinado de todos os anexos de mídia e PDF em uma única mensagem não pode exceder 100 MiB.

Compactação e transcodificação de mídia

A plataforma RCS for Business transcodifica e compacta automaticamente arquivos de mídia (como imagens e vídeos) antes de enviá-los para garantir que eles carreguem rapidamente e funcionem bem em diferentes redes e dispositivos.

A compactação é baseada na qualidade da mídia de entrada, e não estritamente nos limites de tamanho do arquivo. Isso significa que um arquivo pode ser compactado mesmo que o tamanho dele esteja bem abaixo do limite máximo de 100 MiB. Os padrões de transcodificação mudam constantemente, então não há um limite fixo de tamanho de arquivo que determine quando a transcodificação é ignorada. Teste diferentes formatos de mídia, dimensões e taxas de compactação para encontrar o equilíbrio ideal para seus payloads.

Especificações da miniatura

Para arquivos de mídia, também é possível especificar uma imagem em miniatura que permite aos usuários visualizar o conteúdo antes de clicar nele. Para arquivos de áudio, o widget de áudio padrão é usado como marcador de posição.

  • O tamanho máximo do arquivo de uma miniatura é 100 kB. Para uma experiência do usuário ideal, recomendamos que ele tenha 50 kB ou menos.
  • A proporção da miniatura precisa corresponder à proporção do arquivo original.

Armazenamento em cache e gerenciamento de URL

A plataforma do RCS for Business armazena arquivos em cache por 60 dias, e a API retorna um ID de arquivo que seu agente pode incluir nas mensagens para os usuários. Após 60 dias, o RCS para Empresas remove os arquivos do cache.

Ao especificar arquivos por URL, a prática recomendada é definir contentMessage.forceRefresh como false. Definir contentMessage.forceRefresh como true força o RCS for Business a buscar novos conteúdos no URL especificado, mesmo que o conteúdo do URL esteja armazenado em cache, o que aumenta o tempo de entrega de mensagens para os usuários.

Exemplo de URL de arquivo

O código a seguir envia uma imagem. Para opções de formatação e valor, consulte AgentContentMessage.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "contentInfo": {
      "fileUrl": "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif",
      "forceRefresh": false
    }
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

let params = {
   fileUrl: 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif',
   msisdn: '+12223334444',
};

// Send an image/video to a device
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.AgentContentMessage;
import com.google.api.services.rcsbusinessmessaging.v1.model.AgentMessage;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   String fileUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

   // create media only message
   AgentContentMessage agentContentMessage = new AgentContentMessage();
   agentContentMessage.setContentInfo(new ContentInfo().setFileUrl(fileUrl));

   // attach content to message
   AgentMessage agentMessage = new AgentMessage();
   agentMessage.setContentMessage(agentContentMessage);

   rbmApiHelper.sendAgentMessage(agentMessage, "+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create media file attachment
file_message = messages.FileMessage('http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif')

messages.MessageCluster().append_message(file_message).send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

string fileUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

// Create content info with the file url
ContentInfo contentInfo = new ContentInfo
{
    FileUrl = fileUrl
};

// Attach content info to a message
AgentContentMessage agentContentMessage = new AgentContentMessage
{
    ContentInfo = contentInfo,
};

// Attach content to message
AgentMessage agentMessage = new AgentMessage
{
    ContentMessage = agentContentMessage
};

rbmApiHelper.SendAgentMessage(agentMessage, "+12223334444");
Este código é um trecho de um agente de exemplo do RBM.

Como alternativa, é possível fazer upload de mídia antes de enviá-la em uma mensagem com files.create.

Exemplo de upload de arquivo

O código a seguir faz upload de um arquivo de vídeo e de um arquivo de miniatura e, em seguida, envia os dois arquivos em uma mensagem. Para opções de formatação e valor, consulte files.create e AgentContentMessage.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/upload/v1/files?agentId=AGENT_ID" \
-H "Content-Type: video/mp4" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
--upload-file "FULL_PATH_TO_VIDEO_MEDIA_FILE"

# Capture server-specified video file name from response body JSON


curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/upload/v1/files?agentId=AGENT_ID" \
-H "Content-Type: image/jpeg" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
--upload-file "FULL_PATH_TO_THUMBNAIL_MEDIA_FILE"

# Capture server-specified image file name from response body JSON


curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "uploadedRbmFile": {
      "fileName": "SERVER-SPECIFIED_VIDEO_FILE_NAME",
      "thumbnailName": "SERVER-SPECIFIED_THUMBNAIL_FILE_NAME"
    }
  }
}'

Tipos de mídia compatíveis

O RCS para empresas é compatível com os seguintes tipos de mídia. Para miniaturas, apenas image/jpeg, image/jpg, image/gif e image/png são aceitos.

Tipo de mídia Tipo de documento Extensão Funciona com Rich Cards
application/ogg Áudio OGG .ogx Não
application/pdf PDF .pdf Sim (somente para o Google Mensagens na Índia)
audio/aac Áudio AAC .aac Não
audio/mp3 Áudio MP3 .mp3 Não
audio/mpeg Áudio MPEG .mpeg Não
audio/mpg Áudio MPG .mp3 Não
audio/mp4 Áudio MP4 .mp4 Não
audio/mp4-latm Áudio MP4-latm .mp4 Não
audio/3gpp Áudio 3GPP .3gp Não
image/jpeg JPEG .jpeg, .jpg Sim
image/gif GIF .gif Sim
image/png PNG .png Sim
video/h263 Vídeo H263 .h263 Sim
video/m4v Vídeo M4V .m4v Sim
video/mp4 Vídeo MP4 .mp4 Sim
video/mpeg4 Vídeo MPEG-4 .mp4, .m4p Sim
video/mpeg Vídeo MPEG .mpeg Sim
video/webm Vídeo WEBM .webm Sim

Sugestões

O agente envia sugestões (respostas sugeridas e ações sugeridas) em chips de sugestão de resposta ou em Rich Cards.

Respostas sugeridas

As respostas sugeridas orientam os usuários nas conversas, fornecendo respostas às quais seu agente sabe como reagir.

Quando um usuário toca em uma resposta sugerida, seu agente recebe um evento que contém o texto da resposta e os dados de postback. O payload tem um máximo de 2.048 caracteres.

Exemplo

O código a seguir envia um texto com duas respostas sugeridas. Para opções de formatação e valor, consulte SuggestedReply.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "reply": {
          "text": "Suggestion #1",
          "postbackData": "suggestion_1"
        }
      },
      {
        "reply": {
          "text": "Suggestion #2",
          "postbackData": "suggestion_2"
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

let suggestions = [
   {
      reply: {
         'text': 'Suggestion #1',
         'postbackData': 'suggestion_1',
      },
   },
   {
      reply: {
         'text': 'Suggestion #2',
         'postbackData': 'suggestion_2',
      },
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with suggestion chips to the device
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();
   suggestions.add(
      new SuggestionHelper("Suggestion #1", "suggestion_1").getSuggestedReply());

   suggestions.add(
      new SuggestionHelper("Suggestion #2", "suggestion_2").getSuggestedReply());

   // Send simple text message to user
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggested replies for the message to send to the user
cluster.append_suggestion_chip(messages.SuggestedReply('Suggestion #1', 'reply:suggestion_1'))
cluster.append_suggestion_chip(messages.SuggestedReply('Suggestion #2', 'reply:suggestion_2'))

# Send a simple message with suggestion chips to the device
cluster.send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

List<Suggestion> suggestions = new List<Suggestion>
{
   // Create suggestion chips
   new SuggestionHelper("Suggestion #1", "suggestion_1").SuggestedReply(),
   new SuggestionHelper("Suggestion #2", "suggestion_2").SuggestedReply()
};

// Send simple text message with suggestions to user
rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
   suggestions
);
Este código é um trecho de um agente de exemplo do RBM.

Ações sugeridas

As ações sugeridas orientam os usuários nas conversas usando a funcionalidade integrada dos dispositivos. Seu agente pode sugerir que os usuários liguem para um número, abram um local em um mapa, compartilhem um local, abram um URL ou criem um evento da agenda.

Para cada ação sugerida, você pode fornecer um URL alternativo (máximo de 2.048 caracteres). Esse URL será aberto em uma nova janela do navegador se o dispositivo do usuário não for compatível com a ação sugerida.

Quando um usuário toca em uma ação sugerida, seu agente recebe um evento que contém os dados de postback da ação.

Para opções de formatação e valor, consulte SuggestedAction.

Exibição de sugestões

Há duas maneiras de exibir sugestões:

  • Persistent: ações sugeridas ou respostas que são exibidas dentro do balão de mensagem e permanecem fixas durante toda a conversa.
  • Temporárias: sugestões que são exibidas fora do balão de mensagem e desaparecem quando a conversa continua.

Formatos de mensagem compatíveis

  • Sugestões persistentes: funcionam com mensagens de texto independentes e cards avançados.
  • Sugestões temporárias: funcionam com mensagens de texto independentes, mensagens de mídia e Rich Cards.

Combinar sugestões

É possível misturar sugestões persistentes e temporárias na mesma mensagem ou no mesmo card avançado.

  • Mensagens de texto: as sugestões são temporárias por padrão. Para que eles permaneçam dentro do balão, é necessário configurá-los como persistentes.
  • Rich Cards: aceitam até quatro sugestões persistentes por padrão. Em seguida, você pode adicionar sugestões temporárias como uma "lista de ícones" abaixo do card.

Limites de sugestões

Uma única mensagem de texto aceita no máximo 11 sugestões no total. Todas as sugestões persistentes incluídas são contabilizadas nesse limite total. Por exemplo, se você incluir 4 sugestões persistentes, poderá adicionar até 7 sugestões temporárias.

Tipo de sugestão Limite Onde aparecem
Permanente Até 4 Dentro do balão de mensagem
Transitório Até 11 Fora do balão (como ícones)

Limite de caracteres

Cada sugestão tem no máximo 25 caracteres.

Transparência de URL em ações sugeridas

Para aumentar a confiança do usuário, o URL subjacente é exibido como uma segunda linha de texto no botão de sugestão para ações sugeridas de "Abrir um URL". Esse comportamento consistente se aplica a mensagens de texto independentes, rich cards e carrosséis.

Clientes compatíveis com sugestões persistentes

  • Compatível: Google Mensagens (versão 20260225.00 ou mais recente).
  • Não compatível: versões do Google Mensagens anteriores à 20260225.00, iOS e Samsung Messages.

Sugestões nas notificações do sistema

Quando um usuário recebe uma mensagem, o Google Mensagens mostra a primeira sugestão qualificada diretamente na notificação do sistema Android. Os usuários podem tocar nessa sugestão para enviar uma resposta ou acionar uma ação sem precisar abrir o app.

Ao criar suas mensagens, lembre-se do seguinte comportamento:

  • A ordem é importante: apenas uma sugestão é mostrada por notificação. Para maximizar o engajamento, coloque a resposta sugerida ou ação de maior prioridade em primeiro lugar na lista de sugestões.
  • Ações excluídas: a ação Compartilhar local nunca é mostrada nas notificações do sistema. Os usuários precisam abrir a conversa para compartilhar o local.

Digite o número de telefone

A ação de discagem orienta o usuário a discar um número de telefone especificado pelo agente. Os números de telefone só podem incluir dígitos (0-9), sinal de adição (+), asterisco (*) e sinal de número (#). O formato internacional E.164 (por exemplo, +14155555555) é aceito, mas não obrigatório. Ou seja, +14155555555 e 1011 são entradas válidas.

Exemplo

O código a seguir envia uma ação de discagem. Para opções de formatação e valor, consulte DialAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "Call",
          "postbackData": "postback_data_1234",
          "fallbackUrl": "https://www.google.com/contact/",
          "dialAction": {
            "phoneNumber": "+15556667777"
          }
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a dial suggested action
let suggestions = [
   {
      action: {
         text: 'Call',
         postbackData: 'postback_data_1234',
         dialAction: {
            phoneNumber: '+15556667777'
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with a dial suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.DialAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a dial suggested action
   DialAction dialAction = new DialAction();
   dialAction.setPhoneNumber("+15556667777");

   // creating a suggested action based on a dial action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Call");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setDialAction(dialAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a dial suggested action
suggestions = [
      messages.DialAction('Call', 'reply:postback_data_1234', '+15556667777')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create a dial an agent suggested action
DialAction dialAction = new DialAction
{
    PhoneNumber = "+15556667777"
};

// Creating a suggested action based on a dial action
SuggestedAction suggestedAction = new SuggestedAction
{
    Text = "Call",
    PostbackData = "postback_data_1234",
    DialAction = dialAction
};

// Attach action to a suggestion
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Este código é um trecho de um agente de exemplo do RBM.

Ver um local

A ação de visualizar local mostra um local no app de mapas padrão do usuário. É possível especificar o local por latitude e longitude ou com uma consulta com base no local atual do usuário. Também é possível definir um marcador personalizado para o alfinete que aparece no app de mapas.

Exemplo

O código a seguir envia uma ação de visualização de local. Para opções de formatação e valor, consulte ViewLocationAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "View map",
          "postbackData": "postback_data_1234",
          "fallbackUrl": "https://www.google.com/maps/@37.4220188,-122.0844786,15z",
          "viewLocationAction": {
            "latLong": {
              "latitude": "37.4220188",
              "longitude": "-122.0844786"
            },
            "label": "Googleplex"
          }
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a view location suggested action
let suggestions = [
   {
      action: {
         text: 'View map',
         postbackData: 'postback_data_1234',
         viewLocationAction: {
            latLong: {
               latitude: 37.4220188,
               longitude: -122.0844786
            },
            label: 'Googleplex'
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with a view location suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.ViewLocationAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a view location suggested action
   ViewLocationAction viewLocationAction = new ViewLocationAction();
   viewLocationAction.setQuery("Googleplex, Mountain View, CA");

   // creating a suggested action based on a view location action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("View map");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setViewLocationAction(viewLocationAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a view location suggested action
suggestions = [
      messages.ViewLocationAction('View map',
            'reply:postback_data_1234',
            query='Googleplex, Mountain View, CA')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// create an view location action
ViewLocationAction viewLocationAction = new ViewLocationAction
{
    Query = "Googleplex Mountain View, CA"
};

// Attach the view location action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    ViewLocationAction = viewLocationAction,
    Text = "View map",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Este código é um trecho de um agente de exemplo do RBM.

Compartilhar um local

A ação "Compartilhar local" permite que o usuário compartilhe um local com seu agente. O usuário pode compartilhar o local atual ou um local selecionado manualmente no app Maps.

Exemplo

O código a seguir envia uma ação de compartilhamento de local. Para opções de formatação e valor, consulte ShareLocationAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "Share your location",
          "postbackData": "postback_data_1234",
          "shareLocationAction": {}
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a share location suggested action
let suggestions = [
   {
      action: {
         text: 'Share your location',
         postbackData: 'postback_data_1234',
         shareLocationAction: {
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with a share location suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.ShareLocationAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a share location suggested action
   ShareLocationAction shareLocationAction = new ShareLocationAction();

   // creating a suggested action based on a share location action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Share location");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setShareLocationAction(shareLocationAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a share location suggested action
suggestions = [
      messages.ShareLocationAction('Share location',
            'reply:postback_data_1234')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create a share location action
ShareLocationAction shareLocationAction = new ShareLocationAction();

// Attach the share location action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    ShareLocationAction = shareLocationAction,
    Text = "Share location",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Este código é um trecho de um agente de exemplo do RBM.

Abrir um URL

A ação "Abrir URL" permite que você direcione os usuários para uma página da Web especificada pelo agente. Por padrão, a página da Web é aberta no navegador do usuário. Também é possível definir a página da Web para abrir em uma WebView. Consulte Abrir um URL com a WebView para mais detalhes.

Somente no Google Mensagens

Exibição do URL subjacente: para melhorar a transparência nas mensagens A2P, o Google Mensagens mostra o endereço de URL subjacente nas ações sugeridas "Abrir um URL". Essa mudança afeta as ações sugeridas em Rich Cards padrão e carrosséis de Rich Cards.

Um Rich Card mostrando uma sugestão &quot;Acessar site&quot; com o URL exibido abaixo.
URL subjacente visível

Exibição do ícone do app para links da Web: se o usuário tiver um app padrão configurado para a página da Web, esse app será aberto em vez do navegador ou da WebView, e o botão de sugestão vai mostrar o ícone do app. Para que o ícone do app apareça no Google Mensagens, forneça o URL completo e direto. Se você usar um URL encurtado, o ícone padrão de URL aberto será exibido.

Ícone do app em um botão de sugestão.
Ícone do app em um botão de sugestão
Exemplo

O código a seguir envia uma ação de abertura de URL. Para opções de formatação e valor, consulte OpenUrlAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "Open Google",
          "postbackData": "postback_data_1234",
          "openUrlAction": {
            "url": "https://www.google.com"
          }
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define an open URL suggested action
let suggestions = [
   {
      action: {
         text: 'Open Google',
         postbackData: 'postback_data_1234',
         openUrlAction: {
            url: 'https://www.google.com'
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with an open URL suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.OpenUrlAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating an open url suggested action
   OpenUrlAction openUrlAction = new OpenUrlAction();
   openUrlAction.setUrl("https://www.google.com");

   // creating a suggested action based on an open url action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Open Google");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setOpenUrlAction(openUrlAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create an open url suggested action
suggestions = [
      messages.OpenUrlAction('Open Google',
            'reply:postback_data_1234',
            'https://www.google.com')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create an open url action
OpenUrlAction openUrlAction = new OpenUrlAction
{
    Url = "https://www.google.com"
};

// Attach the open url action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    OpenUrlAction = openUrlAction,
    Text = "Open Google",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Este código é um trecho de um agente de exemplo do RBM.

Abrir um URL com a WebView

A ação "Abrir URL com webview" carrega a página da Web especificada no app de mensagens com o mecanismo de renderização do seu navegador padrão. Isso permite que o usuário interaja com a página da Web sem sair da conversa do RCS para empresas. Se o dispositivo do usuário não for compatível com webviews, a página da Web será aberta no navegador do usuário. Para ativar as WebViews, consulte OpenURLApplication.

As WebViews têm três modos de exibição. Para opções de formatação e valor, consulte WebviewViewMode.

  • Completa: a página da Web ocupa a tela inteira.
  • Metade: a página da Web ocupa metade da tela.
  • Alta: a página da Web ocupa três quartos da tela.
Exemplo

O código a seguir envia uma ação de abrir URL com WebView. Para opções de formatação e valor, consulte OpenURLAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
 "contentMessage": {
   "text": "Hello, world!",
   "suggestions": [
     {
       "action": {
         "text": "Open Google",
         "postbackData": "postback_data_1234",
         "openUrlAction": {
           "url": "https://www.google.com",
           "application": "WEBVIEW",
           "webviewViewMode": "FULL",
           "description": "Accessibility description"
         }
       }
     }
   ]
 }
}'

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.OpenUrlAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…
  
try {
  
   String URL = "https://www.google.com";
  
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();
  
   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // Create suggestion to view webpage in full mode
   Suggestion viewInFullMode =  getUrlActionInWebview(URL, "FULL")
   suggestions.add(viewInFullMode);
  
   // create suggestion to view webpage in half mode
   Suggestion viewInHalfMode =  getUrlActionInWebview(URL, "HALF")
   suggestions.add(viewInHalfMode);
     
   // create suggestion to view webpage in tall mode
   Suggestion viewInTallMode =  getUrlActionInWebview(URL, "TALL")
   suggestions.add(viewInTallMode);
     
   // Send simple text message with the suggested action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

  /**
    * Creates a suggested action to open URL in webview.
    *
    * @return a suggestion object for an open URL in webview action .
    */
    private Suggestion getUrlActionInWebview(String url,
                                             String viewMode) {
      // create an open url action
      OpenUrlAction openUrlAction = new OpenUrlAction();
      openUrlAction.setUrl(url);
      openUrlAction.setApplication("WEBVIEW");
      openUrlAction.setWebviewViewMode(viewMode);
      openUrlAction.setDescription("Accessibility description");
     
      // attach the open url action to a suggested action
      SuggestedAction suggestedAction = new SuggestedAction();
      suggestedAction.setOpenUrlAction(openUrlAction);
      suggestedAction.setText('display_text');
      suggestedAction.setPostbackData('postback_data_123');
     
      // attach the action to a suggestion object
      Suggestion suggestion = new Suggestion();
      suggestion.setAction(suggestedAction);
     
      return suggestion;
    }

Criar um evento da agenda

A ação "Criar evento da agenda" abre o app de agenda do usuário e começa a criar um evento com as informações especificadas.

O título do evento da agenda é obrigatório. Ele tem no máximo 100 caracteres. A descrição do evento da agenda é opcional e tem no máximo 500 caracteres.

Exemplo

O código a seguir envia uma ação para criar um evento da agenda. Para opções de formatação e valor, consulte CreateCalendarEventAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "Save to calendar",
          "postbackData": "postback_data_1234",
          "fallbackUrl": "https://www.google.com/calendar",
          "createCalendarEventAction": {
            "startTime": "2020-06-30T19:00:00Z",
            "endTime": "2020-06-30T20:00:00Z",
            "title": "My calendar event",
            "description": "Description of the calendar event"
          }
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a create calendar event suggested action
let suggestions = [
   {
      action: {
         text: 'Save to calendar',
         postbackData: 'postback_data_1234',
         createCalendarEventAction: {
            startTime: '2020-06-30T19:00:00Z',
            endTime: '2020-06-30T20:00:00Z',
            title: 'My calendar event',
            description: 'Description of the calendar event',
         },
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with a create calendar event suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.CreateCalendarEventAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a create calendar event suggested action
   CreateCalendarEventAction createCalendarEventAction = new CreateCalendarEventAction();
   calendarEventAction.setTitle("My calendar event");
   calendarEventAction.setDescription("Description of the calendar event");
   calendarEventAction.setStartTime("2020-06-30T19:00:00Z");
   calendarEventAction.setEndTime("2020-06-30T20:00:00Z");

   // creating a suggested action based on a create calendar event action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Save to calendar");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setCreateCalendarEventAction(createCalendarEventAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a calendar event suggested action
suggestions = [
      messages.CreateCalendarEventAction('Save to Calendar',
                             'reply:postback_data_1234',
                             '2020-06-30T19:00:00Z',
                             '2020-06-30T20:00:00Z',
                             'My calendar event',
                             'Description of the calendar event')

]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create a calendar event action
CreateCalendarEventAction calendarEventAction = new CreateCalendarEventAction
{
    Title = "My calendar event",
    Description = "Description of the calendar event",
    StartTime = "2020-06-30T19:00:00Z",
    EndTime = "2020-06-30T20:00:00Z"
};

// Attach the calendar event action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    CreateCalendarEventAction = calendarEventAction,
    Text = "Save to calendar",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Este código é um trecho de um agente de exemplo do RBM.

Lista de chips de sugestão de resposta

Seu agente envia listas de chips de sugestão de resposta com mensagens para orientar as ações subsequentes dos usuários. A lista de ícones só aparece quando a mensagem associada está na parte de baixo da conversa. As mensagens subsequentes na conversa (de um usuário ou do seu agente) substituem a lista de ícones.

Os ícones na lista são respostas sugeridas e ações sugeridas.

As listas de chips contêm no máximo 11 chips de sugestão de resposta, e cada rótulo de chip pode ter no máximo 25 caracteres.

Para opções de formatação e valor, consulte AgentContentMessage.

Rich Cards

Os rich cards combinam mídia, texto e sugestões interativas em uma única mensagem. Eles são ideais para apresentar informações relacionadas (por exemplo, um produto com imagem, nome e preço) e orientar os usuários com uma próxima etapa clara, como uma sugestão de "Ver detalhes".

Um Rich Card pode conter o seguinte:

Cada um desses campos é opcional, mas pelo menos um dos campos de 1 a 3 precisa ser incluído no Rich Card.

Vários cards podem ser enviados juntos em um carrossel de rolagem horizontal.

Observe que o payload total de um Rich Card é de 250 kB.

Para ver todos os detalhes técnicos, consulte a documentação sobre Rich Cards.

Altura do card

Os Rich Cards se expandem verticalmente para se ajustar ao conteúdo. Eles têm uma altura mínima de 112 DP e uma altura máxima de 344 DP. Se o conteúdo do card não for grande o suficiente para preencher a altura mínima, o card será expandido e o espaço extra será preenchido com espaço em branco.

A mídia em Rich Cards precisa se ajustar a uma das três alturas:

  • Curto: 112 DP
  • Médio: 168 DP
  • Grande: 264 DP

Se a mídia não se ajustar às dimensões do card de acordo com a altura selecionada, a visualização será escolhida ao aumentar o zoom e cortar a mídia.

Exemplo

O código a seguir envia um Rich Card com uma imagem e respostas sugeridas. Para opções de formatação e valor, consulte RichCard.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "richCard": {
      "standaloneCard": {
        "thumbnailImageAlignment": "RIGHT",
        "cardOrientation": "VERTICAL",
        "cardContent": {
          "title": "Hello, world!",
          "description": "RBM is awesome!",
          "media": {
            "height": "TALL",
            "contentInfo":{
              "fileUrl": "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif",
              "forceRefresh": false
            }
          },
          "suggestions": [
            {
              "reply": {
                "text": "Suggestion #1",
                "postbackData": "suggestion_1"
              }
            },
            {
              "reply": {
                "text": "Suggestion #2",
                "postbackData": "suggestion_2"
              }
            }
          ]
        }
      }
    }
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Suggested replies to be used in the card
let suggestions = [
   {
      reply: {
         'text': 'Suggestion #1',
         'postbackData': 'suggestion_1',
      },
   },
   {
      reply: {
         'text': 'Suggestion #2',
         'postbackData': 'suggestion_2',
      },
   },
];

// Image to be displayed by the card
let imageUrl = 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif';

// Definition of the card parameters
let params = {
   messageText: 'Hello, world!',
   messageDescription: 'RBM is awesome!',
   msisdn: '+12223334444',
   suggestions: suggestions,
   imageUrl: imageUrl,
   height: 'TALL',
};

// Send rich card to device
rbmApiHelper.sendRichCard(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.StandaloneCard;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.cards.CardOrientation;
import com.google.rbm.cards.MediaHeight;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();
   suggestions.add(
      new SuggestionHelper("Suggestion #1", "suggestion_1").getSuggestedReply());

   suggestions.add(
      new SuggestionHelper("Suggestion #2", "suggestion_2").getSuggestedReply());

   String imageUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

   // Create a standalone rich card to send to the user
   StandaloneCard standaloneCard = rbmApiHelper.createStandaloneCard(
       "Hello, world!",
       "RBM is awesome!",
       imageUrl,
       MediaHeight.MEDIUM,
       CardOrientation.VERTICAL,
       suggestions
   );

   rbmApiHelper.sendStandaloneCard(standaloneCard, "+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Suggested replies to be used in the card
suggestions = [
      messages.SuggestedReply('Suggestion #1', 'reply:suggestion_1'),
      messages.SuggestedReply('Suggestion #2', 'reply:suggestion_2')
]

# Image to be displayed by the card
image_url = 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif';

# Define rich card structure
rich_card = messages.StandaloneCard('VERTICAL',
                                    'Hello, world!',
                                    'RBM is awesome!',
                                    suggestions,
                                    image_url,
                                    None,
                                    None,
                                    'MEDIUM')

# Append rich card and send to the user
cluster = messages.MessageCluster().append_message(rich_card)
cluster.send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
using RCSBusinessMessaging.Cards;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

List<Suggestion> suggestions = new List<Suggestion>
{
   // Create suggestion chips
   new SuggestionHelper("Suggestion #1", "suggestion_1").SuggestedReply(),
   new SuggestionHelper("Suggestion #2", "suggestion_2").SuggestedReply()
};

string imageUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

// Create rich card with suggestions
StandaloneCard standaloneCard = rbmApiHelper.CreateStandaloneCard(
   "Hello, world!",
   "RBM is awesome",
   imageUrl,
   MediaHeight.TALL,
   CardOrientation.VERTICAL,
   suggestions
);

// Send rich card to user
rbmApiHelper.SendStandaloneCard(standaloneCard, "+12223334444");
Este código é um trecho de um agente de exemplo do RBM.

Carrosséis de Rich Cards

Os carrosséis reúnem vários cards avançados, permitindo que os usuários comparem itens e reajam a cada um individualmente.

Os carrosséis podem conter de dois a dez rich cards. Os rich cards em carrosséis precisam estar em conformidade com os requisitos gerais de conteúdo e altura, conforme descrito na documentação de rich cards. Para mais informações sobre o layout e as especificações do carrossel, consulte a documentação do carrossel.

Exemplo

O código a seguir envia um carrossel de Rich Card. Para opções de formatação e valor, consulte RichCard.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "richCard": {
      "carouselCard": {
        "cardWidth": "MEDIUM",
        "cardContents": [
          {
            "title": "Card #1",
            "description": "The description for card #1",
            "suggestions": [
              {
                "reply": {
                  "text": "Card #1",
                  "postbackData": "card_1"
                }
              }
            ],
            "media": {
              "height": "MEDIUM",
              "contentInfo": {
                "fileUrl": "https://storage.googleapis.com/welcome-bot-sample-images/200.jpg",
                "forceRefresh": false
              }
            }
          },
          {
            "title": "Card #2",
            "description": "The description for card #2",
            "suggestions": [
              {
                "reply": {
                  "text": "Card #2",
                  "postbackData": "card_2"
                }
              }
            ],
            "media": {
              "height": "MEDIUM",
              "contentInfo": {
                "fileUrl": "https://storage.googleapis.com/welcome-bot-sample-images/201.jpg",
                "forceRefresh": false
              }
            }
          }
        ]
      }
    }
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Images for the carousel cards
let card1Image = 'https://storage.googleapis.com/welcome-bot-sample-images/200.jpg';
let card2Image = 'https://storage.googleapis.com/welcome-bot-sample-images/201.jpg';

// Define the card contents for a carousel with two cards, each with one suggested reply
let cardContents = [
   {
      title: 'Card #1',
      description: 'The description for card #1',
      suggestions: [
         {
            reply: {
               text: 'Card #1',
               postbackData: 'card_1',
            }
         }
      ],
      media: {
         height: 'MEDIUM',
         contentInfo: {
            fileUrl: card1Image,
            forceRefresh: false,
         },
      },
   },
   {
      title: 'Card #2',
      description: 'The description for card #2',
      suggestions: [
         {
            reply: {
               text: 'Card #2',
               postbackData: 'card_2',
            }
         }
      ],
      media: {
         height: 'MEDIUM',
         contentInfo: {
            fileUrl: card2Image,
            forceRefresh: false,
         },
      },
   },
];

// Definition of carousel card
let params = {
   msisdn: '+12223334444',
   cardContents: cardContents,
};

// Send the device the carousel card defined above
rbmApiHelper.sendCarouselCard(params, function(response) {
   console.log(response);
});
Este código é um trecho de um agente de exemplo do RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.CardContent;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.cards.CardOrientation;
import com.google.rbm.cards.CardWidth;
import com.google.rbm.cards.MediaHeight;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…

try {
            // Create an instance of the RBM API helper
            RbmApiHelper rbmApiHelper = new RbmApiHelper();

            List cardContents = new ArrayList();

            // Images for the carousel cards
            String card1Image = "https://storage.googleapis.com/welcome-bot-sample-images/200.jpg";

            // Create suggestions for first carousel card
            List card1Suggestions = new ArrayList();
            card1Suggestions.add(
                new SuggestionHelper("Card #1", "card_1"));

            cardContents.add(
                new StandaloneCardHelper(
                    "Card #1",
                    "The description for card #1",
                    card1Image,
                    card1Suggestions)
                    .getCardContent(MediaHeight.SHORT)
            );

            // Images for the carousel cards
            String card2Image = "https://storage.googleapis.com/welcome-bot-sample-images/201.jpg";

            // Create suggestions for second carousel card
            List card2Suggestions = new ArrayList();
            card2Suggestions.add(
                new SuggestionHelper("Card #2", "card_2"));

            cardContents.add(
                new StandaloneCardHelper(
                    "Card #2",
                    "The description for card #2",
                    card2Image,
                    card2Suggestions)
                    .getCardContent(MediaHeight.SHORT)
            );

            // Send the carousel to the user
            rbmApiHelper.sendCarouselCards(cardContents, CardWidth.MEDIUM, "+12223334444");
        } catch(Exception e) {
            e.printStackTrace();
        }
Este código é um trecho de um agente de exemplo do RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Images for the carousel cards
card_image_1 = 'https://storage.googleapis.com/welcome-bot-sample-images/200.jpg';
card_image_2 = 'https://storage.googleapis.com/welcome-bot-sample-images/201.jpg';

# Suggested replies to be used in the cards
suggestions1 = [
      messages.SuggestedReply('Card #1', 'reply:card_1')
]

suggestions2 = [
      messages.SuggestedReply('Card #2', 'reply:card_2')
]

# Define the card contents for a carousel with two cards,
# each with one suggested reply
card_contents = []
card_contents.append(messages.CardContent('Card #1',
                                          'The description for card #1',
                                          card_image_1,
                                          'MEDIUM',
                                          suggestions1))

card_contents.append(messages.CardContent('Card #2',
                                          'The description for card #2',
                                          card_image_2,
                                          'MEDIUM',
                                          suggestions2))

# Send the device the carousel card defined above
carousel_card = messages.CarouselCard('MEDIUM', card_contents)
cluster = messages.MessageCluster().append_message(carousel_card)
cluster.send_to_msisdn('+12223334444')
Este código é um trecho de um agente de exemplo do RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
using RCSBusinessMessaging.Cards;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Image references to be used in the carousel cards
string card1Image = "https://storage.googleapis.com/welcome-bot-sample-images/200.jpg";
string card2Image = "https://storage.googleapis.com/welcome-bot-sample-images/201.jpg";

// Suggestion chip lists to be used in carousel cards
List<Suggestion> suggestions1 = new List<Suggestion>
{
   new SuggestionHelper("Card #1", "card_1").SuggestedReply()
};

List<Suggestion> suggestions2 = new List<Suggestion>
{
   new SuggestionHelper("Card #2", "card_2").SuggestedReply()
};

// Create the card content for the carousel
List<CardContent> cardContents = new List<CardContent>
{
   // Add items as card content
   new StandaloneCardHelper(
                    "Card #1",
                    "The description for card #1",
                    card1Image,
                    suggestions1).GetCardContent(),
   new StandaloneCardHelper(
                    "Card #2",
                    "The description for card #2",
                    card2Image,
                    suggestions2).GetCardContent()
};

// Send the carousel to the user
rbmApiHelper.SendCarouselCards(cardContents, CardWidth.MEDIUM, msisdn);
Este código é um trecho de um agente de exemplo do RBM.