RCS Agent Builder [BETA]

O Vonage RCS Agent Builder oferece um processo simplificado para o gerenciamento de agentes RCS (Rich Communication Services). Desenvolvedores e equipes de operações podem gerenciar campanhas de forma eficaz em diferentes operadoras e regiões, centralizando a configuração, a verificação, a implantação e o monitoramento dos agentes RCS:

• Gerenciamento centralizado do painel de controle - Crie, configure e monitore agentes por meio de uma plataforma unificada. Acesse todas as ferramentas de gerenciamento em um único local para simplificar as operações.
• Verificação automatizada de agentes - Utilize o processo de verificação do RCS Agent Builder para autenticar a identidade da sua empresa. Agentes verificados aumentam a credibilidade das mensagens e impedem o acesso não autorizado.
• Implantação direta de porta-aviões - Implemente agentes em operadoras e países selecionados diretamente da interface de gerenciamento. Verifique se a configuração está correta e se há conformidade antes do lançamento.
• Tratamento detalhado de erros - A plataforma fornece códigos de erro detalhados para ajudar a identificar e resolver problemas durante a configuração, verificação ou implantação.
• Fluxos de integração nos EUA e no exterior - O Agent Builder agora oferece uma experiência de integração diferenciada para agentes dos EUA em comparação com agentes internacionais (INTL), com a seleção do país/operadora exibida mais cedo no assistente.

Como usar o RCS Agent Builder

O processo de gerenciamento de agentes do RCS segue uma sequência clara, desde a criação do agente até a implantação e o monitoramento em tempo real.

Para começar, Acesse o RCS Agent Builder.
Então, Criar e configurar um agente:
Passo 1: Criar um novo agente RCS
Etapa 2: Seleção de operadora e país
Etapa 3: Definição de design visual
Etapa 4: Configurar as definições do agente e do aplicativo
Etapa 5: Teste o agente
Etapa 6: Verifique a marca
Passo 7: Enviar detalhes sobre os requisitos da transportadora
Passo 8: Revisar e enviar o agente

Acesse o RCS Agent Builder

Você pode acessar o RCS Agent Builder clicando no link abaixo:

• RCS Agent Builder

ou acessando-o a partir do Painel de Controle da API da Vonage:

1. Faça login no Painel de Controle da API da Vonage.
2. Acesse Mensagens > Construtor de Agentes RCS. A página “RCS Messaging” é exibida. Nessa página inicial, você pode explorar os recursos do RCS, consultar os preços e acessar a documentação para desenvolvedores.
   Se o RCS não estiver ativado na sua conta, você verá um botão “Fale conosco” no canto superior direito:
   

If RCS is enabled for your account, you will see the button to Build a new RCS agent:

3. Para começar a criar um novo agente, localize e clique no Criar um novo agente RCS botão.

Criar e configurar um agente

Configure um novo agente RCS pelo painel da API da Vonage. Esse processo envolve o registro do agente, a definição de sua identidade visual e a configuração das opções do aplicativo.

Criar um novo agente RCS

1. No formulário “Criar um agente RCS”, preencha todos os campos obrigatórios:

Detalhes da marca

Agora está disponível uma janela modal de “Detalhes da Marca” para coletar informações adicionais de registro da empresa necessárias para os envios às operadoras. São coletados os seguintes campos:

2. Clique Salvar e continuar para avançar para a próxima etapa.

Seleção de operadora e país

No Seleção de operadora e país Nesta etapa, use a lista suspensa para selecionar as operadoras por país.

1. Adicione cada operadora desejada e certifique-se de cobrir todas as regiões para as quais você planeja enviar mensagens RCS.
2. Cada país pode ter requisitos específicos que serão apresentados nas etapas seguintes.
   • Agentes dos EUA: Apenas as operadoras dos Estados Unidos (AT&T, T-Mobile, Verizon) estão disponíveis para seleção. A seleção de vários países não é compatível para agentes dos EUA.
   • Agentes da INTL: É possível selecionar vários países e operadoras.

3. Clique Salvar e continuar para continuar.

Definição de design visual

1. Na seção “Design visual”, forneça as informações necessárias elementos de identidade visual:

Exposição e identidade visual:

Dados de contato:

Informações legais:

2. Visualize como o agente aparecerá na interface de mensagens.
3. Clique Salvar e continuar para seguir em frente.

Configurar as definições do agente e do aplicativo

Nesta seção, configure as conexões necessárias para que seu agente possa enviar e receber atualizações, acionar eventos e interagir com outras Applications.

