> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/comece-rapido/bot-templates/retail.md). # Varejo ## Visão geral do modelo Este template serve como base para criar um chatbot para o seu próprio negócio de varejo. Com este bot, seus usuários podem acompanhar seus pedidos, solicitar uma devolução, receber recomendações de compras, localizar a filial mais próxima do seu negócio e enviar feedback. Cada um desses casos de uso está contido em um fluxo separado. Continue lendo para aprender como você pode personalizar este template para a sua própria organização. ## Como personalizar este modelo {% hint style="info" %} Certifique-se sempre de [atualizar o NLP](https://docs.chatlayer.ai/understanding-users/natural-language-processing-nlp#updating-the-nlp) após carregar um modelo! {% endhint %} Este template usa dois serviços de terceiros: 1. Airtable, como um banco de dados para pedidos de clientes 2. Google Maps API, para encontrar a agência dos correios mais próxima Para permitir que seu bot interaja com esses serviços, você precisará de uma chave de API para cada um e configurá-las nos blocos de Ação onde o bot faz as chamadas de API. {% hint style="info" %} Está usando outro serviço para gerenciar seus pedidos de clientes? Você pode conectar qualquer tipo de banco de dados a este bot, desde que ele tenha uma API. Leia mais sobre nossas integrações de API [aqui](/chatlayer-documentation-pt-br/integrateandcode/custom-back-end-integrations/integrations-101.md). {% endhint %} Abaixo está uma visão geral de todos os blocos que você precisará personalizar neste template. Ele mostrará como configurar a conexão com as APIs do Airtable e do Google Maps, além de algumas outras dicas para personalizar este template para o seu negócio. Vamos começar! ### Fluxo: Geral #### Bloco: Introdução Esta é a primeira mensagem que o usuário vê. Modifique-a para dar ao seu bot uma mensagem de boas-vindas personalizada que combine com o tom e o estilo do seu negócio; além disso, certifique-se de substituir *Sneaky Trainers* pelo nome do seu próprio negócio. #### Bloco: Tópicos de suporte Este bloco mostra os tópicos com os quais o bot pode ajudar seus usuários. Se você adicionar casos de uso ao seu bot, pode adicionar aqui um botão para redirecionar para esse fluxo. #### Bloco: Não entendeu 1 e Não entendeu 2 Esses blocos usam um contador para acompanhar quantas vezes ele não entendeu a mensagem de um usuário. Se for a primeira vez que o bot não entender a mensagem, ele pedirá para reformulá-la; se for a segunda vez que o bot não entender, ele perguntará ao usuário se ele gostaria de entrar em contato de outra forma. Para mais informações sobre o contador de Não entendeu, confira o tutorial [aqui](https://docs.chatlayer.ai/tips-and-best-practices/not-understood-bot-dialog/not-understood-counter). Se você quiser aumentar o número de vezes que o bot pede ao usuário para reformular antes de oferecer a opção de entrar em contato, você pode aumentar o valor da `not_understood_counter` variável. Essa variável é definida como 1 na primeira condição no bloco *Não Entendido* . Você pode adicionar mensagens adicionais de não entendimento adicionando uma condição e vinculando um bloco do bot a ela ### Fluxo: Rastreamento Este fluxo permite que seus clientes verifiquem o status de entrega do pedido. O bot consultará a data de entrega em um banco de dados externo com base no número do pedido. Se o cliente não souber o número do pedido, o bot pedirá o nome e o endereço de e-mail e usará essas informações para consultar o status do pedido. #### Bloco: Pesquisar número do pedido Se o usuário informar o número do pedido, este bloco de Ação procura o registro correspondente ao número do pedido em um banco de dados externo. Por padrão, este template está configurado para consultar os pedidos em uma base do Airtable usando a função Search Record da integração com o [integração com o Airtable](/chatlayer-documentation-pt-br/integrateandcode/app-integrations/airtable.md). {% hint style="info" %} Já está usando outro serviço para gerenciar seus pedidos? Você pode conectar qualquer tipo de banco de dados a este bot, desde que ele tenha uma API. Leia mais sobre integrações [aqui](https://docs.chatlayer.ai/integrations/integrations-101). {% endhint %} Você precisará personalizar este bloco conectando-o à sua própria conta do Airtable e à sua própria base do Airtable, ou a outro banco de dados de sua escolha. No entanto, quando você tiver importado recentemente o template de Devoluções, ele será vinculado a [este Airtable](https://airtable.com/shrmwWUZNLMO79KCw). Os dados do pedido estão na *customerorders* tabela. ![](/files/c17be89dffb69eb671d89673952c0447fbc4e388) Sinta-se à vontade para usar esta base como exemplo para testes, mas certifique-se de conectar seu próprio banco de dados quando começar a usar o bot para o seu próprio negócio. Se você ainda não tiver uma conta do Airtable configurada no Chatlayer, você pode fazer isso clicando em Conectar nova conta e seguindo as etapas na janela pop-up. Para isso, você precisará da sua chave de API do Airtable, que você pode encontrar no seu [página da conta Airtable](https://airtable.com/account). ![](/files/984c561ace41c7c65b3f568aefefe65989894701) Depois de configurar sua própria base do Airtable, volte ao bloco no Chatlayer. No campo Base, substitua o ID da base de Airtable de exemplo pelo ID da sua própria base do Airtable. No campo Tabela, substitua o ID de exemplo pelo ID ou nome da tabela na sua própria base do Airtable onde você armazena os dados do pedido. Você pode encontrar o ID da base e os IDs das tabelas do seu Airtable [aqui](https://airtable.com/api). Se um registro correspondente ao número do pedido for encontrado no Airtable, o registro correspondente será salvo como um objeto nos dados de sessão do seu chatbot. Você pode chamar dados desse objeto nos blocos do seu bot com o seguinte formato:`{apps.airtable.read_record.(AIRTABLE_FIELD_NAME)}`. Por exemplo, o *bloco Status de Entrega* mostra a data de entrega do pedido usando `{apps.airtable.read_record.DeliveryDate}`. Você pode encontrar mais informações sobre como integrar o Airtable ao seu chatbot [aqui](https://docs.chatlayer.ai/integrations/app-integrations/airtable-app-integration). #### Bloco: Pesquisar e-mail no banco de dados Este bloco de Ação é quase idêntico ao bloco Pesquisar número do pedido no banco de dados, mas em vez disso usa a variável `email_address` para procurar na coluna *email* do Airtable para encontrar o registro do usuário. Você precisará personalizar os mesmos campos que no bloco Pesquisar número do pedido no banco de dados. ### Fluxo: Devoluções Este fluxo permite que seus usuários solicitem a devolução de um item que eles encomendaram. #### Bloco: Localizar itens encomendados Depois que o usuário informar seu nome e endereço de e-mail, este bloco de Ação procura no Airtable o registro correspondente ao endereço de e-mail dele. Como no fluxo de *Rastreamento* você precisará personalizar este bloco conectando-o à sua própria conta do Airtable e à sua própria base do Airtable. #### Bloco: Selecionar item de devolução Este bloco mostra ao usuário, em um carrossel, os itens que ele pode devolver. Os nomes e as imagens dos itens são recuperados do Airtable. Se você precisar mostrar mais itens que seus usuários podem devolver, você pode adicionar colunas extras para itens e links para suas imagens no Airtable e adicionar mais itens ao carrossel no bloco do bot. ### Fluxo: Feedback Com este fluxo, os usuários podem dar feedback sobre a experiência de uso do bot. Se o usuário indicar que o bot não conseguiu ajudá-lo, o bot perguntará qual caso de uso não funcionou para ele e pedirá que descreva com mais detalhes exatamente o que deu errado. #### Bloco: Feedback para o Airtable Depois que o usuário der seu feedback, este bloco de Ação grava duas variáveis, `feedback` e `detailed_feedback`, no Airtable. Na sua base do Airtable, você precisará de uma tabela com uma coluna para cada uma das duas variáveis. Na conta do Airtable, selecione sua própria conta do Airtable, ou conecte uma nova se ainda não tiver uma. No campo Base, substitua o ID fornecido pelo ID da sua própria base do Airtable. No campo Tabela, substitua o ID fornecido pelo ID ou nome da tabela na sua própria base do Airtable onde você deseja armazenar os dados de feedback. Se sua própria base do Airtable usar nomes de coluna diferentes, você também precisará substituir feedback e detailed\_feedback no campo Record pelos nomes das colunas na sua própria base do Airtable. ### Fluxo: Localizador de lojas Com este fluxo, seus usuários podem descobrir qual loja de varejo do seu negócio fica mais próxima deles. A funcionalidade deste fluxo é a mesma do template Encontrar local mais próximo. Para saber como personalizar este fluxo, você pode consultar o tutorial desse template [aqui](https://docs.chatlayer.ai/tips-and-best-practices/bot-templates/pre-built-flow-templates/template-find-nearest-location). ### Fluxo: Localizador de agência dos correios A partir do bloco Preparar devolução no fluxo Devoluções, o usuário pode navegar para este fluxo. Assim como o fluxo Localizador de lojas, este fluxo funciona da mesma forma que o template Encontrar local mais próximo. Para saber como personalizar este fluxo, você pode consultar o tutorial desse template [aqui](https://docs.chatlayer.ai/tips-and-best-practices/bot-templates/pre-built-flow-templates/template-find-nearest-location). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/comece-rapido/bot-templates/retail.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.