Bibliotecas blocos - Habilidades prontas

Índice:

1. Introdução
2. Conceitos Básicos
3. Packed Agents
   1. Agente de FAQ
   2. Agente de Aquisição

Introdução

A biblioteca de blocos foi criada para facilitar o dia a dia de quem precisa construir um contato inteligente sem ter um profundo domínio técnico e precisa de velocidade para publicar. Com ela, será possível aplicar tanto habilidades determinísticas básicas como Onboarding, LGPD, Inatividade, Cascata de validação, Algo mais, Finalização e CSAT quanto estruturas utilizando os agentes Studio.

Conceitos básicos

Para garantir o bom funcionamento, os blocos prontos são estruturados em uma arquitetura de roteador, com cada conjunto alocado em um Studio específico. Isso torna a manutenção e a evolução do fluxo muito mais fáceis.

É possível utilizar os blocos prontos dentro de um único Studio? 

Sim, é possível, mas a alta interconexão entre os blocos torna a manutenção complexa. Editar uma parte específica exige entender e revisar toda a estrutura conectada, gerando um esforço e tempo alto para configuração.

Visão macro

Antes de utilizar a biblioteca, é importante definir a estrutura conversacional e a interação entre suas partes. Uma conversa deve ter início, meio e fim orientados a um objetivo principal. Na visão macro, muito semelhante aos fluxogramas BPMN, é necessário mapear os caminhos, os gatilhos de decisão e criar símbolos que representam cada evento do fluxo de conversa.

A biblioteca

A biblioteca de blocos está organizada em Habilidades, Agentes e Casos de Uso:

• Habilidade: Conjunto de blocos padrão com uma finalidade específica dentro do fluxo do contato inteligente.
• Agente: Composto por um bloco de agente ou um conjunto de bloco de agente + blocos padrões. Os blocos de agente são fundamentais para atingir objetivos específicos no contato inteligente.
• Caso de Uso: Combinação de habilidades e agentes projetada para atender um objetivo especifico dentro da jornada do usuário.

Cada recurso possui uma tag de identificação dentro da biblioteca e pode ser localizado rapidamente pela barra de busca, conforme ilustrado abaixo:

Os blocos prontos

Habilidades

Onboarding

Recepciona o usuário com saudações de boas-vindas ou de retorno, verifica o status de consentimento da LGPD e orienta sobre como utilizar o serviço.

Bloco | [LOGIC] A.1.0.0 Validação de entrada Utiliza-se a variável {isNewUser} nas condições de saída para identificar se é o primeiro contato do usuário, direcionando-o ao bloco correspondente. Há uma ação de registro de eventos para identificar a origem do usuário.   Bloco | [MSG] A.2.0.0 Sim validação Exibe a mensagem de boas-vindas ao usuário e executa o registro de eventos (origem e exibição), além de definir a variável {isNewUser}. A condição de saída é ativada apenas se há resposta do usuário.   Bloco | [MSG] A.3.0.0 Não validação Exibe mensagem de retorno para o usuário e executa o registro de eventos (origem e exibição). A condição de saída é ativada apenas se há resposta do usuário.   Bloco | [LOGIC]LP.1.0.0 - LGPD Validação Verifica se o usuário já aceitou os termos da LGPD através da variável {userAceptedPrivacyPolicy}. O fluxo valida se a variável existe e se o valor corresponde ao aceite (Sim/Não). As ações incluem o registro de eventos de origem, o status da validação da LGPD.   Bloco | REDIRECT SERVICE Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.

LGPD:

Apresenta uma breve explicação sobre a LGPD e solicita o consentimento do usuário para o tratamento de dados sensíveis pelo Contato Inteligente.

