Os usuários podem iniciar uma conversa com seu agente usando um URL de link direto de SMS. O local em que você coloca o URL depende do seu caso de uso. Você pode colocar o URL em um e-mail, um site, um app ou um local físico, em qualquer lugar em que possa incorporar o URL como um botão, um link ou um 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.
- Seu 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 aceitam respostas sugeridas predefinidas ou ações sugeridas 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 não for possível estabelecer uma conversa de RBM, o usuário vai receber uma mensagem de erro.
Formato 2: usar 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 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.
Criador de links de SMS
Para criar um link de SMS e gerar um código QR para seu agente, insira as seguintes informações e clique em Criar link de SMS:
- ID do agente (obrigatório). Seu ID de agente pode ser encontrado na visão geral do agente no Console para desenvolvedores do Business Communications.
- Número de telefone alternativo (opcional).
- Rascunho de mensagem (opcional).