O Business Messages oferece uma interface da Web chamada Console do desenvolvedor de comunicações comerciais. Use este console para criar, gerenciar e iniciar agentes.
O Business Communications Developer Console é diferente do Google Cloud Platform. (GCP). Use o Console para desenvolvedores do Business Communications para gerenciar agentes do Business Messages, enquanto usa o Console do GCP para gerenciar configurações específicas do GCP (por exemplo, faturamento e APIs) e outros recursos do GCP.
É possível usar o Business Communications Developer Console para criar e gerenciar agentes, mas também é possível usar a API Business Communications para criar e gerenciar agentes em cenários avançados, como uma integração em seu próprio produto.
Os guias de início rápido e de instruções orientam você nas etapas de uso do console e das APIs. Esta página fornece um resumo de alto nível do layout da interface do usuário e para que o console é usado.
Como usar o console
O console é usado para criar, gerenciar, atualizar, verificar e lançar seus agentes. Com ela, você pode
- Defina o webhook e outras configurações da conta do parceiro.
- Criar e gerenciar agentes, que contêm todas as propriedades e dados que definem a representação conversacional de uma marca.
- Defina as configurações do agente não locais e a disponibilidade da mensagem.
- Criar e gerenciar locais que representam os locais físicos de uma empresa.
- Recupere os URLs de teste do agente e local para ver como uma conversa com o agente aparece para os usuários.
- Integre ao Dialogflow para responder a perguntas frequentes.
- Verifique seu agente e locais.
- Inicie o agente e os locais.
Tela inicial do console
Ao carregar o console inicialmente, você verá a tela de seleção do agente. Nessa página, o link Configurações da conta do parceiro abre a página de configurações da conta do seu parceiro.
Além disso, a tela inicial é usada para:
- Selecione um agente.
- Crie novos agentes.
- Classificar agentes.
- Filtrar agentes por conta do parceiro.
Por padrão, os agentes são exibidos na visualização de card. Os agentes são ordenados pela data da última atualização. Para alterar para uma visualização em lista, use as opções Ver como à direita. Com a visualização em lista, os agentes podem ser classificados por nome, tipo, status e data da última atualização.
Se você tiver várias contas de parceiros, haverá um seletor suspenso de contas de parceiros em que você pode filtrar a seleção de agentes por uma conta de parceiro.
Configurações da conta
Na página "Configurações", é possível atualizar:
- Nome da empresa
- Nome de exibição
- Ponto de contato técnico
- Webhook
No painel de navegação lateral, é possível acessar o gerenciamento de marcas e usuários, bem como as contas de serviço.
Gestão da marca
Uma marca é uma empresa, organização ou grupo. Um agente é a representação conversacional de uma marca.
Use esta página para adicionar, editar e remover marcas. Remover uma marca também exclui todos os agentes associados. Não será possível remover uma marca se ela estiver associada a um agente lançado.
Gerenciamento de usuários
Use esta página para adicionar e remover o acesso às suas contas de parceiro registradas. Para alternar entre contas, use o menu suspenso na barra de navegação superior.
Adicionar um usuário
Para adicionar um usuário, insira o endereço de e-mail dele no campo de entrada e selecione o papel.
Os novos usuários podem ter funções de Administrador ou Leitor. Um papel de gerente tem acesso a todas as funcionalidades no console, enquanto um papel de leitor fornece acesso somente leitura a informações de agente e local.
Quando você adiciona um novo usuário, ele recebe um e-mail informando que agora tem acesso à conta do parceiro.
O endereço de e-mail que registrou a conta do parceiro originalmente tem um papel de Proprietário.
Remover um usuário
Para remover um usuário, faça o seguinte:
- Encontre o usuário que você quer remover.
- Clique no botão .
- Selecione Remover usuário.
- Confirme a remoção.
O usuário removido recebe uma notificação por e-mail informando que ele não tem mais acesso à conta.
Não é possível remover um usuário com função de proprietário. Para alterar ou remover um proprietário, entre em contato com o suporte.
Alterar uma função do usuário
Para atualizar a função de um usuário:
- Encontre o usuário que você quer atualizar.
- Clique no botão .
- Selecione Editar função.
- Escolha uma nova função na lista suspensa.
- Clique em Salvar.
Contas de serviço
Ao fazer chamadas para as APIs Business Communications e Business Messages, você autentica as chamadas com uma chave de conta de serviço. As chaves da conta de serviço permitem criar e gerenciar marcas, agentes e locais, bem como enviar mensagens e solicitações como seu agente.
Para gerar uma chave da conta de serviço, selecione Contas de serviço na navegação lateral. O Console do GCP para o projeto associado à conta de parceiro selecionada será aberto.
Para criar uma conta de serviço e uma chave, faça o seguinte:
- Clique em Criar conta de serviço.
- Em Nome da conta de serviço, digite o nome do agente e clique em Criar.
- Clique em Concluído.
- Localize a nova conta de serviço na tabela e clique em > Criar chave.
- Escolha JSON e clique em Criar.
O navegador fará o download da chave da conta de serviço.
Seleção de agente
Depois de selecionar um agente, você será direcionado à página "Visão geral" do agente selecionado.
A visão geral exibe:
- Nome da marca
- Nome do agente
- A conta do parceiro em que o agente foi criado
- O ID da marca
- O ID do agente
- URLs de teste do agente que permitem ver como uma conversa com esse agente aparece para os usuários e oferecem a oportunidade de verificar sua infraestrutura de mensagens
- Status de verificação do agente
- Uma visualização do agente
- Locais associados ao agente
- Links para a documentação relevante
A navegação à esquerda permite acessar:
- Informações do agente
- Locais
- Integrações
- Perguntas da pesquisa
- Registros de depuração
- Verificação
- Lançamento
- Painel de métricas
- Links para a documentação relevante
Informações do agente
Use a página de informações do agente para atualizar as propriedades dele.
A página é dividida em duas colunas. Use os campos de entrada na coluna esquerda para atualizar os campos do agente, como nome, logotipo, mensagem de boas-vindas, inicializadores de conversa e propriedades para pontos de entrada de local e não locais. Após iniciar o agente, não será possível atualizar alguns campos, como Nome do agente e Logotipo.
Use a coluna à direita para ver os URLs de teste do agente e visualizar como o agente será exibido no dispositivo do usuário.
Gerenciamento de locais
Use esta página para adicionar locais, recuperar URLs de teste para locais da empresa e verificar locais depois de verificar seu agente.
Integrações
Use esta página para integrar ao Dialogflow e configurar um bot para responder a perguntas frequentes.
Pesquisas
Use esta página para personalizar a pesquisa do cliente do seu agente.
Registros
Use esta página para depurar problemas na entrega de mensagens. Os registros ficam disponíveis por 14 dias. Filtre por código da conversa, código da mensagem, carimbo de data/hora, direção ou status para encontrar os registros relevantes para os problemas do usuário. Nessa página, você também pode verificar se está enviando mensagens inválidas acidentalmente.
Os registros incluem o payload da mensagem, exceto campos confidenciais editados, como o conteúdo de texto de mensagens. As mensagens com falha e rejeitadas têm mais detalhes sobre o erro para ajudar na depuração.
Alguns eventos, como indicadores de digitação, não têm confirmações de entrega, e o status deles é exibido como "Enviado".
Verificação
Use esta página para enviar seu agente para verificação.
Lançar
Use esta página para iniciar o agente para pontos de entrada de local e não locais, bem como iniciar locais individuais.