Bloco | [START]  Gerencia a entrada na habilidade validando a variável {input.content@redirectId} e encaminhando o usuário ao bloco correspondente via ID.   Bloco | [INPUT] LP.2.0.0 - LGPD Apresenta as informações sobre a LGPD, incluindo link para detalhes e um menu de opções para o usuário aceitar, recusar ou solicitar mais informações.   Bloco | [LOGIC] LP.2.0.0 - [Não] Aceite LGPD Faz a validação através de um script da opção escolhida.    Bloco | GOTO LP.2.0.0 - Service Name Executa o redirecionamento para outro serviço ou habilidade por meio de saída padrão caso o usuário tenha aceitado os termos.   Bloco | [INPUT] LP.3.0.0 - Não concorda com LGPD Caso o usuário não aceite os termos, é exibida uma mensagem reforçando a necessidade do aceite para prosseguir. O bloco reapresenta as opções anteriores: "Aceitar", '"Não aceitar" e "Saber mais".   Bloco | LP.4.0.0 - Saber Mais É exibido um detalhamento sobre a LGPD.   Bloco | [LOGIC] LP.3.0.0 - Não concorda com LGPD Faz a validação através de um script da opção escolhida.   Bloco | GOTO LP.3.0.0 - Service Name Executa o redirecionamento para outro serviço ou habilidade por meio de saída padrão caso o usuário tenha aceitado os termos.   Bloco | REDIRECT SERVICE Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.   Bloco | Redirect Inatividade Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Inatividade:

Manda uma mensagem para resgatar a conversa do usuário com o Contato Inteligente após período inativo.

Bloco | [INPUT] I.1.0.0 - Inatividade  Exibe uma mensagem para confirmar se o usuário deseja prosseguir com o atendimento.   Bloco | [LOGIC] I.1.0.0 - Inatividade A variável {setValidation} é utilizada para validar a decisão do usuário e determinar a continuidade ou o encerramento do fluxo.   Bloco | [INPUT] I.1.2.0 Encerramento Exibe o conteúdo da mensagem de finalização.   Bloco | REDIRECT SERVICE Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.

Opt-In/Out:

Controla o consentimento do usuário para o envio de comunicações.

Bloco | [INPUT] I.1.0.0 - optin Conteúdo da mensagem de solicitação de consentimento para o envio de notificações.   Bloco | [LOGIC] I.1.0.0 - OPT-IN Validação da opção escolhida através de um script.   Bloco | OPT 1.0.1 - Aceite Opt-in Conteúdo de confirmação após adesão (opt-in) do usuário.   Bloco | OPT 2.0.0 - Opt out Mensagem de confirmação de remoção da base de destinatários.   Bloco | OPT.1.0.2 - Não aceite Conteúdo exibido após a recusa da permissão de notificações pelo usuário.   Bloco | REDIRECT SERVICE Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.   Bloco | Redirect Inatividade Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Algo Mais:

Verifica se a pessoa deseja acrescentar informações ou conversar sobre outro assunto.

Bloco | [INPUT] AM.1.0.0 - Algo mais Mensagem de verificação de pendências ou suporte adicional.   Bloco | [LOGIC] AM.1.0.0 - Algo mais Validação da opção escolhida por meio de um script.   Bloco | REDIRECT SERVICE Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.   Bloco | Redirect Inatividade Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Finalização:

Confirma a conclusão do atendimento e sinaliza disponibilidade para novas solicitações.

Bloco | F.1.0.0 - Finalização  Mensagem de encerramento com instruções para reabertura do contato.   Bloco | REDIRECT SERVICE Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.

CSAT:

Coleta a avaliação de satisfação do usuário após o atendimento.

