Como publicar um agente e compartilhar com os clientes?

Rascunho e publicado

Todo agente é “Rascunho” ou “Publicado”. Novos agentes, agentes adicionados de modelos e cópias feitas com “Duplicar agente” começam como rascunho. O agente de loja criado automaticamente ao conectar sua loja começa publicado, como primeira versão (v1).

Rascunhos não ficam abertos aos visitantes: o link público, o chat incorporado ao seu site e o agente da loja não funcionam. Só membros do seu espaço de trabalho podem abrir o link de um rascunho; você também pode testar um rascunho com “Prévia”.

Em um agente publicado, o que você edita no editor é o rascunho; os visitantes veem a última versão publicada. “Salvar” salva sua alteração só no rascunho e um selo “Alterações não publicadas” aparece no cabeçalho; a alteração chega aos visitantes quando você clica em “Publicar”.

“Despublicar” volta o agente a rascunho e interrompe tudo isso; será preciso confirmar primeiro. O botão fica no menu da seta ao lado de “Publicar”, no cabeçalho do editor, e no fim da janela “Versões” (aberta pelo menu de três pontos).

Testar e publicar

1. Clique em “Prévia” no editor. O agente é salvo e o rascunho abre em uma nova aba.
2. Percorra o agente do início ao fim como um visitante; confira idiomas e dispositivos diferentes.
3. Se encontrar um problema, volte ao editor e corrija. O ideal é eliminar os avisos da tela (“Problemas em {n} etapas”) antes de publicar.
4. Quando estiver pronto, clique em “Publicar”, no canto superior direito do editor. Na janela, você pode adicionar uma “Nota da versão” (por exemplo, Corrigida a pergunta do preço; até 500 caracteres); a nota aparece na lista “Versões”.
5. Confirme. O agente é salvo primeiro e depois o rascunho salvo entra no ar como uma nova versão numerada (v1, v2, …). Se o rascunho for igual à versão no ar, nenhuma nova versão é criada.

Na página “Agentes”, você também pode publicar um rascunho pelo menu de três pontos da linha com “Publicar”; isso publica o agente como foi salvo por último.

Na primeira vez que você publica um agente, abre uma janela com o link dele e o código para adicioná-lo ao seu site. Essa janela não aparece em espaços de trabalho com uma loja conectada.

A prévia mostra o rascunho e não muda o agente no ar, então em um agente publicado você pode testar até uma grande alteração antes que os visitantes a vejam. Etapas “Subfluxo” em uma prévia rodam com as versões no ar desses agentes.

Versões e voltar a uma anterior

“Versões”, aberto pelo menu de três pontos no canto superior direito do editor, lista todas as versões do agente: o número, quem publicou e quando, e a nota da versão. A versão que os visitantes veem agora tem a marca “Ativa”; se o agente estiver despublicado, a última versão publicada tem a marca “Última publicação”. Cada versão tem:

• “O que mudou”: compara a versão com a anterior, mostrando etapas adicionadas, alteradas e removidas e outras mudanças (etapa inicial, idioma do agente, traduções, avatar, aparência, avaliação, posições das etapas na tela).
• “Ativar”: para reverter. Novos visitantes veem essa versão; seu rascunho não muda. Em um agente despublicado, isso também publica o agente de novo com essa versão.
• “Carregar no rascunho”: o conteúdo da versão substitui o rascunho; alterações não salvas e não publicadas são perdidas. A versão no ar não muda; clique depois em “Publicar” para mostrá-la aos visitantes.

Se o rascunho tiver alterações não publicadas, uma caixa no topo da janela avisa: “O que mudou” mostra a diferença em relação à versão no ar, e “Descartar alterações” volta o rascunho à versão no ar.

Uma versão guarda as etapas do fluxo, a etapa inicial, o idioma principal, as traduções, o avatar, a aparência, a avaliação e a configuração de análise de sentimento. Nome, descrição e ícone do agente e as “Configurações de medição” não fazem parte de uma versão; valem assim que você salva.

Quando você publica uma nova versão ou ativa uma anterior, as conversas em andamento terminam na versão em que começaram; novos visitantes recebem a nova versão.

Publicar, “Ativar”, “Carregar no rascunho”, “Descartar alterações” e “Despublicar” estão disponíveis para o proprietário e os administradores; todos podem ver as versões e o que mudou. Publicações e reversões também aparecem no registro de auditoria como “Nova versão do agente publicada” e “Versão ativa do agente alterada”.