1. Execute uma das seguintes ações:

• Selecione um aplicativo existente na lista.
• Clique Criar um novo aplicativo para registrar um novo.

2. Assim que a configuração estiver concluída, clique em Salvar e continuar.

Teste o agente

Após configurar seu agente, realize testes para garantir que ele esteja pronto para implantação.

Adicionar dispositivos de teste

Antes de adicionar seu dispositivo de teste, certifique-se de que ele esteja configurado para testes de RCS:

• Para verificar se o RCS é compatível com o seu dispositivo, consulte Dispositivos compatíveis com RCS.
• Ativar os recursos de bate-papo do RCS: Certifique-se de que o RCS esteja ativado no seu dispositivo de teste antes de prosseguir:
  • Android: Abra o aplicativo Mensagens, acesse Configurações e verifique se os recursos de bate-papo (RCS) estão ativados e conectados.
  • iPhone (iOS 18 ou superior): Acesse Ajustes > Mensagens > Mensagens RCS e ative a opção para habilitar os recursos do RCS. Observe que o RCS no iPhone só está disponível por meio de operadoras específicas.

Veja Como posso verificar se o RCS está ativo no meu aparelho? para obter instruções mais detalhadas.

Depois que seu dispositivo estiver configurado, você poderá adicioná-lo como dispositivo de teste para validar a configuração do seu agente em um ambiente controlado:

1. Na etapa “Testar mensagens”, insira um ou mais números de telefone (em formato E.164) que estão associados aos dispositivos de teste.

2. Responda à solicitação do testador do RBM (apenas para provedores do Google RBM): Você poderá receber um convite para participar do programa de testadores do Google RBM por SMS assim que o número for adicionado à lista de permissões. Se for solicitado, clique ou toque em “Tornar-me um testador” e aguarde a confirmação antes de prosseguir para a próxima etapa.
3. Clique em “Enviar mensagem de teste” para enviar mensagens de teste e verificar o funcionamento antes do lançamento.

4. Depois de adicionar os dispositivos de teste necessários, clique em Salvar e continuar para dar continuidade ao processo de verificação.

Verifique a marca

A verificação do agente é necessária para confirmar a identidade da sua empresa e permitir que a Vonage atue em seu nome. Após a verificação, o agente passa a ter acesso aos recursos de mensagens do RBM e ao status de remetente confiável. Você deve fornecer as informações de contato de um funcionário verificado da marca que possa atestar sua autoridade e a exatidão das informações enviadas sobre o agente.

A verificação da marca deve ser concluída antes de enviar seu agente para o lançamento inicial em qualquer operadora. A verificação é necessária apenas uma vez por agente, independentemente do número de operadoras nas quais o agente for lançado ou se esses lançamentos forem gerenciados pelo Google ou diretamente pelas operadoras. Uma vez aprovado, seu agente aparece e funciona para usuários com o RBM habilitado nas redes aprovadas.

No formulário apresentado a seguir:

1. Forneça as informações de contato de um representante autorizado que possa confirmar a identidade da sua organização. Essa pessoa deve ter autoridade para verificar os dados do agente e aprovar a Vonage como prestadora do serviço RCS. Preencha o nome completo do representante, o endereço de e-mail corporativo, o número de telefone e o cargo.
2. Clique Verify o endereço de e-mail, salve e continue para iniciar a verificação e salvar.

Entendendo a verificação de marca

Enviar detalhes sobre os requisitos da transportadora

É necessária a aprovação da operadora antes que seu agente possa ser colocado em operação em ambientes de produção.

1. No Requisitos das operadoras de telefonia móvel Nesta etapa, forneça todas as informações necessárias.
2. Certifique-se de que as informações estejam de acordo com o perfil comercial associado ao agente.
3. Clique Salvar e prosseguir para a etapa final.

Outros pontos de contato

Inclua o nome completo, o cargo e o endereço de e-mail do principal ponto de contato da marca para a integração de agentes.

Gerenciamento de consentimento

A seção “Gerenciamento de Consentimento” garante que todas as mensagens enviadas por meio do seu agente RCS estejam em conformidade com as regulamentações do setor, as políticas do Google RBM e as expectativas dos clientes em relação à privacidade.

Detalhes da adesão

Detalhes sobre o cancelamento de inscrição

Fluxos de engajamento

A seção “Fluxos de engajamento” define quando seu agente RCS inicia a comunicação com os usuários e como os usuários interagem com suas mensagens. Fornecer essas informações garante transparência, atende aos requisitos de aprovação do Google RBM e ajuda a confirmar que seu comportamento de envio de mensagens é consistente, previsível e alinhado às expectativas dos usuários.

