Os usuários podem iniciar uma conversa com seu agente usando um URL. O local em que você coloca o URL depende do seu caso de uso. Você pode colocar o URL em um e-mail, site, app ou local físico, em qualquer lugar em que possa incorporar o URL como um botão, link ou código QR.
Navegar manualmente para 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 agente, há três resultados possíveis: sucesso, fallback ou erro.
Sucesso
O usuário inicia uma conversa com o RBM. Para que a conversa seja iniciada, todos os critérios a seguir precisam ser atendidos:
- O Google Mensagens está instalado no dispositivo (versão mínima
messages.android_20241029_00). - Os chats RCS estão ativados no app Mensagens.
- O agente do RBM é lançado na operadora do usuário.
Fallback
O usuário é direcionado para um número de telefone ou código de acesso alternativo. Isso ocorre se algum dos critérios de sucesso não for atendido e um número alternativo tiver sido fornecido no URL.
Erro
O usuário recebe uma mensagem de erro e um link para a Central de Ajuda do app Mensagens para explicar por que o agente pode não estar disponível e ajudar o usuário a resolver o problema.
Isso ocorre se algum dos critérios de sucesso não for atendido e um número alternativo não for fornecido.
Criar o URL do agente
É possível criar URLs em dois formatos, conforme definido na GSMA RCC.07 v.14.0, seção 3.6.3.4.
Por motivos de segurança, esses formatos não oferecem sugestões predefinidas para o usuário no URL.
Formato 1: usar 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 do agente.&body=tell%20me%20about%20checking%20accounts: mensagem predefinida opcional que o usuário vai receber quando abrir a conversa do RBM com seu agente.
Limitação: esse formato não pode incluir um número de telefone alternativo. Se uma conversa de RBM não puder ser estabelecida, o usuário vai receber uma mensagem de erro.
Formato 2: usar um número de telefone e um ID de serviço
sms:+15012011657?service_id=bot%40botplatform.example.com&body=tell%20me%20about%20checking%20accounts
+15012011657: número de telefone no formato E.164 ou código curto válido associado ao agente.service_id=bot%40botplatform.example.com: ID de serviço exclusivo do seu agente.body=tell%20me%20about%20checking%20accounts: mensagem predefinida opcional que o usuário vai receber quando abrir a conversa do RBM com seu agente.
Mensagem pré-preenchida
Para oferecer uma experiência mais tranquila ao usuário, preencha 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 envio.
Para incluir uma mensagem pré-preenchida, use o parâmetro body no URL. O parâmetro de
corpo precisa ser codificado por URL. Por exemplo, os espaços precisam ser substituídos por
%20.
A mensagem precisa estar alinhada à intenção do usuário e às metas da sua marca. Confira
um exemplo de uma marca de bem-estar:
sms:bot%40botplatform.example.com?body=make%20an%20appointment. Quando o usuário
toca nesse link, o app de mensagens dele abre o chat com a mensagem
preenchida "Agendar uma consulta".
Práticas recomendadas
Ao incorporar códigos QR nos materiais da sua marca, sempre crie um link curto que redirecione os usuários para o URL do agente (por exemplo, https://short.link/abc123). Confira os benefícios de usar um link curto:
- Proteção para o futuro: é possível atualizar o URL do agente por trás do link curto, se necessário, sem precisar reimprimir materiais com um novo código QR.
- Substituição perfeita: evite que o usuário se confunda com o URL se ele for redirecionado para uma opção de substituição.