01. Visão Geral do Builder
Nesta seção da documentação, você saberá como acessar seu projeto criacional, conhecer as ferramentas do simulador do assistente virtual e como são feitas as configurações.
Acessar o BuilderO primeiro passo é acessar. Para isso, há duas maneiras:
Pela página inicial do assistente clicando no primeir
03. Eventos personalizados
Os eventos que incluímos no Builder para serem disparados durante o atendimento e capturar informações específicas são os chamados eventos personalizados.
⚠️Atenção: antes de configurarmos no Builder, é necessário criar o evento no Monitor. Posteriormente, esses eventos poderão ser convertidos em mé
Autorização de chamada de voz do WhatsApp no NLU - WhatsApp Calling
Importante: É preciso ter o WhatsApp habilitado para acessar a opção de chamadas de voz (WhatsApp Calling). Caso você tenha o WhatsApp habilitado, essa opção estará disponível de forma automática. Verifique o seu plano para saber se essa funcionalidade está disponível. Agora é possível realizar cham
01. Visão Geral dos Assistentes
O Build é o pilar que serve como um orquestrador dos assistentes virtuais. Nele, você pode criar um novo assistente, acessar um já existente e configurar os fluxos de diversas maneiras, como verá ao longo dessa parte da documentação.
Nesta documentação, você encontrará as seguintes seções:
Como aces
Integração NLU com Movidesk: Preenchimento Automático de Tickets
Visão geral Esta funcionalidade aprimora a integração entre o NLU e o Movidesk, permitindo que informações coletadas pelo bot sejam automaticamente transferidas para o ticket no momento do transbordo para atendimento humano. Você não precisa mais preencher manualmente dados que o cliente já informou
02. Integrar a Biblioteca de IA ao seu Chatbot
Após adicionar o arquivo da base de conhecimento, explicado no artigo Visão geral da Biblioteca para IA, o passo seguinte é utilizá-lo como busca semântica durante o bot.
Para isso, será necessário criar um novo nó e configurar o builder do novo assistente. Siga as instruções abaixo:
Acesse o Build
12. Functions
Nesta sessão você pode desenvolver ações personalizadas em javascript.
Para aplicá-la no seu assistente, siga as instruções abaixo:
Acesse a Configuração do nó;
Escolha o componente de Ações;
Clique no Helper;
Busque por Ação personalizada.
⚠️Atenção: antes de realizar as instruções, lembre-se d
17. Encerrar chat
O componente Encerrar chat permite encerrar automaticamente o atendimento de um chatbot no momento desejado.
Este artigo irá guiá-lo pelo processo de configuração dessa ação no Builder de maneira simples e prática.
Estrutura da AçãoA estrutura da ação para encerrar o chat é a seguinte:
[
{
"na
08. Upload de arquivo
Visão geralO componente file_upload permite que o usuário envie arquivos diretamente pelo Widget do NLU. Após o envio, o arquivo fica disponível no fluxo através do objeto input.file, contendo informações como nome, tamanho, tipo e URL de acesso.
Passo 1 – Exibir o componente de uploadEm uma etapa d
04. Issues
Acessando a aba de Issues é possível monitorar os erros que estão acontecendo no assistente.
Você pode filtrá-las por:
Período: data única ou intervalo de datas;
Assistente: apenas assistentes específicos onde ocorre aquela Issue;
Tipo de Issue: lista de Issues identificadas naquela instância.
Inf
26. Escolher NLU
Dentro do Builder é possível utilizar os nlus_extras de dois modos:
Input
Ao configurar um input, é possível escolher com qual NLU a resposta do usuário será processada.
Caso o nlu_id não esteja na lista que aparece na tela de edição do assistente, o NLU padrão será utilizado.
{
"default": {
"typ
01. Transbordo Zenvia NLU Connector API
Transbordo Zenvia NLU Connector API
Nome: nome do LiveChatProvedor: ALTU ConnectorTempo de espera: tempo que o assistente aguardará para que o usuário seja atendido pelo humano (deixar 0 para desativar).Tempo de inatividade do usuário: tempo que o assistente aguardará uma mensagem do usuário para
18. Socket Event
Esta ação é útil para customizações, como por exemplo exibir um menu de opções que dependa de dados de um usuário logado.
⚠️Atenção: disponível somente no canal Widget.
Estrutura
[
{
"name": "socket_event",
"parameters": {
"event": "myEvent",
"payload": {
"param1": "valu
04. Validar celular
Este componente permite validar números de celular informados pelos usuários. Essa validação é feita através de regras baseadas em expressões regulares (regex), garantindo que apenas números em formatos válidos sejam aceitos.
Este artigo irá guiá-lo pelo processo de configuração dessa ação no Builde
02. Intent Feedback
Esta ação armazena o feedback do usuário acerca da última intenção identificada.
Estrutura
[
{
"name": "intent_feedback",
"parameters": {
"feedback": 1,
"last_intent_id": ""
},
"result_variable": "feedback_response"
}
]
Atributos
name: intent_feedback
parameters:
fe
Lançamentos de Julho
Confira as novidades do mês de Julho🚀
Reunimos aqui os principais lançamentos e melhorias da Zenvia Customer Cloud, com foco no que impacta o seu dia a dia e ajuda você a extrair mais valor da plataforma.
Navegue por jornada:
🎧Atendimento de SuporteDetalhes da conversa: mais contexto e acesso ráp
02. Variáveis
As variáveis permitem armazenar e reutilizar informações ao longo da conversa no fluxo do chatbot. Com elas, é possível personalizar mensagens, guardar respostas de usuários, controlar etapas e muito mais.
Neste artigo, você vai aprender:
Como cadastrar uma variável no Builder
Quais são os tipos de
03. Lista de automações do Zenvia Attraction
A lista de automações tem como função centralizar todos os fluxos que foram criados através do builder. Nesta página vamos aprender a criar, editar, renomear e deletar uma automação.
08. Validar CNPJ
Este componente permite que você valide um CNPJ enviado pelo usuário, verificando se ele é válido e, se for o caso, retornando o CNPJ pós-validação.
Esse processo é essencial para garantir a integridade dos dados em interações automatizadas, especialmente quando o CNPJ é utilizado em fluxos de dado
Integração NLU com Movidesk: Novos retornos do Movidesk para o NLU
Visão geralEsta funcionalidade aprimora a integração entre o NLU e o Movidesk, permitindo que o bot receba retornos específicos sobre o status atual do chat no Movidesk no momento do transbordo. Com isso, o chatbot consegue identificar cenários como horários fora de atendimento, feriados ou ausência
01. HTTP Request
O componente HTTP Request permite enviar dados coletados durante uma interação com o cliente, como nome ou e-mail, para outro sistema, integrando-se com CRMs, sistemas de ticket ou outros aplicativos.
Este artigo irá guiá-lo pelo processo de configuração dessa ação no Builder de maneira simples e p
09. Carrossel de Opções
O componente Carrossel de opções permite exibir várias opções de forma interativa e organizada, facilitando a escolha do usuário.
Disponível exclusivamente no canal Widget, o carrossel apresenta as opções em formato deslizante, proporcionando uma experiência mais fluida e intuitiva.
Este component
Envio de Pesquisa de Satisfação do NLU para Movidesk
Este artigo detalha a configuração para enviar respostas de pesquisa de satisfação do sistema NLU diretamente para o Movidesk, integrando-as ao ticket correspondente. Isso permite a extração de relatórios, indicadores e a visualização das informações de satisfação dentro do próprio ticket no Movides
01. Visão geral dos Atributos
Os atributos são informações complementares encontradas nos detalhes do atendimento.
É possível criar atributos personalizados e usar opções predefinidas.
Visão Geral
Os atributos são informações complementares encontradas nos detalhes do atendimento:
Um atributo possui duas informações:
Nome: i
10. Data
Input para solicitar uma data para o usuário. Para configurar, acesse a aba input e em seguida selecione a opção Data no ícone da interrogação "?".
Estrutura
{
"default": {
"type": "date",
"payload": {
"allowInput": false
}
}
}
Atributos
type: date
payload:
max (opc
07. Visão geral Logs
Logs
Na aba de Logs, é possível rastrear todos os registros e informações diversas das requisições de uma API.
Nela, você poderá pesquisar por palavras-chaves no conteúdo dos logs e seu respectivo período.
Estrutura
Componentes: neste filtro, você poderá buscar por duas opções que melhor atenda su
01. Visão geral das Functions
Realize integrações dos bots com os sistemas dos clientes diminuindo o tempo de programação.
Com a Functions você consegue processar os dados mais pesados do seu bot, como uma lista de endereços, e exibi-lo no seu chatbot sem a necessidade de utilizar uma API externa.
Ao criar uma ação ou nó no Buil
24. Transferência de produto Zenvia
Ação utilizada para transferência entre soluções Zenvia dentro da plataforma Zenvia NLU.
Poderá ser utilizada quando desejar transferir o atendimento pelo bot para plataformas de atendimento humano da Zenvia, como Zenvia Conversion e Zenvia Chat.
⚠️Atenção:: para realizar a transferência, o contato
01. Atendimentos
Os atendimentos são gerados a partir da troca de mensagens entre usuários e assistentes, e essa é a área onde você pode explorar essas interações. Aqui é possível filtrar informações, visualizar atendimentos e transferi-los para o Zenvia Chat.
💡 Dica: Caso as telas e funcionalidades sinalizadas nã
WhatsApp Calling em Chatbots
Visão geralO WhatsApp Calling permite que um chatbot receba ou solicite uma chamada de voz via WhatsApp durante uma conversa com o cliente. Este recurso possibilita criar jornadas em que o usuário inicia um atendimento por mensagens e, quando necessário, é direcionado para uma chamada de voz diretam
06. Lista de opções modal
Exibe um lista de opções que ocupa, por completo, a tela do chat.
Estrutura
{
"default": {
"type": "option_list",
"payload": {
"pick": "pergunta",
"options": [
{
"title": "opção 1",
"value": "valor da opção 1"
},
{
02. Eventos
Nesta seção você irá encontrar informações sobre configuração e monitoramento de eventos do seu assistente.
Visão Geral
Eventos são uma forma de acompanhar as interações e ações no assistente. Eles são indispensáveis para gerar métricas e indicadores.
Para buscar, criar ou editar eventos, clique em
02. Transbordo Tech4Humans
Nesta página você irá encontrar um exemplo de configuração utilizando Zenvia NLU Connector API para transbordo com a Tech4Humans.
Integração Zenvia NLU Connector
Crie uma nova conexão no LiveChat na Zenvia NLU acessando a aba Connect > Live Chats.
Para solicitar o cadastro de um Webhook, é necessár
05. Lista de opções inline
Lista de opções com rolagem. Exibe uma lista de opções que ocupa uma parte da tela.
Se a lista ultrapassar o tamanho de visualização de itens por vez, é possível que o usuário use a rolagem para visualizar os demais.
Estrutura
{
"default": {
"type": "select",
"payload": {
"pick": "
05. Transbordo Zendesk Chat
⚠️Atenção: essa integração está disponível somente para o canal Widget.
Para configurar o transbordo pelo Zendesk Chat, encontre sua integração em Canais > LiveChat ou clique no botão inferior direito ➕ para criar uma nova integração.
Ao abrir o formulário, preencha os seguintes campos:
Nome: nome
03. Glossário
Ao utilizar o Train, alguns termos podem ser totalmente novos para o seu conhecimento.
Por este motivo, preparamos este glossário. Acesse sempre que precisar. 😉
AB
Assistente virtual: popularmente chamados de chatbot. Aqui escolhemos chamá-los de assistentes.
Atendimento: atendimentos são gerados
05. Google RCS
O RCS é um canal de comunicação feito pelo Google e possui recursos como: envio de localização, compartilhamento de informações, calendário, entre outros.
Compatibilidade
Utilize esses componentes para criar o assistente:
Informações aceitas
Texto
Arquivo: apenas imagens nos formatos jpeg, jpg, gif
20. Atualizar Componente
A funcionalidade Atualizar Componente serve para definir como os componentes irão se comportar.
Esta funcionalidade será apresentada ao realizar o seguinte passo:
Em Produtos > Zenvia Bots.
Em seguida, clique em Meus componentes. Com isso, ao criar novo componente ou clicar sobre um compenente já
Últimos lançamentos em NLU
Boas-vindas à página de atualizações do NLU!
Por aqui, você acompanha as novidades, melhorias e correções da plataforma, além de entender como cada mudança impacta o seu dia.
Refatoração Arquitetural do Flowmap💡 MelhoriaSetembro/2026
O que mudou
Estamos modernizando a arquitetura do Flowm
01. Veja os artigos disponíveis de Zenvia NLU
🌎 By Humanz for Humans: boas-vindas à Central de Ajuda da ferramenta Zenvia NLUNossa documentação é dividida em três categorias:
Conceito e acesso: conceitos da ferramenta e orientações para acessá-la;Primeiros passos: visão geral da ferramenta e suas principais funcionalidades;Recursos e funções:
01. Fluxo de Inatividade
Para aprimorar o bot, utilize a função de inatividade e configure o período de tempo que seu chat deve aguardar antes de mover para o fluxo de abandono.
💡 Por exemplo: caso um cliente abandone uma conversa ou compra, essa funcionalidade permitirá configurar um fluxo inteiro para a sequência do aten
23. Informação de produto Zenvia
Antes de realizar uma transferência, algumas informações podem ser necessárias para decidir se a transferência será realizada e para direcionar uma transferência para um departamento ou atendente específico.
Zenvia NLU permite consultar informações de outros produtos, como departamentos, atendentes
04. Gráficos
Este artigo apresenta um guia completo sobre a criação, edição e gerenciamento de gráficos para visualização de métricas. Você aprenderá a configurar gráficos personalizados, incluindo diferentes tipos de exibição como linha, barra, pizza, TNPS e tabelas, além de explorar recursos avançados, como ag
22. Iniciar LiveChat
As integrações de Live Chat são configuradas no menu Live Chat contendo integrações com a LivePerson e Zendesk.
LivePerson
Estrutura
[
{
"name": "start_live_chat",
"parameters": {
"integration_id": "ID da integração configurada",
"start_message": "Mensagem para o agente"
},
"resu
07. Quick Replies
Exibe uma pergunta com opções em formato de botões na barra inferior. Muito útil para perguntas de "Sim" e "Não".
Recurso disponível apenas no canal Widget
Estrutura{
"default": {
"type": "quick_replies",
"payload": {
"pick": "Escolha uma opção abaixo",
"tries": 3,
"replies": [
Como utilizar o WhatsApp Flows em um chatbot de fluxos
Importante: Antes de seguir com as instruções, confirme se a funcionalidade está disponível para o seu perfil de acesso. O WhatsApp Flow só está disponível para contas NLU Enterprise e contas Zenvia Customer Cloud (ZCC) que possuem interoperabilidade habilitada. Se a sua conta não atender a esses cr
13. WhatsApp Flows Meta
Importante: O WhatsApp Flow só está disponível para contas NLU Enterprise e contas Zenvia Customer Cloud (ZCC) que possuem interoperabilidade habilitada. Se a sua conta não atender a esses critérios, a funcionalidade não estará visível na plataforma.O WhatsApp Flows possui a função de criar uma inte
02. Editar assistente
Para editar um assistente, basta clicar no ícone sinalizado com um lápis.
Em seguida, a nova tela funcionará como uma visão geral do assistente e contém as principais informações relacionadas às configurações, como:
Nome do assistente;Data e horário do último atendimento;Atualização da programação;
01. Visão geral da Biblioteca para IA
⚠️Atenção: essa funcionalidade é paga e está disponível para contratação.
Biblioteca para IA é uma funcionalidade que permite criar um chatbot generativo aplicando a inteligência do Chat GPT.
Para isso, basta utilizar um documento como base de conhecimento para que o GPT não busque insumos em sua
Integração entre ferramentas de chatbot: NLU Enterprise e Customer Cloud
Utilize recursos de NLU e Customer Cloud em seus chatbots.
A interoperabilidade entre as plataformas facilita a edição e gerenciamento dos seus chatbots, tornando mais fácil alternar entre as duas ferramentas sem comprometer a experiência de uso.
Neste artigo você aprende a como realizar a integraç
Lançamentos Setembro
Confira as novidades do mês de Setembro🚀
Reunimos aqui, os principais lançamentos e melhorias da Zenvia Customer Cloud, com foco no que impacta o seu dia a dia e ajuda você a extrair mais valor da plataforma. Navegue por jornada:
🤖Chatbot ✨ Novo
Registro de atividades no Chatbot de fluxos (Builde
02. HTTP_Request Async
O HTTP_Request async é uma opção para executar requisições assíncronas, ou seja, uma comunicação que não ocorre simultaneamente, evitando falhas ou interrupções no sistema. Com ele, é possível utilizar duas flags: async e waitTime, que podem ser adicionadas aos parâmetros da solicitação.
A flag wai
04. Introdução ao NLP
O NLP é uma das principais buzzwords do mercado atualmente, comumente associada/confundida com o conceito de chatbot em si, o NLP é Natural Language Processing ou o Processamento de Linguagem Natural.
A concepção desta tecnologia remonta à década de 1950 com Alan Turing, um dos países da comp