Esta seção está dividida em duas partes: Descrição do gatilho e Descrição da interação.

Descrição do gatilho

Descrição da interação

Selecione todos os tipos de interação compatíveis (respostas simples, botões/ações rápidas, autenticação, gerenciamento de pedidos, gerenciamento de agendamentos, pagamentos, atendimento ao cliente, navegação por produtos, pesquisas, compartilhamento de localização, compartilhamento de arquivos, etc.).

Campos específicos dos EUA — exibidos apenas quando os Estados Unidos forem selecionados

Os seguintes campos adicionais são obrigatórios para envios por transportadoras dos EUA e são exibidos dinamicamente quando os Estados Unidos são selecionados como país de destino:

Acesso para agentes e demonstração

A seção “Acesso ao agente” descreve como os usuários finais encontram seu agente RCS e iniciam conversas. Essas informações são essenciais para que o Google RBM e as operadoras parceiras validem a acessibilidade, confirmem os fluxos de integração e garantam que os usuários possam iniciar e gerenciar facilmente as interações com sua empresa. Detalhes precisos ajudam os revisores a compreender seus pontos de entrada e a verificar se seus métodos de acesso estão em conformidade com as normas e são fáceis de usar.

Esta seção aborda como os usuários entram em contato com o seu agente, as instruções fornecidas a eles e os materiais de demonstração obrigatórios necessários para a aprovação.

Métodos de acesso do agente

Selecione todos os pontos de acesso relevantes pelos quais os usuários podem entrar na sua experiência RCS:

• Mensagens enviadas pela empresa (pré-selecionadas)
• Leitura de código QR
• Envio de mensagens de texto por código curto
• Integração de sites
• Integração de aplicativos móveis
• Links para redes sociais
• Links da campanha por e-mail
• Perfil do Google para Empresas
• Indicações do atendimento ao cliente
• Outros (método de acesso personalizado)

Instruções fornecidas aos usuários

Forneça quaisquer orientações exibidas aos usuários para ajudá-los a iniciar uma conversa (por exemplo: “Escaneie este código QR para conversar conosco pelo RCS.”, “Toque no botão ‘Envie uma mensagem’ em nosso site.”).

Mídia de demonstração

Clique Salvar e siga para a etapa final.

Revisar e enviar o agente

Antes de enviar seu agente RCS para provisionamento, verifique todos os detalhes para garantir que estejam corretos e completos.

1. Verifique cuidadosamente todos os detalhes de configuração, da empresa e da operadora.

2. Você deve confirmar que compreendeu as taxas de instalação aplicáveis antes do envio.
3. Depois de ler e aceitar os termos, clique em Confirmar e enviar para enviar a configuração do agente para o processamento final.

Gerenciar e monitorar agentes

Após o envio, você poderá continuar gerenciando seus agentes RCS por meio do Meus agentes seção do painel da API da Vonage.

1. Acesse “Meus agentes” para visualizar o status dos agentes enviados, acompanhar o andamento e acessar os detalhes de configuração.
2. Use o painel para acompanhar a verificação, a aprovação da operadora e o status do lançamento.
3. O Nome do agente e ID do remetente são exibidos no cabeçalho da página ao longo do assistente para ajudar você a identificar em qual agente está trabalhando — o que é particularmente útil ao gerenciar vários agentes simultaneamente.

Regras de edição de agentes:

• Se o agente ainda não tiver sido encaminhado às transportadoras: Você pode atualizar os detalhes do agente diretamente no portal — exceto atributos essenciais, como categoria de cobrança, região de hospedagem, caso de uso, RCS Sender ID ou outros campos de configuração críticos.

• Se o agente já tiver sido enviado às transportadoras: Não é possível editar o agente pelo portal. Entre em contato rbm-support@vonage.com para solicitar modificações. Esse processo envolve: (1) retirar o agente da(s) operadora(s), (2) aplicar as alterações solicitadas e (3) reenviar o agente para aprovação de lançamento pela operadora.

Detalhes do status do agente:
Após o envio às operadoras, o agente aparecerá em um Em espera estado. Com base na análise da operadora, o status pode mudar para Lançado ou Rejeitado.

Agentes RCS legados: Os agentes RCS legados criados por meio de APIs foram sincronizados com o painel para fins de visibilidade. Eles aparecem em somente leitura (não editável) modo em que são exibidos detalhes limitados.

Leitura complementar

RCS Brand and Agent Builder utilizando a API do Channel Manager