O link público

Todo agente tem um link público. Na página “Agentes”, abra o menu de três pontos na linha do agente e escolha “Copiar link público”; o link é copiado para a área de transferência. O link só funciona em um agente publicado; em um rascunho a opção fica desativada. Coloque-o em um botão no seu site, em um e-mail, em um QR code ou em uma publicação nas redes sociais.

• Quando um visitante abre o link, a conversa começa no navegador, sem precisar de app; o avatar fala e o visitante responde digitando ou pelo microfone.
• Fixe o idioma com um prefixo depois do domínio: /en/ ou /ar/ (por exemplo, …/en/<id do agente>). Sem prefixo, o idioma é escolhido nesta ordem: o idioma que o visitante escolheu antes; o idioma do navegador, se for um dos idiomas do agente; inglês, se o agente tiver; senão, o idioma principal do agente. Veja Idiomas e tradução.
• Adicione tags utm para diferenciar campanhas (por exemplo, ?utm_source=instagram&utm_campaign=spring). Você vê os resultados na aba Análise.

Se você despublicar ou excluir o agente, o link para de funcionar. O link é público, então leve isso em conta em agentes que tratam informações sensíveis. Páginas de agente ficam ocultas para mecanismos de busca.

Adicionar ao seu site

Para adicionar o agente ao seu próprio site como um botão que abre no canto, escolha “Adicionar ao site” pela seta ao lado de “Publicar” no editor de fluxos, ou pelo menu de três pontos na linha do agente na página “Agentes”. Isso está disponível em todos os planos. Se o agente for um rascunho, você ainda recebe o código, mas o agente aparece fechado no seu site até você publicar.

1. Em “Escolha como aparece”, selecione “Canto inferior” ou “Janela grande”: “Canto inferior” adiciona um botão que abre uma caixa de chat, e “Janela grande” abre no meio da tela.
2. Em “Autorize seus sites”, digite seu domínio (por exemplo, example.com) e clique em “Adicionar”. As versões com e sem www são adicionadas; para todos os subdomínios, informe *.example.com. Os sites são compartilhados por todos os seus agentes, então você só os adiciona uma vez.
3. O código aparece depois que você adiciona pelo menos um site. Clique em “Copiar código” e cole uma vez no modelo do seu site, logo antes da tag </body>. O agente aparece em todas as páginas, e a conversa continua enquanto o visitante muda de página.

O lugar onde colar o código depende da plataforma do seu site. Guias passo a passo: WordPress, Wix, Squarespace, Webflow, Weebly, Joomla, Google Tag Manager.

O agente só abre nos sites autorizados; quem copiar o código para outro site nem verá o botão do agente lá. Se seu site tiver outro domínio, adicione-o também. Você vê e remove seus sites em “Conta” › “Negócio” › “Seus sites” no menu; em um site removido, o agente para de abrir em até meio minuto. “Adicionar ao site” e remover sites estão disponíveis só para o proprietário e os administradores.

Se você tem uma loja, as integrações são mais fáceis: ao conectar uma loja Shopify, WooCommerce ou Magento, o agente é adicionado à vitrine e funciona com o agente da própria loja. Na Shopify, por exemplo, você ativa o agente em App embeds no editor de temas, e “Editar o agente da loja” na página da loja abre esse agente no editor.

Para detalhes, veja os artigos de lojas: Conectar a Shopify, Conectar o WooCommerce, Conectar o Magento.

Perguntas comuns

• Por que não vejo minha alteração no link? Talvez você tenha salvado, mas não publicado. Se o cabeçalho do editor mostrar o selo “Alterações não publicadas”, clique em “Publicar” e atualize a página.
• Por que os visitantes não conseguem abrir o link? O agente pode ser um rascunho. Confira o selo de status no editor ou na lista e publique o agente com “Publicar”.
• Como volto a uma versão anterior? Abra “Versões” no menu de três pontos e clique em “Ativar” na versão desejada. Novos visitantes veem essa versão; seu rascunho continua como está.
• A prévia reaproveita meu teste anterior? Não. Cada prévia começa uma sessão nova, então use “Prévia” sempre que quiser um teste limpo.
• Quem pode publicar? O proprietário e os administradores; só eles também podem despublicar ou ativar uma versão anterior. Usuários de Suporte e Observador podem copiar o link de um agente publicado e abrir a prévia e as versões, mas não podem salvar alterações.