Os usuários podem iniciar uma conversa com seu agente a partir de um link direto enviado por SMS. O local onde você coloca o link depende do seu caso de uso. Você pode colocá-lo em um e-mail, um site, um aplicativo ou um local físico — em qualquer lugar onde seja possível incorporar o link como um botão, link ou código QR.
A navegação manual até o URL de um agente (copiando e colando, por exemplo) não funciona devido às medidas de segurança do navegador. É necessário incorporar o URL em um botão, link ou código QR.
A experiência do usuário
Quando o usuário abre o URL do seu agente, existem três resultados possíveis: sucesso, fallback ou erro.
Sucesso
O usuário inicia uma conversa RBM com sucesso. Para que a conversa seja iniciada com êxito, todos os seguintes critérios devem ser atendidos:
- O Google Mensagens está instalado no dispositivo deles (versão mínima
messages.android_20241029_00). - Os chats RCS estão habilitados no app Mensagens.
- Seu agente RBM é iniciado na operadora do usuário.
Cair pra trás
O usuário é redirecionado para um número de telefone alternativo ou código curto. Isso ocorre se algum dos critérios de sucesso não for atendido e um número alternativo tiver sido fornecido na URL.
Erro
O usuário vê uma mensagem de erro e um link para a Central de Ajuda de Mensagens , que explica por que o agente pode não estar disponível e oferece suporte na resolução do problema.
Isso ocorre se algum dos critérios de sucesso não for atendido e um número alternativo não tiver sido fornecido.
Crie a URL do agente
Você pode criar URLs em dois formatos, conforme definido em GSMA RCC.07 v.14.0 , seção 3.6.3.4.
Por motivos de segurança, esses formatos não suportam respostas sugeridas pré-preenchidas ou ações sugeridas dentro da URL.
Formato 1: Use apenas o ID do serviço
sms:bot%40botplatform.example.com?body=tell%20me%20about%20checking%20accounts
-
sms:bot%40botplatform.example.com: ID de serviço exclusivo para seu agente. -
&body=tell%20me%20about%20checking%20accounts: Mensagem opcional pré-preenchida que o usuário verá ao abrir a conversa do RBM com seu agente.
Limitação : Este formato não permite incluir um número de telefone alternativo. Se não for possível estabelecer uma conversa RBM, o usuário receberá uma mensagem de erro .
Formato 2: Utilize um número de telefone e um ID de serviço.
sms:+15554443333?service_id=bot%40botplatform.example.com&body=tell%20me%20about%20checking%20accounts
-
+15554443333: Número de telefone no formato E.164 ou código curto válido associado ao seu agente. -
service_id=bot%40botplatform.example.com: ID de serviço exclusivo para o seu agente. -
body=tell%20me%20about%20checking%20accounts: Mensagem opcional pré-preenchida que o usuário verá ao abrir a conversa RBM com seu agente.
Limitação : Alguns aplicativos de câmera de fabricantes de equipamentos originais (como Samsung e Xiaomi) removem parâmetros de consulta personalizados, como service_id , ao lerem códigos QR sms: Isso faz com que o dispositivo abra um chat com o número de telefone alternativo em vez do seu agente RBM. Ao usar o Formato 2 em um código QR, sempre codifique um link curto HTTPS que redirecione para a URL sms: (consulte as Melhores práticas ) ou use o Formato 1 se um número de telefone alternativo não for necessário.
Mensagem pré-preenchida
Para proporcionar uma experiência de usuário mais fluida, você pode preencher previamente o campo de entrada de mensagem quando a conversa do RBM for aberta. Isso permite que os usuários enviem rapidamente uma mensagem relevante tocando no botão de enviar.
Para incluir uma mensagem pré-preenchida, use o parâmetro body na URL. O parâmetro body deve ser codificado em URL. Por exemplo, os espaços devem ser substituídos por %20 .
A mensagem deve estar alinhada com a intenção do usuário e com os objetivos da sua marca. Aqui está um exemplo de uma marca de bem-estar: sms:bot%40botplatform.example.com?body=make%20an%20appointment. Quando o usuário tocar nesse link, o aplicativo de mensagens abrirá o chat com a mensagem predefinida "Agendar uma consulta".

Melhores práticas
Ao incorporar códigos QR nos materiais da sua marca, crie sempre um link curto que redirecione os usuários para o URL do agente (por exemplo, https://short.link/abc123 ). Veja a seguir os benefícios de usar um link curto:
- À prova de futuro : você pode atualizar o URL do agente por trás do link curto, se necessário, sem precisar reimprimir materiais com um novo código QR.
- Recurso alternativo transparente : evita confusão do usuário sobre o URL caso ele seja redirecionado para uma opção alternativa.
- Compatibilidade de QR Code entre dispositivos : Impede que aplicativos de câmera de fabricantes de equipamentos originais (como Samsung e Xiaomi) removam o parâmetro
service_idao ler códigos QR que incluem um número de telefone alternativo.
Teste em dispositivos dual-SIM
Se um dispositivo tiver mais de um SIM ou eSIM, o Google Mensagens usa apenas um SIM para verificar se o seu agente está disponível. O Google Mensagens seleciona o primeiro SIM ativo que tenha o recurso de chats RCS ativado. Se nenhum SIM tiver o recurso de chats RCS ativado, o Google Mensagens usa o SIM no primeiro slot. Se o seu agente não estiver em execução na operadora do SIM selecionado e o número de telefone desse SIM não for de um dispositivo de teste , o usuário verá o erro ou o resultado de fallback . Isso acontece mesmo se o seu agente estiver em execução na operadora do outro SIM.
Para obter resultados confiáveis ao testar o URL do seu agente em um dispositivo dual-SIM, faça um dos seguintes procedimentos:
- Registre o número de telefone de cada SIM no dispositivo como um dispositivo de teste para seu agente.
- Desligue os SIMs que você não usa para testes. Em seguida, force o encerramento do Google Mensagens, abra-o novamente e acesse o URL do seu agente.
Usuários com dispositivos dual-SIM também podem ver esse resultado. Para oferecer a esses usuários uma forma de entrar em contato com sua empresa, utilize o Formato 2 com um número de telefone alternativo.
Criador de links SMS
Para criar um link SMS e gerar um código QR para seu agente, insira as seguintes informações e clique em Criar link SMS :
- ID do agente (obrigatório). Você pode encontrar seu ID de agente na Visão geral do agente no Console do desenvolvedor do RCS for Business .
- Número de telefone alternativo (opcional).
- Mensagem em rascunho (opcional).