Bloco | [START]  Controla o acesso à habilidade validando a variável {{input.content@redirectId}} para direcionar o usuário ao bloco de destino correspondente.   Bloco | [MSG] C.1.0.0 Pergunta Resolutividade Mensagem de confirmação enviada ao usuário para validar se sua solicitação foi resolvida antes de encerrar o fluxo.   Bloco | [LOGIC] C.1.0.0 Pergunta Resolutividade A validação da opção selecionada é realizada via script, utilizando a variável {{userInput}} diretamente nas condições de saída para determinar o próximo passo do fluxo.   Bloco | [MSG] C.1.0.1 Resolutividade negativa Exibe o conteúdo da mensagem perguntando o que pode ser melhorado.   Bloco | [MSG] C.1.1.1 Pergunta CSAT Exibe o conteúdo da mensagem perguntando a nota de avaliação.   Bloco | [LOGIC] C.1.1.1 Pergunta CSAT Validação da nota de avaliação realizada via script utilizando a variável {{userInput}} para processar a pontuação recebida.   Bloco | [MSG] C.1.1.2 Finaliza CSAT Exibe o conteúdo da mensagem de finalização.   Bloco | Redirect Finish Redireciona o serviço para a habilidade de finalização.   Bloco | Redirect Inatividade Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Transbordo:

Encaminha o usuário para o atendimento humano sempre que a interação exigir suporte especializado.

Bloco | Customer service  Configura as regras de disponibilidade para gerenciar o fluxo quando não houver atendentes ou o contato ocorrer fora do horário de operação.   Bloco | ATH.1.0.0 Nenhum atendente disponivel Mensagem de indisponibilidade que informa a ausência de atendentes e questiona se o usuário deseja aguardar na fila.   Bloco | ATH 1.1.0 Aguarde Mensagem de espera orientando o usuário a aguardar o início do atendimento.   Bloco | ATH 1.2.0 Despedida Mensagem de encerramento que instrui o usuário sobre qual termo ou ação utilizar para reiniciar a conversa.   Bloco | ATH2.0.0 Fora do horário Mensagem informativa sobre o encerramento do expediente que apresenta os horários de funcionamento do canal.   Bloco | REDIRECT SERVICE Redireciona o usuário para outro serviço ou habilidade utilizando uma ação de saída configurada no bloco.   Bloco | Redirect Inatividade Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Dados pessoais:

Solicita, valida e organiza informações pessoais do usuário com segurança. CPF - Nome - Email - Telefone.

Bloco | [START] Gerencia a entrada na habilidade validando a variável {{input.content@redirectId}} e encaminhando o usuário ao bloco correspondente via ID.   Bloco | [MSG] Mensagem intro Mensagem introdutória que comunica ao usuário o início da coleta de dados.   Bloco | [LOGIC] DC.1.0.0 Pedir cpf? Nas ações de entrada, a variável {{dadosPessoais}} define quais informações serão coletadas e valida a necessidade de solicitar o CPF.   Bloco | [MSG] DC.1.0.1 Pedir CPF Mensagem que solicita ao usuário o número do CPF para prosseguir com o cadastro.   Bloco | [MSG] DC.1.0.1 Pedir CPF Validacao Validação do formato e da autenticidade do CPF via script, utilizando a variável {{isValidCpf}} para registrar o documento nos parâmetros do contato.   Bloco | [LOGIC] DC.1.1.0 Pedir Nome? Verifica se a coleta do nome está habilitada na variável {{dadosPessoais}}.   Bloco | [MSG] DC.1.1.1 Pedir Nome Mensagem que solicita ao usuário o preenchimento do nome completo.   Bloco | [LOGIC] DC.1.1.1 Pedir Nome Validacao Validação do formato nominal via script utilizando a variável {{nameValidation}} para registrar o nome nos parâmetros do contato.   Bloco | [LOGIC] DC.1.2.0 Pedir E-mail? Verifica se a coleta de e-mail está habilitada na variável {{dadosPessoais}}.   Bloco | [MSG] DC.1.2.1 Pedir E-mail Mensagem que solicita ao usuário o endereço de e-mail para contato ou cadastro.   Bloco | [LOGIC] DC.1.2.1 Pedir E-mail validacao Validação do formato e da autenticidade do e-mail via script utilizando a variável {{hasEmail}} para registrar o endereço nos parâmetros do contato.   Bloco | [LOGIC] DC.1.3.0 Pedir Telefone? Verifica se a coleta de e-mail está habilitada na variável {{dadosPessoais}}.   Bloco | [MSG] DC.1.3.1 Pedir Telefone Mensagem que solicita ao usuário o número de telefone para contato.   Bloco | [MSG] DC.1.3.1 Pedir Telefone validacao Validação do formato e da autenticidade do telefone via script utilizando a variável {{phoneNumber}} para registrar o número nos parâmetros do contato.   Bloco | [MSG] Mensagem transição Mensagem de confirmação que informa ao usuário a conclusão bem-sucedida da coleta de seus dados.   Bloco | REDIRECT SERVICE Redireciona o usuário para outro serviço ou habilidade utilizando uma ação de saída configurada no bloco.   Bloco | Redirect Inatividade Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Cascata de Validação:

É o processo sequencial de verificação de dados. Cada etapa funciona como um "filtro": a informação só avança para o próximo nível se for validada com sucesso no anterior.

Integrações e Configurações de API

Os atributos non_talkables_error e connection_talks_error dependem de conexões com sistemas externos. Eles realizam buscas dinâmicas para entregar respostas personalizadas, baseadas no contexto atual e na etapa específica da conversa.

Como Configurar no Studio

Após adicionar a cascata através da biblioteca, localize o bloco: [REQ] set variables

O controle do fluxo é feito na aba de Ações, dentro do script Proccess ExceptionHierarchy. Nele, você pode definir quais validações estarão vigentes na jornada:

• True: Validação ativa.
• False: Validação desativada.

Por padrão, os atributos non_talkables_error e connection_talks_error iniciam desativados.

• Para Ativar: Altere o valor para true e salve as alterações.

• Atenção: Ao ativar, certifique-se de configurar as regras e variáveis dessas validações de acordo com o contexto específico da sua jornada.
   

Configuração das Habilidades

Passo a passo:

• Criar um chatbot

• Acessar a biblioteca

• Adicionando uma habilidade

• Instruções Habilidades

Cada habilidade importada para o Studio inclui um bloco instrutivo chamado "Comece Aqui".

• Como ativar: Siga as instruções contidas nesse bloco e aplique as configurações solicitadas para que a skill passe a operar corretamente.

• Limpeza do Fluxo: Após a importação e configuração, os blocos nativos de "Boas-vindas" e "Erro Padrão" (gerados automaticamente na criação do bot) podem ser excluídos para evitar duplicidade.

Agente Cadastro

Este componente da biblioteca foi projetado para automatizar a coleta de dados essenciais:

• Coleta: Registra nome, e-mail e telefone do usuário.

• Direcionamento: Após a captura bem-sucedida, o fluxo é encaminhado automaticamente para um bloco padrão, onde a conversa prossegue.

Imagem

Prompt

<objetivo>Coletar e validar NOME, EMAIL e TELEFONE do usuário em pt-BR.</objetivo>     <diretrizes>     <tons>educado, direto, uma pergunta por vez</tons>     <regras>       <regra>Nunca prossiga para o próximo campo se o atual estiver inválido.</regra>       <regra>Sempre explique por que a entrada é inválida e mostre um exemplo válido.</regra>       <regra>Ao final, confirme o resumo dos dados antes de encerrar.</regra>     </regras>   </diretrizes>     <fluxo>     <passo>Peça o NOME completo.</passo>     <passo>Valide e normalize o NOME.</passo>     <passo>Peça o EMAIL.</passo>     <passo>Valide o EMAIL.</passo>     <passo>Peça o TELEFONE (aceite BR e internacional).</passo>     <passo>Valide e normalize o TELEFONE.</passo>     <passo>Mostre o resumo e peça confirmação (Sim/Não).</passo>   </fluxo>     <campos>     <campo id="nome">       <pergunta>Qual é seu nome completo?   Pode ser apenas nome e sobrenome</pergunta>       <validacao>         <tipo>regex</tipo>         <padrao>^(?=.{3,100}$)(?:[A-Za-zÀ-ÖØ-öø-ÿ]+(?:['\-][A-Za-zÀ-ÖØ-öø-ÿ]+)?\s+){1,}[A-Za-zÀ-ÖØ-öø-ÿ]+$</padrao>         <falha>Informe nome e sobrenome, usando apenas letras, espaços e acentos. Ex.: "Fulano Silva".</falha>       </validacao>       <normalizacao>         <acao>trim espaços; colapsar múltiplos espaços; Title Case.</acao>       </normalizacao>     </campo>       <campo id="email">       <pergunta>Qual é seu e-mail?</pergunta>       <validacao>         <tipo>regex</tipo>         <padrao>^[A-Za-z0-9._%+\-]+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}$</padrao>         <falha>E-mail inválido. Use o formato "usuario@dominio.com".</falha>       </validacao>       <normalizacao>         <acao>trim; converter domínio para minúsculas.</acao>       </normalizacao>     </campo>       <campo id="telefone">       <pergunta>Qual é seu telefone com DDD? (ex.: (DD) XXXXX-XXXX </pergunta>       <validacao>         <tipo>regex-multiplo</tipo>         <padraoE164>^\+?[1-9]\d{7,14}$</padraoE164>         <padraoBR>^(?:\+55\s?)?(?:\(?\d{2}\)?\s?)?(?:9?\d{4})-?\d{4}$</padraoBR>         <falha>Telefone inválido. Exemplos: "(DD) XXXXX-XXXX".</falha>       </validacao>       <normalizacao>         <acao>remover caracteres não numéricos (exceto +); se for BR sem +55, prefixar +55; formatar saída em E.164 (ex.: +5531912345678).</acao>       </normalizacao>     </campo>   </campos>     <mensagens>     <inicial>Vamos prosseguir com um cadastro rápido. Começando pelo seu nome completo.</inicial>     <resumo>Confira os dados: Nome: {nome} E-mail: {email} Telefone: {telefone}.   Estão corretos?</resumo>     <confirmado>Perfeito! Cadastro concluído.</confirmado>     <correcao>Sem problemas, vamos ajustar. Qual campo deseja corrigir? (nome/email/telefone)</correcao>   </mensagens> <handoff> Se usuário disser "sim" → redirecionar para "novo bloco". </handoff>   <saida>     <formatoJSON>       {         "nome": "{nome_normalizado}",         "email": "{email_validado}",         "telefone": "{telefone_E164}"       }     </formatoJSON>   </saida>

Caso de uso - Qualificação de Leads

Para o caso de uso, o conjunto completo de habilidades é centralizado em um único ambiente no Studio, conforme ilustrado abaixo:

Centralizar todas as habilidades em um único ambiente do Studio facilita a gestão do espaço de trabalho. No entanto, o processo de evolução ou adição de novas funcionalidades exige atenção redobrada nas conexões entre os blocos para garantir a integridade da estrutura conversacional.

Para orientações detalhadas e dicas práticas sobre o uso da biblioteca de blocos, consulte o AMA disponível em nosso canal no YouTube.
 

Caso de uso - Agente de IA para FAQ

O Agente de IA para FAQ é uma fundação sólida e robusta para responder perguntas, exigindo apenas o fornecimento de insumos (bases de conhecimento) e customização mínima para entrar em operação. Diferente de bots tradicionais, ele não depende de fluxos engessados; ele aprende com o seu catálogo de documentos, com foco em precisão e segurança. Sua principal força é a capacidade de fornecer respostas diretas e formatadas, mantendo o usuário dentro do escopo permitido e garantindo alta performance com baixo esforço de implementação. É o template ideal para empresas que buscam transformar sua base de conhecimento em um assistente conversacional de alta performance.

Casos de Uso

• Centralização de dúvidas frequentes sobre produtos e serviços.

• Suporte de pós-venda, com auxílio imediato em dúvidas sobre rastreio, trocas, devoluções e uso de produtos.

• Triagem de primeiro nível para suporte técnico e comercial.

• Autoatendimento para consultas de manuais e políticas internas.

Objetivo Principal

Atuar como um especialista digital capaz de compreender dúvidas de usuários e fornecer respostas precisas, baseadas exclusivamente em uma base de conhecimento oficial, garantindo um atendimento fluido, seguro e com baixo índice de alucinação.

Arquitetura do Agente

• Tipo: Baseado em IA Generativa (Inteligência Híbrida).

• Motor: Provedor de IA integrado com busca em Base de Conhecimento (RAG - Retrieval-Augmented Generation).

• Recursos: Scripts de normalização Unicode, processamento de linguagem natural (LLM), Protocolo de Knowledge Gap e validação de inatividade via Regex.

Principais Módulos/Funcionalidades

1. Consulta à Base de Conhecimento: Busca obrigatória na ferramenta search_in_knowledge_base antes de qualquer resposta.

2. Protocolo Knowledge Gap: Reconhecimento educado de temas relevantes, mas com admissão profissional de ausência de dados quando a informação não consta na base.

3. Segurança Multicamada (Guardrails): Filtros nativos contra ofensas, discurso de ódio, comparação com concorrentes e solicitações de dados sensíveis (LGPD).

4. Menu de Inatividade Inteligente: Script de validação que reconhece variações de "Sim" e "Não" para decidir entre continuar ou encerrar o atendimento.

5. Handoff Estruturado: Gatilhos específicos para transbordo humano baseados em insatisfação, complexidade técnica ou persistência no erro.

Fluxo Principal

Entrada do Usuário → Identificação de Intenção → Consulta à Base de Conhecimento → Resposta Estruturada → Validação Contextual de Utilidade → (Opcional) Menu de Inatividade → Encerramento ou Transbordo.

Recursos Técnicos

• Respostas No-Filler: Instrução para ir direto ao ponto, eliminando saudações repetitivas no meio da conversa.

• Escaneabilidade Automática: Formatação de respostas com negritos, bullets e parágrafos curtos para melhor leitura em dispositivos móveis.

• Log de Interação: Execução obrigatória da ferramenta log_user_interaction para registro de sentimento e resumo da tarefa antes de qualquer saída de bloco.

• Finalização Contextual: O agente sugere próximos passos baseados no assunto que acabou de ser tratado, evitando perguntas genéricas.

Quando Usar Este Agente?

• Quando a empresa possui uma base de dados (PDF, DOCX, CSV) e deseja automatizar o atendimento.

• Quando for necessário um tom de voz profissional e consistente em 100% das interações.

• Para qualificar a dúvida do usuário antes de enviá-lo para um operador humano.

• Para otimizar a experiência de pós-venda com respostas rápidas sobre políticas de suporte.

Guia de Configuração do template

1. Conectando Blocos

Conecte:

- Bloco Início ao Agente FAQ

- Bloco Exceções ao Redirect to service "Cascata de validação"

2. Configuração da IA (Obrigatório)

Para que o Agente responda corretamente, você deve adicionar uma Base de Conhecimento. Sem isso, o agente não terá informações para consultar.

Acesse o Agente FAQ e vá até a aba Ferramentas e selecione “Adicionar ferramenta” e depois “Base de conhecimento”.

Crie um “Catálogo” e, dentro do catálogo, clique em “Criar catálogo” para fazer o upload do arquivo ou adicionar a URL com as respostas às perguntas frequentes do seu contexto.

Teste agora

Se você ainda não tem seus próprios documentos prontos, baixe a base de teste da empresa fictícia ServCompany no link abaixo para ver o agente em funcionamento:

• http://leva.la/exemplo-base-servcompany
   

3. Guia de Custominização (o que editar)

• Identidade do Agente: No bloco de IA, edite o prompt principal substituindo pelas informações da marca:

  • [Nome da Empresa/Área]

  • [Especificar qual é a área] 

• Escopo e Guardrails: liste os tópicos permitidos em: [Listar Tópicos do Cliente]. 

  Isso evita que a IA responda sobre assuntos que não competem ao suporte.

• Mensagens de Erro/Suporte: nos blocos de conteúdo não suportado e Saída conteúdo impróprio, apague as instruções e edite os placeholders de texto.

4. Diferenciais desse template

• Protocolo Knowledge Gap: a IA é treinada para não inventar respostas (alucinação). Se não estiver na base, ela admite a falta de dados e tenta ajudar em outro tema.

• Handoff Inteligente: o transbordo humano só é acionado em casos de irritação real, solicitações diretas ou falhas persistentes, otimizando sua operação.

• Segurança (Guardrails): proteção contra ofensas, discurso de ódio e solicitações de dados sensíveis (LGPD).

Caso de uso - Agente de Aquisição

O Agente de Aquisição é um assistente estruturado para conduzir o processo de compra do início ao fim por meio do WhatsApp, sem requerer intervenção humana nas etapas padrão. 

Este documento apresenta detalhadamente os objetivos, a arquitetura técnica, as regras de negócio, a sequência do fluxo e todas as instruções de configuração e integração do template.

Antes de começar

• É necessário possuir acesso à plataforma Blip com permissões para criação, edição de blocos e gerenciamento de variáveis de configuração no Builder.

• Caso opte pela integração avançada, é preciso ter um endpoint de API REST público ou autenticado funcional para consulta de produtos e manipulação do carrinho de compras.

Objetivo principal

O Agente de Vendas apresenta produtos, monta o carrinho de compras, coleta dados cadastrais do cliente e finaliza o pedido de forma automatizada e conversacional. Trata-se da solução ideal para empresas que buscam vender pelo WhatsApp mantendo uma experiência organizada, dispensando a obrigatoriedade inicial de uma plataforma de e-commerce complexa.

Casos de uso aplicáveis

• Venda direta: Venda de produtos físicos ou serviços diretamente pelo WhatsApp.

• Digitalização inicial: Empresas que ainda não têm loja virtual e querem começar a vender de forma digital.

• Coleta de dados pré-pedido: Negócios que precisam coletar dados do cliente (nome, CPF, endereço) antes de fechar um pedido.

• Recuperação de vendas: Operações que querem recuperar automaticamente clientes que iniciaram uma compra e não finalizaram.

• Geração de orçamentos: Times comerciais que precisam de um ponto de entrada para cotações e orçamentos.

Arquitetura do agente

• Tipo de arquitetura: Inteligência Híbrida.

• Motor de IA: Quatro agentes de IA especializados, onde cada um é responsável por uma etapa específica da jornada de compra, orquestrados por uma lógica determinística.

• Recursos técnicos:

  • Geração dinâmica de menu de produtos com imagem e preço.

  • Validação de dados cadastrais via Regex.

  • Detecção automática de carrinho abandonado.

  • Quick replies contextuais exibidos em cada etapa da jornada.

Principais módulos

• Agente Orquestrador: Recebe o usuário, exibe o resumo do carrinho e direciona para a etapa correta — comprar, cadastrar ou finalizar. Não permite que o cliente avance para o checkout sem possuir cadastro completo.

• Agente Pedido: Apresenta o catálogo de produtos, coleta a seleção e a quantidade informadas pelo cliente e monta o carrinho. Permite adicionar e remover itens antes de prosseguir.

• Agente Carrinho Abandonado: Acionado automaticamente quando o cliente retorna à conversa sem ter finalizado a compra prévia. Exibe os itens remanescentes no carrinho e oferece um incentivo comercial (desconto + frete grátis) para o fechamento do pedido.

• Agente Cadastro: Coleta os dados necessários para entrega e faturamento (nome, e-mail, telefone, CPF e endereço completo), realizando a validação de cada campo antes de avançar.

Sequência do fluxo

Entrada do Usuário → Verificação de Estado (Carrinho Pendente) → Tratativa Contextual (Oferta de Recuperação ou Seleção de Produtos) → Orquestração e Roteamento de Intenção → Execução da Ação (Gerenciamento do Pedido ou Coleta de Dados Cadastrais) → Processamento de Checkout e Finalização.

Passo a passo de configuração

1. Conectando os blocos iniciais

1. Acesse o canvas do Builder.

2. Conecte a saída do bloco Início diretamente ao bloco Define carrinho abandonado.

3. Conecte a saída do bloco Exceções diretamente ao bloco Erro padrão.

2. Configuração do catálogo de produtos 

Por padrão, o template é fornecido com dados estáticos da empresa fictícia ServCompany. É obrigatório substituir esses dados pelas informações reais do seu negócio.

1. Acesse o bloco do Agente Pedido.

2. Clique na sessão do terceiro prompt

3. Localize a seção intitulada # Produtos.

4. Substitua a estrutura existente inserindo os dados reais da sua empresa, mantendo rigorosamente a formatação do modelo abaixo:

1. Nome do Produto ou Serviço

Detalhes: informações técnicas, prazo, tamanho, etc.

Preço: R$ 0,00

Descrição: descrição comercial do item

5. Na seção referente à empresa, substitua o termo Empresa: ServCompany informando o nome comercial correto da sua instituição.

3. Configuração do bloco Adiciona ao Carrinho

A saída adicionar_carrinho do Agente Pedido não possui destino padrão no template (exibida na cor vermelha). Você deve criar e mapear o bloco correspondente de acordo com o modelo de dados utilizado:

1. Crie um novo bloco no canvas com o nome Adiciona ao Carrinho.

2. Conecte a saída adicionar_carrinho do Agente Pedido a este novo bloco.

3. Nas Ações de entrada do bloco Adiciona ao Carrinho, adicione a ação Definir variável:

   • Nome da variável: carrinho

   • Valor: {{input.content@content.value.arguments.carrinho}}

4. Conecte a saída do bloco Adiciona ao Carrinho de volta para o Agente Orquestrador.

Guia de customização técnica

• Identidade dos Agentes: Acesse individualmente cada bloco de IA e edite o campo de prompt, substituindo todas as menções e referências à ServCompany pelo nome, tom de voz e contexto da sua empresa.

• Regra de Carrinho Abandonado: No bloco Agente Carrinho Abandonado, localize a instrução de oferta. A regra nativa está parametrizada para oferecer 5% de desconto + frete grátis para carrinhos inativos por mais de 12 horas. Altere o texto da instrução técnica conforme a regra comercial desejada:

"Para carrinhos abandonados a mais de [X horas], ofereça [seu desconto] e [seu benefício]."

• Campos do Cadastro: Por padrão, o Agente Cadastro solicita e valida os seguintes campos: nome, e-mail, telefone, CPF e endereço completo. Caso o modelo de negócio não exija a totalidade desses dados (por exemplo, venda de produtos digitais sem entrega física), remova explicitamente as instruções relativas aos campos desnecessários no prompt do Agente Cadastro.

Dicas / FAQ

• Arquitetura Multi-Agente: Cada agente foi projetado com escopo fechado. O Agente Cadastro não fornece informações sobre produtos, assim como o Agente Pedido não realiza cadastros de usuários. Evite mesclar responsabilidades nos prompts para não comprometer a precisão da IA.

• Recuperação de Carrinho Automática: A lógica de detecção identifica o retorno do usuário com pendências de compra ativas e aciona o fluxo de incentivo antes da apresentação do catálogo regular.

• Validação de Dados em Tempo Real: As validações de campos críticos (CPF, CEP, e-mail, telefone) ocorrem via Regex diretamente no Agente Cadastro, impedindo o avanço de strings malformatadas ou dados inválidos.

• Bloqueio de Checkout Sem Cadastro: O fluxo determinístico bloqueia a finalização da ordem caso as variáveis cadastrais não estejam totalmente preenchidas, garantindo a integridade dos dados de faturamento e envio.

• Guardrails de Segurança: Todos os prompts de agente possuem travas de segurança ativas para impedir a menção a marcas concorrentes, invenção de itens fora do catálogo e respostas fora do escopo funcional da etapa.

   

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