{ "produto": "Elor.ia", "tipo": "base de ajuda", "idioma": "pt-BR", "atualizado": "17/10/2026", "artigos": [ { "slug": "como-o-eloria-funciona", "categoria": "Comece por aqui", "titulo": "Como o Elor.ia funciona: do canal à resposta da IA", "resumo": "O mapa de peças da plataforma: canais, agentes de IA, conhecimento, functions, automações e equipe humana, e como elas se conectam.", "tags": [ "visão geral", "primeiros passos", "como funciona", "arquitetura", "mapa da plataforma", "menu", "conceitos", "glossário" ], "publico": "Donos, gestores e atendentes que estão começando.", "no_painel": [ "Dashboard" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Preciso de um agente de IA para usar o Elor.ia?", "resposta": "Não. Você pode usar apenas a caixa de Conversas com a sua equipe. O agente de IA é opcional e pode ser ligado só a alguns canais." }, { "pergunta": "Um agente pode atender em mais de um canal?", "resposta": "Sim. Em cada agente você marca os canais onde ele atua. Veja «Criar um agente de IA e ligá-lo a um canal»." }, { "pergunta": "O que é workspace?", "resposta": "É o ambiente de uma empresa dentro do Elor.ia, com seus próprios canais, agentes, contatos e equipe. Agências podem criar um workspace por cliente." } ], "problemas": [], "para_ia": { "perguntas": [ "Como o Elor.ia funciona?", "Por onde começo?", "Qual a diferença entre agente, automação e function?" ], "resposta": "O cliente escreve num canal conectado em Conexões. Se um agente de IA estiver ativo e ligado ao canal, ele responde usando instruções, base de conhecimento, FAQ e functions. Automações reagem a eventos (mensagem, palavra-chave, contato novo). Quando a IA transfere, ela pausa e a equipe atende em Conversas. Ordem recomendada: conectar canal, criar agente, ensinar o agente, só depois automações.", "escalar": [] }, "relacionados": [ "conectar-whatsapp", "criar-agente", "quando-o-agente-responde", "entender-o-dashboard", "personalizar-o-painel" ], "markdown": "---\nslug: como-o-eloria-funciona\ncategoria: Comece por aqui\natualizado: 17/10/2026\ntags: visão geral, primeiros passos, como funciona, arquitetura, mapa da plataforma, menu, conceitos, glossário\nno_painel: Dashboard\nverificacao: conferido na tela do painel\n---\n\n# Como o Elor.ia funciona: do canal à resposta da IA\n\nO mapa de peças da plataforma: canais, agentes de IA, conhecimento, functions, automações e equipe humana, e como elas se conectam.\n\n**Para quem é:** Donos, gestores e atendentes que estão começando.\n\nO Elor.ia é uma plataforma de atendimento em vários canais com agentes de IA. Tudo gira em torno de um caminho simples: o **cliente escreve em um canal**, o **agente de IA** lê a mensagem e responde, e, quando necessário, a conversa passa para uma **pessoa da equipe**.\n\n[Esquema: As peças principais e como elas conversam entre si.]\n\n## As peças, em linguagem simples\n\n| Peça | O que é | Onde fica no menu |\n|---|---|---|\n| Canal | Por onde o cliente fala com você: WhatsApp, Instagram, Messenger, Telegram, TikTok, Webchat (chat no site), Voz e E-mail. | `Conexões` |\n| Agente de IA | Quem atende. Tem instruções, modelo, conhecimento e ferramentas próprios. | `Agentes IA` |\n| Base de conhecimento e FAQ | Documentos e respostas prontas que o agente consulta. | `Agentes IA` → `Base de conhecimento` e `FAQ Inteligente` |\n| Functions | Ações que o agente executa sozinho: etiquetar, atualizar o contato, transferir, criar oportunidade, consultar um sistema. | `Agentes IA` → `Functions` |\n| Automações | Regras e fluxos que reagem a eventos. Também enviam campanhas. | `Automações` |\n| Conversas | A caixa de entrada da equipe. Aqui a pessoa assume, responde e encerra. | `Conversas` |\n| CRM | Contatos, pipelines (funil de vendas), etiquetas, campos personalizados e agendamentos. | `Contatos`, `Pipelines`, `Agendamentos`, `Personalização` |\n| Integrações | Conexão com serviços externos, como os provedores de IA, Google, pagamentos e assinatura digital. | `Integrações` |\n\n## O que acontece quando o cliente escreve\n\n1. A mensagem chega pelo **canal** conectado e aparece em `Conversas`.\n2. Se houver uma **automação** com gatilho para esse evento (por exemplo, uma palavra-chave), ela roda.\n3. Se o **agente de IA** está ativo e o canal está ligado a ele, ele junta as mensagens que chegam em sequência (o *buffer*), consulta instruções, conhecimento e functions, e escreve a resposta.\n4. A resposta volta pelo **mesmo canal**.\n5. Se o agente chama a function de transferir, a **IA pausa** naquela conversa e um atendente assume.\n\n> **Dica:** Para começar do zero, siga esta ordem: «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (artigo `conectar-whatsapp`), depois «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`), depois «Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados» (artigo `ensinar-agente`). Só então pense em automações.\n\n## Navegando pelo painel\n\nO menu lateral é dividido em blocos: **Visão geral** (Dashboard), **Operação** (Conversas, Galeria de mídias, Tarefas, Pipelines, Agendamentos, Contatos, Personalização), **Canais** (Conexões), **Automação & IA** (Agentes IA, Automações, Integrações) e **Workspace** (Equipe, Configurações, API). O botão `?` no canto da tela abre a Central de ajuda do próprio painel.\n\n## Perguntas frequentes\n\n**Preciso de um agente de IA para usar o Elor.ia?**\nNão. Você pode usar apenas a caixa de Conversas com a sua equipe. O agente de IA é opcional e pode ser ligado só a alguns canais.\n\n**Um agente pode atender em mais de um canal?**\nSim. Em cada agente você marca os canais onde ele atua. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\n**O que é workspace?**\nÉ o ambiente de uma empresa dentro do Elor.ia, com seus próprios canais, agentes, contatos e equipe. Agências podem criar um workspace por cliente.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como o Elor.ia funciona?\n- Por onde começo?\n- Qual a diferença entre agente, automação e function?\n\nResposta curta: O cliente escreve num canal conectado em Conexões. Se um agente de IA estiver ativo e ligado ao canal, ele responde usando instruções, base de conhecimento, FAQ e functions. Automações reagem a eventos (mensagem, palavra-chave, contato novo). Quando a IA transfere, ela pausa e a equipe atende em Conversas. Ordem recomendada: conectar canal, criar agente, ensinar o agente, só depois automações.\n\nVeja também: «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (`conectar-whatsapp`); «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Quando e como o agente responde: gatilho, buffer, horários e encerramento» (`quando-o-agente-responde`); «Entender o Dashboard: atendimento, negócios e anúncios» (`entender-o-dashboard`); «Personalizar o painel: tema, idioma e perfil» (`personalizar-o-painel`)\n" }, { "slug": "conectar-whatsapp", "categoria": "Canais e conexões", "titulo": "Conectar o WhatsApp: API Oficial, Coexistência ou QR Code", "resumo": "Compare os três métodos de conexão, escolha o ideal para o seu volume e saiba o que muda depois de conectar.", "tags": [ "whatsapp", "zap", "api oficial", "meta", "coexistência", "coex", "qr code", "conectar número", "business manager", "cloud api", "waba", "pareamento" ], "publico": "Donos e administradores que vão ligar o número da empresa.", "no_painel": [ "Conexões", "WhatsApp Business" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Posso trocar de método depois?", "resposta": "Sim. A própria tela informa que você pode trocar o método depois, mas precisa começar por um." }, { "pergunta": "Posso usar o mesmo número no celular e no Elor.ia?", "resposta": "Sim, com Coexistência ou QR Code. Na API Oficial o número sai do app do celular." }, { "pergunta": "Qual método é o recomendado?", "resposta": "A tela marca a API Oficial Meta como recomendada para escala, templates aprovados e disparos em massa." }, { "pergunta": "Disparo em massa no QR Code é seguro?", "resposta": "A tela avisa que aceitar disparo em massa pelo QR Code pode bloquear o número. Para campanhas, prefira API Oficial ou Coexistência." } ], "problemas": [ { "sintoma": "A IA parou de responder depois de reconectar o WhatsApp", "causa": "Ao reconectar pelo QR Code, o número vira uma conexão nova e o agente fica desvinculado, sem aviso.", "solucao": "Abra o agente, aba O agente, marque o canal novo e salve." }, { "sintoma": "Mensagem aparece com status “falhou” (WhatsApp pelo celular)", "causa": "A sessão do celular desconectou.", "solucao": "Em Conexões, reconecte lendo o QR Code de novo. Depois confira agente, automações e avisos internos." }, { "sintoma": "O campo de resposta fica bloqueado na API Oficial", "causa": "A janela de 24 horas fechou.", "solucao": "Reabra a conversa com um template aprovado. Veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial»." }, { "sintoma": "Template recusado ou parado", "causa": "O template não está aprovado ou o nome e idioma não batem.", "solucao": "Confira o status na página de templates: precisa estar aprovado, com nome e idioma exatos." } ], "para_ia": { "perguntas": [ "Como conecto meu WhatsApp?", "Qual a diferença entre API oficial, coexistência e QR Code?", "Meu número vai sair do celular?", "A IA parou depois que reconectei o WhatsApp" ], "resposta": "Em Conexões, clique em WhatsApp Business e escolha: API Oficial Meta (recomendada para escala; o número sai do app do celular), Coexistência (o número continua no app e ganha automação) ou QR Code (rápido, bom para volume baixo; disparo em massa pode bloquear o número). API Oficial e Coexistência exigem Business Manager no Facebook. Depois de conectar, marque o canal no agente de IA. Se reconectou por QR, o canal é novo e o agente precisa ser religado.", "escalar": [ "Falha na autorização da Meta ou no Business Manager", "Número bloqueado ou banido" ] }, "relacionados": [ "criar-agente", "janela-24-horas", "disparo-em-massa", "templates-whatsapp", "whatsapp-api-oficial", "whatsapp-qr-code" ], "markdown": "---\nslug: conectar-whatsapp\ncategoria: Canais e conexões\natualizado: 17/10/2026\ntags: whatsapp, zap, api oficial, meta, coexistência, coex, qr code, conectar número, business manager, cloud api, waba, pareamento\nno_painel: Conexões > WhatsApp Business\nverificacao: conferido na tela do painel\n---\n\n# Conectar o WhatsApp: API Oficial, Coexistência ou QR Code\n\nCompare os três métodos de conexão, escolha o ideal para o seu volume e saiba o que muda depois de conectar.\n\n**Para quem é:** Donos e administradores que vão ligar o número da empresa.\n\n**Antes de começar:**\n- Acesso de administrador no workspace\n- Para API Oficial e Coexistência: Business Manager no Facebook\n- Para API Oficial: um número de telefone dedicado\n\nO Elor.ia oferece três formas de conectar o WhatsApp. A tela **Conectar WhatsApp** apresenta as três lado a lado, com o que cada uma entrega e o que exige. Você pode trocar de método depois, mas precisa começar por um.\n\n[Imagem: Tela Conectar WhatsApp com três cartões: API Oficial Meta, Coexistência (COEX) e QR Code. Os três métodos. (1) API Oficial Meta, marcada como recomendada. (2) Coexistência. (3) QR Code. (4) Aviso importante sobre o número na API Oficial.]\n\n## Qual método escolher\n\n| | API Oficial Meta | Coexistência (COEX) | QR Code |\n|---|---|---|---|\n| Para quem | Quem quer escala e campanhas | Quem quer automação sem largar o app do celular | Quem quer começar rápido, volume baixo |\n| O número no celular | **Sai** do app do WhatsApp permanentemente | Continua funcionando no app | Continua no app (espelhado) |\n| Disparos em massa | Sim, sem travar o número | Sim, com templates | Possível, mas pode bloquear o número |\n| Templates aprovados pela Meta | Sim | Sim (marketing tem limites iniciais) | Não se aplica |\n| Múltiplos atendentes ao mesmo tempo | Sim | Atendimento misto: manual e automatizado | Depende da sessão do celular |\n| Pré-requisitos | Business Manager, número dedicado | Business Manager, app WhatsApp Business atualizado | Celular com WhatsApp Business e conexão estável |\n\n> **Atenção:** Na **API Oficial**, o número deixa de funcionar no app do WhatsApp do celular. Se você ainda usa esse número no dia a dia, escolha **Coexistência** ou use um número novo.\n\n## Passo a passo\n\n1. No menu lateral, abra `Conexões`. A tela **Canais** mostra os cartões de cada canal.\n2. Clique em **WhatsApp Business**. Abre a tela *Conectar WhatsApp*.\n3. Escolha o método e clique em **Conectar via API**, **Conectar via Coexistência** ou **Conectar via QR**. O painel conduz você pelas etapas de cada um.\n4. No QR Code, você lê o código com o celular ou digita um código de pareamento. Na API Oficial e na Coexistência, você autoriza o número na sua conta Meta.\n5. Depois de conectado, **ligue o canal ao seu agente de IA**. Sem esse passo, a IA não responde nesse número. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\n> **Bom saber:** Este artigo cobre a escolha do método e o que fazer antes e depois. As telas de cada etapa de autorização ainda não foram capturadas e serão adicionadas em uma próxima revisão.\n\n## Depois de conectar: o que conferir\n\n- O canal aparece como conectado em `Conexões`.\n- O agente de IA tem o canal marcado em *Canais onde o agente atua* (aba **O agente**).\n- Se você reconectou um número por QR Code, ele virou uma **conexão nova**: marque o novo canal no agente e confira automações e avisos que apontavam para o antigo.\n\n## Não funcionou?\n\n- **Sintoma:** A IA parou de responder depois de reconectar o WhatsApp\n - Causa provável: Ao reconectar pelo QR Code, o número vira uma conexão nova e o agente fica desvinculado, sem aviso.\n - O que fazer: Abra o agente, aba **O agente**, marque o canal novo e salve.\n- **Sintoma:** Mensagem aparece com status “falhou” (WhatsApp pelo celular)\n - Causa provável: A sessão do celular desconectou.\n - O que fazer: Em `Conexões`, reconecte lendo o QR Code de novo. Depois confira agente, automações e avisos internos.\n- **Sintoma:** O campo de resposta fica bloqueado na API Oficial\n - Causa provável: A janela de 24 horas fechou.\n - O que fazer: Reabra a conversa com um template aprovado. Veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (artigo `janela-24-horas`).\n- **Sintoma:** Template recusado ou parado\n - Causa provável: O template não está aprovado ou o nome e idioma não batem.\n - O que fazer: Confira o status na página de templates: precisa estar **aprovado**, com nome e idioma exatos.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Posso trocar de método depois?**\nSim. A própria tela informa que você pode trocar o método depois, mas precisa começar por um.\n\n**Posso usar o mesmo número no celular e no Elor.ia?**\nSim, com Coexistência ou QR Code. Na API Oficial o número sai do app do celular.\n\n**Qual método é o recomendado?**\nA tela marca a API Oficial Meta como **recomendada** para escala, templates aprovados e disparos em massa.\n\n**Disparo em massa no QR Code é seguro?**\nA tela avisa que aceitar disparo em massa pelo QR Code pode bloquear o número. Para campanhas, prefira API Oficial ou Coexistência.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como conecto meu WhatsApp?\n- Qual a diferença entre API oficial, coexistência e QR Code?\n- Meu número vai sair do celular?\n- A IA parou depois que reconectei o WhatsApp\n\nResposta curta: Em Conexões, clique em WhatsApp Business e escolha: API Oficial Meta (recomendada para escala; o número sai do app do celular), Coexistência (o número continua no app e ganha automação) ou QR Code (rápido, bom para volume baixo; disparo em massa pode bloquear o número). API Oficial e Coexistência exigem Business Manager no Facebook. Depois de conectar, marque o canal no agente de IA. Se reconectou por QR, o canal é novo e o agente precisa ser religado.\n\nEscalar para um humano quando:\n- Falha na autorização da Meta ou no Business Manager\n- Número bloqueado ou banido\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (`janela-24-horas`); «Criar um disparo em massa e acompanhar o envio» (`disparo-em-massa`); «Criar e aprovar templates do WhatsApp oficial» (`templates-whatsapp`); «Conectar o WhatsApp pela API Oficial Meta ou pela coexistência» (`whatsapp-api-oficial`); «Conectar um número de WhatsApp pelo QR Code» (`whatsapp-qr-code`)\n" }, { "slug": "janela-24-horas", "categoria": "Conversas", "titulo": "Por que não consigo responder? A janela de 24 horas do WhatsApp oficial", "resumo": "Entenda por que o campo de mensagem bloqueia na API Oficial e como retomar a conversa com um template aprovado.", "tags": [ "24 horas", "janela", "template", "campo bloqueado", "não consigo responder", "whatsapp oficial", "meta", "reabrir conversa", "follow-up", "texto livre" ], "publico": "Atendentes e administradores que usam a API Oficial do WhatsApp.", "no_painel": [ "Conversas" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "A janela vale para a Coexistência também?", "resposta": "A regra de templates é da Meta para o WhatsApp oficial. O próprio painel informa que a Coexistência usa Cloud API e templates aprovados; confira o canal da conversa." }, { "pergunta": "A IA responde fora das 24 horas?", "resposta": "No WhatsApp oficial, texto livre fora da janela é recusado, inclusive o enviado pelo agente. Fora da janela, só template aprovado." }, { "pergunta": "Por quanto tempo vale a janela?", "resposta": "24 horas a partir da última mensagem do cliente." } ], "problemas": [ { "sintoma": "Template não aparece ou não envia", "causa": "O template não está aprovado, ou nome e idioma não conferem.", "solucao": "Abra a página de templates da conexão e confirme o status aprovado." }, { "sintoma": "O follow-up automático não saiu no WhatsApp oficial", "causa": "Follow-up de texto não sai fora da janela.", "solucao": "Monte os passos do follow-up com template aprovado." }, { "sintoma": "O cliente respondeu, mas o campo continua bloqueado", "causa": "A mensagem pode ter chegado em outra conversa ou canal.", "solucao": "Confira o contato e o canal da conversa aberta." } ], "para_ia": { "perguntas": [ "Por que o campo de mensagem está bloqueado?", "Não consigo responder o cliente no WhatsApp", "O que é a janela de 24 horas?", "Como retomar uma conversa antiga?" ], "resposta": "Na API Oficial do WhatsApp, só dá para escrever livremente por 24 horas depois da última mensagem do cliente. Passado esse prazo, o campo bloqueia e só é possível enviar um template aprovado pela Meta. Quando o cliente responde, a janela reabre. Instagram, Messenger, Webchat e Telegram não iniciam conversa.", "escalar": [ "Template aprovado que não envia", "Suspeita de falha da plataforma" ] }, "relacionados": [ "conectar-whatsapp", "disparo-em-massa", "outros-problemas-comuns", "instagram-e-messenger", "templates-whatsapp" ], "markdown": "---\nslug: janela-24-horas\ncategoria: Conversas\natualizado: 17/10/2026\ntags: 24 horas, janela, template, campo bloqueado, não consigo responder, whatsapp oficial, meta, reabrir conversa, follow-up, texto livre\nno_painel: Conversas\nverificacao: baseado no guia oficial do painel\n---\n\n# Por que não consigo responder? A janela de 24 horas do WhatsApp oficial\n\nEntenda por que o campo de mensagem bloqueia na API Oficial e como retomar a conversa com um template aprovado.\n\n**Para quem é:** Atendentes e administradores que usam a API Oficial do WhatsApp.\n\n**Antes de começar:**\n- Número conectado pela API Oficial Meta ou Coexistência\n- Ao menos um template aprovado pela Meta\n\nNo WhatsApp pela **API Oficial**, a Meta limita quando a empresa pode escrever livremente. Depois que o cliente envia uma mensagem, você tem **24 horas** para responder com texto, imagem, áudio ou documento. Passado esse prazo, a janela fecha e o campo de mensagem fica bloqueado.\n\n[Esquema: A janela de 24 horas começa na última mensagem do cliente.]\n\n## O que vale dentro e fora da janela\n\n| Situação | O que você pode enviar |\n|---|---|\n| Dentro das 24 horas da última mensagem do cliente | Texto livre, mídia e documentos. |\n| Fora das 24 horas | Somente **template aprovado pela Meta**. |\n| Empresa iniciando a conversa | Somente template aprovado. |\n\n> **Atenção:** Texto livre enviado fora da janela é **recusado** pela Meta. Isso vale também para follow-up, lembretes e disparos.\n\n## Como retomar uma conversa com a janela fechada\n\n1. Abra a conversa em `Conversas`.\n2. Escolha um **template aprovado** e envie para o contato.\n3. Quando o cliente responder, a janela abre de novo por 24 horas e você volta a escrever livremente.\n\n> **Dica:** Mantenha os templates mais usados (retorno, lembrete, pesquisa) aprovados com antecedência. Template em análise ou recusado não pode ser usado.\n\n## Em outros canais\n\nInstagram, Messenger, Webchat e Telegram **não iniciam conversa**: eles só respondem a quem escreveu primeiro. Para avisar o cliente depois, use e-mail, SMS ou WhatsApp com template.\n\n## Não funcionou?\n\n- **Sintoma:** Template não aparece ou não envia\n - Causa provável: O template não está aprovado, ou nome e idioma não conferem.\n - O que fazer: Abra a página de templates da conexão e confirme o status **aprovado**.\n- **Sintoma:** O follow-up automático não saiu no WhatsApp oficial\n - Causa provável: Follow-up de texto não sai fora da janela.\n - O que fazer: Monte os passos do follow-up com template aprovado.\n- **Sintoma:** O cliente respondeu, mas o campo continua bloqueado\n - Causa provável: A mensagem pode ter chegado em outra conversa ou canal.\n - O que fazer: Confira o contato e o canal da conversa aberta.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**A janela vale para a Coexistência também?**\nA regra de templates é da Meta para o WhatsApp oficial. O próprio painel informa que a Coexistência usa Cloud API e templates aprovados; confira o canal da conversa.\n\n**A IA responde fora das 24 horas?**\nNo WhatsApp oficial, texto livre fora da janela é recusado, inclusive o enviado pelo agente. Fora da janela, só template aprovado.\n\n**Por quanto tempo vale a janela?**\n24 horas a partir da última mensagem do cliente.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Por que o campo de mensagem está bloqueado?\n- Não consigo responder o cliente no WhatsApp\n- O que é a janela de 24 horas?\n- Como retomar uma conversa antiga?\n\nResposta curta: Na API Oficial do WhatsApp, só dá para escrever livremente por 24 horas depois da última mensagem do cliente. Passado esse prazo, o campo bloqueia e só é possível enviar um template aprovado pela Meta. Quando o cliente responde, a janela reabre. Instagram, Messenger, Webchat e Telegram não iniciam conversa.\n\nEscalar para um humano quando:\n- Template aprovado que não envia\n- Suspeita de falha da plataforma\n\nVeja também: «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (`conectar-whatsapp`); «Criar um disparo em massa e acompanhar o envio» (`disparo-em-massa`); «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (`outros-problemas-comuns`); «Conectar o Instagram e o Messenger do Facebook» (`instagram-e-messenger`); «Criar e aprovar templates do WhatsApp oficial» (`templates-whatsapp`)\n" }, { "slug": "criar-agente", "categoria": "Agentes de IA", "titulo": "Criar um agente de IA e ligá-lo a um canal", "resumo": "Do botão Novo agente até a primeira resposta: escolha o tipo, escreva as instruções, ligue o canal e teste antes de ativar.", "tags": [ "agente", "novo agente", "criar agente", "ia", "assistente", "instruções", "prompt", "canal", "ativar", "testar agente", "atendimento a clientes", "agente interno", "limite de agentes" ], "publico": "Administradores que vão configurar o atendimento com IA.", "no_painel": [ "Agentes IA" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Qual a diferença entre Atendimento a clientes e Agente interno?", "resposta": "O agente de atendimento atende clientes nos canais conectados. O agente interno é exclusivo da equipe, no chat interno, sem canais externos." }, { "pergunta": "Posso testar sem ativar?", "resposta": "Sim. O botão Testar agente, no topo do editor, abre uma conversa de teste." }, { "pergunta": "Um agente atende em mais de um canal?", "resposta": "Sim. Marque todos os canais desejados na seção O agente." }, { "pergunta": "Quantos agentes posso ter?", "resposta": "Depende do plano. O contador no topo da lista mostra usados e disponíveis, somando agentes de IA e de voz." } ], "problemas": [ { "sintoma": "Criei o agente e ele não responde", "causa": "O agente está desativado, o canal não está marcado ou há outra causa.", "solucao": "Siga «A IA não responde: diagnóstico passo a passo» na ordem." }, { "sintoma": "Não consigo criar outro agente", "causa": "O limite do plano foi atingido (agentes de IA e de voz somam no mesmo limite).", "solucao": "Confira o contador no topo da lista. Exclua ou reaproveite um agente, ou fale com o suporte sobre o plano." }, { "sintoma": "Perdi o que editei", "causa": "Saiu da página sem clicar em Salvar.", "solucao": "Refaça a alteração e clique em Salvar antes de sair." } ], "para_ia": { "perguntas": [ "Como criar um agente de IA?", "Como ligo o agente ao WhatsApp?", "Qual a diferença entre agente interno e de atendimento?", "Não consigo criar mais agentes" ], "resposta": "Em Agentes IA, clique em Novo agente, escolha Atendimento a clientes ou Agente interno e continue. No editor, preencha O agente (nome, descrição, fuso horário e canais onde atua), escreva as Instruções, escolha o Modelo, configure Conversa, Filtros e Encerramento, vincule Conhecimento e FAQ, teste com Testar agente, salve e ative pela chave na lista. O canal precisa estar marcado no agente para a IA responder. O limite de agentes é do plano e soma agentes de IA e de voz.", "escalar": [ "Dúvida sobre limite ou upgrade de plano", "Pedido para alguém configurar no lugar do cliente" ] }, "relacionados": [ "quando-o-agente-responde", "modelo-do-agente", "ensinar-agente", "functions-do-agente", "chat-no-site", "agentes-de-voz-e-ligacoes" ], "markdown": "---\nslug: criar-agente\ncategoria: Agentes de IA\natualizado: 17/10/2026\ntags: agente, novo agente, criar agente, ia, assistente, instruções, prompt, canal, ativar, testar agente, atendimento a clientes, agente interno, limite de agentes\nno_painel: Agentes IA\nverificacao: conferido na tela do painel\n---\n\n# Criar um agente de IA e ligá-lo a um canal\n\nDo botão Novo agente até a primeira resposta: escolha o tipo, escreva as instruções, ligue o canal e teste antes de ativar.\n\n**Para quem é:** Administradores que vão configurar o atendimento com IA.\n\n**Antes de começar:**\n- Um canal conectado (veja «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (artigo `conectar-whatsapp`))\n- Um provedor de IA conectado em Integrações (veja «Conectar um provedor de IA e outras integrações» (artigo `integracoes-e-provedores-de-ia`))\n\nUm agente de IA é quem atende o cliente por você. Cada agente tem **identidade**, **instruções**, **modelo**, **conhecimento** e **ferramentas** próprios, e atua nos canais que você marcar.\n\n## Conhecendo a lista de agentes\n\n[Imagem: Lista de agentes de IA com o botão Novo agente e o contador de agentes usados. (1) Novo agente. (2) Editar. (3) Chave que ativa ou desativa o agente. Cada linha mostra modelo, gatilho, buffer e quantidade de canais.]\n\nNo topo aparece o contador do plano, por exemplo **“4 de 7 usados · 3 disponíveis”**. O limite é **compartilhado entre agentes de IA e de voz**.\n\n## Passo a passo\n\n1. Abra `Agentes IA` e clique em **Novo agente**.\n - [Imagem: Janela Novo agente, etapa 1 de 2, com as opções Atendimento a clientes e Agente interno. Etapa 1 de 2: (1) Atendimento a clientes, para canais conectados ao workspace. (2) Agente interno, só para a equipe no chat interno.]\n2. Escolha o tipo e clique em **Continuar** para a etapa 2.\n3. Abra o agente pelo ícone de lápis. O editor tem um menu à esquerda com as seções do agente: **O agente, Instruções, Modelo, Conversa, Filtros, Encerramento, Ferramentas, Skills, Conhecimento, FAQ Inteligente e Aprendizados**.\n - [Imagem: Editor do agente, seção O agente, com nome, descrição interna e fuso horário. (1) Menu de seções. (2) Testar agente. (3) Salvar. Em O agente você define nome, descrição interna, fuso horário e os canais onde ele atua.]\n4. Em **O agente**, dê um nome, escreva a descrição interna e confirme o fuso horário. Ele define a data e a hora que o agente enxerga e resolve as variáveis `{{current_date}}`, `{{current_time}}` e `{{current_weekday}}`.\n5. Marque os **canais** onde o agente atua. Para a IA responder sozinha, o canal precisa estar marcado e ser o principal.\n6. Em **Instruções**, escreva como o agente deve atender (veja abaixo).\n - [Imagem: Seção Instruções com o campo de system prompt, modos Guiado e Avançado e botão Melhorar com IA. (1) Campo da instrução do agente. (2) Alternância entre modo Guiado e Avançado. Há também o botão Melhorar com IA.]\n7. Clique em **Testar agente** (no topo) para conversar com ele antes de ligar.\n8. Clique em **Salvar** e, quando estiver pronto, ligue a chave de ativação na lista de agentes.\n\n> **Atenção:** O botão **Salvar** grava as alterações de todas as seções do agente. Se você sair da página sem salvar, as mudanças se perdem.\n\n## Como escrever boas instruções\n\n- **Quem é o agente e para quem atende.** Nome, empresa, tom de voz e objetivo da conversa.\n- **O que ele não faz.** Por exemplo: não diagnostica, não promete prazo, não confirma horário sem a equipe.\n- **Quando transferir.** Descreva os casos em uma linha clara: pedido de falar com uma pessoa, urgência, reclamação.\n- **Como escrever.** Mensagens curtas, uma pergunta por vez, sem formatação que o canal não renderiza.\n- **Regras de silêncio.** Reação com emoji ou “obrigado” depois do assunto resolvido não precisa de resposta.\n\n> **Dica:** Escreva instruções que o agente consiga cumprir com o que ele tem. Se pedir para salvar dados, ligue a function de atualizar contato (veja «Dar ações ao agente com Functions» (artigo `functions-do-agente`)); se pedir para consultar documentos, vincule a base («Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados» (artigo `ensinar-agente`)).\n\n## Não funcionou?\n\n- **Sintoma:** Criei o agente e ele não responde\n - Causa provável: O agente está desativado, o canal não está marcado ou há outra causa.\n - O que fazer: Siga «A IA não responde: diagnóstico passo a passo» (artigo `ia-nao-responde`) na ordem.\n- **Sintoma:** Não consigo criar outro agente\n - Causa provável: O limite do plano foi atingido (agentes de IA e de voz somam no mesmo limite).\n - O que fazer: Confira o contador no topo da lista. Exclua ou reaproveite um agente, ou fale com o suporte sobre o plano.\n- **Sintoma:** Perdi o que editei\n - Causa provável: Saiu da página sem clicar em Salvar.\n - O que fazer: Refaça a alteração e clique em **Salvar** antes de sair.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Qual a diferença entre Atendimento a clientes e Agente interno?**\nO agente de atendimento atende clientes nos canais conectados. O agente interno é exclusivo da equipe, no chat interno, sem canais externos.\n\n**Posso testar sem ativar?**\nSim. O botão **Testar agente**, no topo do editor, abre uma conversa de teste.\n\n**Um agente atende em mais de um canal?**\nSim. Marque todos os canais desejados na seção **O agente**.\n\n**Quantos agentes posso ter?**\nDepende do plano. O contador no topo da lista mostra usados e disponíveis, somando agentes de IA e de voz.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como criar um agente de IA?\n- Como ligo o agente ao WhatsApp?\n- Qual a diferença entre agente interno e de atendimento?\n- Não consigo criar mais agentes\n\nResposta curta: Em Agentes IA, clique em Novo agente, escolha Atendimento a clientes ou Agente interno e continue. No editor, preencha O agente (nome, descrição, fuso horário e canais onde atua), escreva as Instruções, escolha o Modelo, configure Conversa, Filtros e Encerramento, vincule Conhecimento e FAQ, teste com Testar agente, salve e ative pela chave na lista. O canal precisa estar marcado no agente para a IA responder. O limite de agentes é do plano e soma agentes de IA e de voz.\n\nEscalar para um humano quando:\n- Dúvida sobre limite ou upgrade de plano\n- Pedido para alguém configurar no lugar do cliente\n\nVeja também: «Quando e como o agente responde: gatilho, buffer, horários e encerramento» (`quando-o-agente-responde`); «Escolher o modelo e ajustar temperatura, tokens e histórico» (`modelo-do-agente`); «Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados» (`ensinar-agente`); «Dar ações ao agente com Functions» (`functions-do-agente`); «Colocar o chat no seu site (Webchat)» (`chat-no-site`); «Agentes de voz: atender e fazer ligações com IA» (`agentes-de-voz-e-ligacoes`)\n" }, { "slug": "quando-o-agente-responde", "categoria": "Agentes de IA", "titulo": "Quando e como o agente responde: gatilho, buffer, horários e encerramento", "resumo": "Controle em que momentos a IA responde, como ela junta mensagens em sequência, a quem ela atende e o que acontece quando o cliente some.", "tags": [ "buffer", "gatilho", "toda mensagem", "apenas monitorar", "horário de atendimento", "filtro", "etiqueta", "transferência", "inatividade", "encerramento", "pausar ia", "sob demanda", "mensagens picadas" ], "publico": "Administradores que ajustam o comportamento do agente.", "no_painel": [ "Agentes IA", "(agente)", "Conversa · Filtros · Encerramento" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Qual o intervalo do buffer?", "resposta": "De 5 a 20 segundos. A tela mostra o valor atual, por exemplo “Tempo de Buffer: 8s”." }, { "pergunta": "O que significa “Apenas monitorar”?", "resposta": "O agente executa ações, como etiquetar e salvar dados, mas não responde ao cliente." }, { "pergunta": "A IA continua depois que um atendente assume?", "resposta": "Não. Quando um atendente assume ou a IA transfere, ela pausa naquela conversa. Para retomar, reative a IA na própria conversa." } ], "problemas": [ { "sintoma": "A IA responde quando não devia (emoji, “obrigado”, conversa concluída)", "causa": "Reação ou mensagem nova em conversa concluída pode acordar a IA.", "solucao": "Inclua nas instruções: silêncio para cortesia e reação depois do assunto resolvido, e sair de cena quando um humano já respondeu." }, { "sintoma": "A IA não responde fora do expediente", "causa": "O filtro de atendimento limita dia e horário.", "solucao": "Desligue o filtro ou ajuste a janela em Filtros." }, { "sintoma": "Mensagens picadas ou respostas lentas", "causa": "Buffer, atraso de digitação e divisão de mensagem estão configurados.", "solucao": "Ajuste em Conversa. Divisão muito curta quebra links." }, { "sintoma": "A IA não responde para alguns contatos", "causa": "Filtro por etiqueta ligado.", "solucao": "Aplique a etiqueta ao contato ou desligue o filtro." } ], "para_ia": { "perguntas": [ "Como faço a IA responder só em horário comercial?", "O que é o buffer?", "Como a IA para de responder fora do horário?", "A IA só deve atender contatos com uma etiqueta" ], "resposta": "No editor do agente: em Conversa você define se o agente responde ou apenas monitora e o buffer (5 a 20 s) que agrupa mensagens seguidas. Em Filtros você limita o atendimento da IA por dia e horário, limita as transferências para humano e pode restringir a contatos com certas etiquetas. Em Encerramento você ativa o fechamento por inatividade. Ao assumir, o atendente pausa a IA naquela conversa.", "escalar": [ "Comportamento que contradiz a configuração", "IA escreveu em inglês, entre parênteses ou pensando alto (prioridade alta, com print)" ] }, "relacionados": [ "criar-agente", "ia-nao-responde", "outros-problemas-comuns" ], "markdown": "---\nslug: quando-o-agente-responde\ncategoria: Agentes de IA\natualizado: 17/10/2026\ntags: buffer, gatilho, toda mensagem, apenas monitorar, horário de atendimento, filtro, etiqueta, transferência, inatividade, encerramento, pausar ia, sob demanda, mensagens picadas\nno_painel: Agentes IA > (agente) > Conversa · Filtros · Encerramento\nverificacao: conferido na tela do painel\n---\n\n# Quando e como o agente responde: gatilho, buffer, horários e encerramento\n\nControle em que momentos a IA responde, como ela junta mensagens em sequência, a quem ela atende e o que acontece quando o cliente some.\n\n**Para quem é:** Administradores que ajustam o comportamento do agente.\n\n**Antes de começar:**\n- Um agente criado (veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`))\n\nTrês seções do editor do agente decidem **quando** ele responde: **Conversa**, **Filtros** e **Encerramento**. Na seção **O agente**, o bloco *Quando o agente deve responder* define o gatilho. Por padrão, em mensagens diretas e canais monitorados, o agente responde a **toda mensagem** enquanto a IA não estiver pausada.\n\n## Conversa: modo de atuação e buffer\n\n[Imagem: Seção Conversa com Apenas monitorar e Buffer de mensagens. (1) Apenas monitorar. (2) Habilitar buffer de mensagens. (3) Tempo de buffer, de 5 a 20 segundos.]\n\n| Opção | O que faz | Quando usar |\n|---|---|---|\n| **Apenas monitorar (não responder ao cliente)** | O agente observa a conversa e executa ações (etiquetas, dados do contato, qualificação, notas, oportunidades), mas **não envia nenhuma resposta** de texto ou áudio. | Quando você quer classificar e registrar, mas deixar a resposta para a equipe. |\n| **Habilitar buffer de mensagens** | Espera alguns segundos para agrupar mensagens enviadas em sequência. Elas viram um único turno, em ordem original. | Clientes que escrevem várias mensagens curtas seguidas. |\n| **Tempo de buffer** | De **5 a 20 segundos**. Quanto maior, menos respostas picadas; quanto menor, mais rápida a resposta. | Comece em 8 segundos e ajuste. |\n\nAinda nesta seção ficam o atraso de digitação e a divisão da resposta em várias mensagens. Divisão muito curta pode quebrar links e dar à conversa cara de robô.\n\n## Filtros: horário, transferência e etiqueta\n\n[Imagem: Seção Filtros com três filtros: atendimento da IA, transferência para humano e etiqueta. (1) Limitar atendimento da IA por dia e horário. (2) Limitar transferências por dia e horário. (3) Filtro por etiqueta.]\n\n| Filtro | O que faz |\n|---|---|\n| **Filtro de atendimento da IA** | Define dias e horários em que a IA responde. Fora da janela, a IA não responde e, opcionalmente, envia uma mensagem fixa. |\n| **Filtro de transferência para humano** | Define quando a IA pode pausar e entregar a conversa à equipe. Fora da janela, a IA continua ativa e informa que a equipe está indisponível. |\n| **Filtro por etiqueta** | Com o filtro ligado, o agente só atende conversas cujo contato tem as etiquetas selecionadas. |\n\n> **Atenção:** Com o filtro por etiqueta ligado, contatos **sem** a etiqueta ficam sem resposta da IA. Se a IA “sumiu” para alguns contatos, confira este filtro.\n\n## Encerramento por inatividade\n\n[Imagem: Seção Encerramento com a chave Ativar encerramento por inatividade. (1) Ativar encerramento por inatividade.]\n\nQuando a IA responde e o contato não volta dentro do tempo configurado, a ação escolhida é executada. Ela só atua em **conversa aberta, atendida por este agente, sem pausa da IA, sem atendente humano e sem automação em andamento**. Conversa já transferida fica de fora. Se a ação for *enviar despedida e resolver*, a despedida é sempre enviada.\n\n## Passo a passo para ajustar\n\n1. Abra `Agentes IA`, clique no lápis do agente.\n2. Em **Conversa**, decida se ele responde ou só monitora e ajuste o buffer.\n3. Em **Filtros**, ligue o que precisar e preencha dias, horários ou etiquetas.\n4. Em **Encerramento**, ative o encerramento por inatividade se quiser fechar conversas paradas.\n5. Clique em **Salvar** e teste mandando uma mensagem de um número de teste.\n\n## Não funcionou?\n\n- **Sintoma:** A IA responde quando não devia (emoji, “obrigado”, conversa concluída)\n - Causa provável: Reação ou mensagem nova em conversa concluída pode acordar a IA.\n - O que fazer: Inclua nas instruções: silêncio para cortesia e reação depois do assunto resolvido, e sair de cena quando um humano já respondeu.\n- **Sintoma:** A IA não responde fora do expediente\n - Causa provável: O filtro de atendimento limita dia e horário.\n - O que fazer: Desligue o filtro ou ajuste a janela em **Filtros**.\n- **Sintoma:** Mensagens picadas ou respostas lentas\n - Causa provável: Buffer, atraso de digitação e divisão de mensagem estão configurados.\n - O que fazer: Ajuste em **Conversa**. Divisão muito curta quebra links.\n- **Sintoma:** A IA não responde para alguns contatos\n - Causa provável: Filtro por etiqueta ligado.\n - O que fazer: Aplique a etiqueta ao contato ou desligue o filtro.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Qual o intervalo do buffer?**\nDe 5 a 20 segundos. A tela mostra o valor atual, por exemplo “Tempo de Buffer: 8s”.\n\n**O que significa “Apenas monitorar”?**\nO agente executa ações, como etiquetar e salvar dados, mas não responde ao cliente.\n\n**A IA continua depois que um atendente assume?**\nNão. Quando um atendente assume ou a IA transfere, ela pausa naquela conversa. Para retomar, reative a IA na própria conversa.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como faço a IA responder só em horário comercial?\n- O que é o buffer?\n- Como a IA para de responder fora do horário?\n- A IA só deve atender contatos com uma etiqueta\n\nResposta curta: No editor do agente: em Conversa você define se o agente responde ou apenas monitora e o buffer (5 a 20 s) que agrupa mensagens seguidas. Em Filtros você limita o atendimento da IA por dia e horário, limita as transferências para humano e pode restringir a contatos com certas etiquetas. Em Encerramento você ativa o fechamento por inatividade. Ao assumir, o atendente pausa a IA naquela conversa.\n\nEscalar para um humano quando:\n- Comportamento que contradiz a configuração\n- IA escreveu em inglês, entre parênteses ou pensando alto (prioridade alta, com print)\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «A IA não responde: diagnóstico passo a passo» (`ia-nao-responde`); «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (`outros-problemas-comuns`)\n" }, { "slug": "modelo-do-agente", "categoria": "Agentes de IA", "titulo": "Escolher o modelo e ajustar temperatura, tokens e histórico", "resumo": "O que cada campo da aba Modelo faz, qual valor usar e por que modelos de pensamento precisam de mais tokens de resposta.", "tags": [ "modelo", "temperatura", "tokens", "máx tokens de resposta", "janela de histórico", "fallback", "modelo de pensamento", "gpt", "criatividade", "resposta cortada", "truncada" ], "publico": "Administradores e quem otimiza custo e qualidade.", "no_painel": [ "Agentes IA", "(agente)", "Modelo" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Quanto custa aumentar o máximo de tokens?", "resposta": "A própria tela informa que é um teto e que paga-se só o que for gerado." }, { "pergunta": "O fallback cobre chave inválida?", "resposta": "Não. Erros de autenticação não disparam o fallback." }, { "pergunta": "Qual temperatura usar?", "resposta": "0 é determinístico e 2 é mais criativo. Para atendimento, valores baixos mantêm respostas consistentes." } ], "problemas": [ { "sintoma": "A resposta chega cortada ou vazia", "causa": "Máx. tokens de resposta abaixo do mínimo recomendado para o modelo.", "solucao": "Aumente o valor até o recomendado e salve." }, { "sintoma": "Todos os atendimentos falharam de uma vez", "causa": "Chave do provedor sem saldo, revogada ou inativa, sem fallback configurado.", "solucao": "Confira em Integrações e configure um fallback de outro provedor. Veja «Conectar um provedor de IA e outras integrações»." }, { "sintoma": "O agente inventa respostas", "causa": "Temperatura alta ou falta de conhecimento.", "solucao": "Reduza a temperatura e vincule base e FAQ. Veja «Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados»." } ], "para_ia": { "perguntas": [ "Qual modelo escolher?", "Minha resposta vem cortada", "O que é fallback?", "O que é temperatura?" ], "resposta": "Na aba Modelo você escolhe o modelo, um fallback opcional (usado quando o principal falha com limite de uso, tempo esgotado ou erro do servidor; chave inválida não aciona), a temperatura (0 determinístico, 2 criativo), o máximo de tokens de resposta e a janela de histórico. Modelos de pensamento precisam de mais tokens de resposta; abaixo do mínimo recomendado a resposta pode vir cortada ou vazia.", "escalar": [ "Falhas em todos os atendimentos com chave válida" ] }, "relacionados": [ "criar-agente", "integracoes-e-provedores-de-ia", "ia-nao-responde" ], "markdown": "---\nslug: modelo-do-agente\ncategoria: Agentes de IA\natualizado: 17/10/2026\ntags: modelo, temperatura, tokens, máx tokens de resposta, janela de histórico, fallback, modelo de pensamento, gpt, criatividade, resposta cortada, truncada\nno_painel: Agentes IA > (agente) > Modelo\nverificacao: conferido na tela do painel\n---\n\n# Escolher o modelo e ajustar temperatura, tokens e histórico\n\nO que cada campo da aba Modelo faz, qual valor usar e por que modelos de pensamento precisam de mais tokens de resposta.\n\n**Para quem é:** Administradores e quem otimiza custo e qualidade.\n\n**Antes de começar:**\n- Provedor de IA conectado em Integrações\n\nA seção **Modelo** do editor do agente define qual IA escreve as respostas e com que limites. A própria tela descreve: *escolha o modelo e ajuste a criatividade, os limites de resposta e a memória*.\n\n[Imagem: Seção Modelo com seletor de modelo, fallback, temperatura, máximo de tokens e janela de histórico. (1) Modelo. (2) Modelo de fallback. (3) Temperatura. (4) Máx. tokens de resposta. (5) Janela de histórico.]\n\n| Campo | O que faz | Orientação |\n|---|---|---|\n| **Modelo** | A IA que responde. Aparecem os modelos dos provedores conectados em Integrações. | Para volume alto, use um modelo mais leve; para casos complexos, um mais capaz. |\n| **Modelo de fallback (opcional)** | Se o modelo principal falhar com erro recuperável (limite de uso, tempo esgotado, erro do servidor), o agente tenta este automaticamente, mantendo prompt, tools e conhecimento. | Use um modelo de **outro provedor**. Erros de autenticação (chave inválida) **não** disparam o fallback. |\n| **Temperatura** | De 0 a 2. **0 = determinístico**, 2 = mais criativo. | Atendimento costuma ficar entre 0,2 e 0,5. |\n| **Máx. tokens de resposta** | Teto do tamanho da resposta. Paga-se só o que for gerado. | A tela mostra um mínimo recomendado para o modelo escolhido. |\n| **Janela de histórico** | Quantas mensagens anteriores o agente recebe como contexto. | Mais histórico = mais contexto e mais custo. |\n\n> **Atenção:** **Modelos de pensamento** usam parte dos tokens para raciocinar antes de escrever. Por isso precisam de mais tokens de resposta. Quando você escolhe um, a tela avisa e ajusta o mínimo (a tela de exemplo informa mínimo de 16.000, e um aviso em vermelho quando o valor está abaixo do recomendado). Valores baixos demais **cortam ou esvaziam a resposta**.\n\n## Passo a passo\n\n1. Abra o agente e clique em **Modelo**.\n2. Escolha o **Modelo**. Leia o aviso laranja, se aparecer.\n3. Escolha um **Modelo de fallback** de outro provedor, se tiver.\n4. Ajuste a **Temperatura**. Em atendimento, prefira valores baixos.\n5. Confira **Máx. tokens de resposta** contra o mínimo recomendado exibido abaixo do campo.\n6. Defina a **Janela de histórico** e clique em **Salvar**.\n\n## Não funcionou?\n\n- **Sintoma:** A resposta chega cortada ou vazia\n - Causa provável: Máx. tokens de resposta abaixo do mínimo recomendado para o modelo.\n - O que fazer: Aumente o valor até o recomendado e salve.\n- **Sintoma:** Todos os atendimentos falharam de uma vez\n - Causa provável: Chave do provedor sem saldo, revogada ou inativa, sem fallback configurado.\n - O que fazer: Confira em `Integrações` e configure um fallback de outro provedor. Veja «Conectar um provedor de IA e outras integrações» (artigo `integracoes-e-provedores-de-ia`).\n- **Sintoma:** O agente inventa respostas\n - Causa provável: Temperatura alta ou falta de conhecimento.\n - O que fazer: Reduza a temperatura e vincule base e FAQ. Veja «Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados» (artigo `ensinar-agente`).\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Quanto custa aumentar o máximo de tokens?**\nA própria tela informa que é um teto e que paga-se só o que for gerado.\n\n**O fallback cobre chave inválida?**\nNão. Erros de autenticação não disparam o fallback.\n\n**Qual temperatura usar?**\n0 é determinístico e 2 é mais criativo. Para atendimento, valores baixos mantêm respostas consistentes.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Qual modelo escolher?\n- Minha resposta vem cortada\n- O que é fallback?\n- O que é temperatura?\n\nResposta curta: Na aba Modelo você escolhe o modelo, um fallback opcional (usado quando o principal falha com limite de uso, tempo esgotado ou erro do servidor; chave inválida não aciona), a temperatura (0 determinístico, 2 criativo), o máximo de tokens de resposta e a janela de histórico. Modelos de pensamento precisam de mais tokens de resposta; abaixo do mínimo recomendado a resposta pode vir cortada ou vazia.\n\nEscalar para um humano quando:\n- Falhas em todos os atendimentos com chave válida\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Conectar um provedor de IA e outras integrações» (`integracoes-e-provedores-de-ia`); «A IA não responde: diagnóstico passo a passo» (`ia-nao-responde`)\n" }, { "slug": "ensinar-agente", "categoria": "Agentes de IA", "titulo": "Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados", "resumo": "Três formas de dar informação ao agente: documentos, perguntas e respostas prontas e correções feitas pela equipe no chat.", "tags": [ "base de conhecimento", "faq", "faq inteligente", "aprendizados", "documentos", "pdf", "texto", "site", "limiar de similaridade", "treinar agente", "ensinar", "correção", "respostas prontas" ], "publico": "Administradores que querem respostas corretas sobre o negócio.", "no_painel": [ "Agentes IA", "Base de conhecimento" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Posso enviar PDF?", "resposta": "Sim. A base aceita PDFs, textos colados e páginas de sites." }, { "pergunta": "O FAQ gasta créditos de IA?", "resposta": "A tela informa que o FAQ é consultado antes de gerar resposta com IA. Quando a pergunta casa com o FAQ, a resposta é entregue direto." }, { "pergunta": "As correções mudam o prompt?", "resposta": "Não. As regras de Aprendizados são injetadas sem alterar o prompt escrito à mão." } ], "problemas": [ { "sintoma": "O agente não usa o documento que enviei", "causa": "A base não está habilitada ou selecionada no agente.", "solucao": "Em Conhecimento, ligue a chave e selecione a base. Salve." }, { "sintoma": "O FAQ responde algo parecido, mas errado", "causa": "Limiar de similaridade baixo demais.", "solucao": "Aumente o limiar em FAQ Inteligente." }, { "sintoma": "Perguntas comuns estão indo para a IA", "causa": "FAQ desligado, sem a pergunta cadastrada, ou limiar alto demais.", "solucao": "Ative o FAQ, cadastre a pergunta e reduza o limiar." }, { "sintoma": "Informação desatualizada nas respostas", "causa": "Documento antigo na base.", "solucao": "Atualize ou substitua o documento e confira se o agente aponta para a base certa." } ], "para_ia": { "perguntas": [ "Como ensino meu agente sobre a empresa?", "Como subir um PDF para a IA consultar?", "O que é FAQ Inteligente?", "O que é limiar de similaridade?" ], "resposta": "Há três fontes. Base de conhecimento (Agentes IA → Base de conhecimento): crie uma base, adicione PDF, texto ou site e habilite no agente em Conhecimento. FAQ Inteligente: perguntas e respostas prontas consultadas antes da IA; o limiar de similaridade vai de 30% a 99%. Aprendizados: regras geradas a partir de correções da equipe, injetadas no prompt sem alterá-lo. Prefira bases pequenas e temáticas.", "escalar": [ "Falha na indexação ou no envio de documentos" ] }, "relacionados": [ "criar-agente", "functions-do-agente", "modelo-do-agente", "corrigir-as-respostas-do-agente", "ligar-seus-dados-ao-agente" ], "markdown": "---\nslug: ensinar-agente\ncategoria: Agentes de IA\natualizado: 17/10/2026\ntags: base de conhecimento, faq, faq inteligente, aprendizados, documentos, pdf, texto, site, limiar de similaridade, treinar agente, ensinar, correção, respostas prontas\nno_painel: Agentes IA > Base de conhecimento\nverificacao: conferido na tela do painel\n---\n\n# Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados\n\nTrês formas de dar informação ao agente: documentos, perguntas e respostas prontas e correções feitas pela equipe no chat.\n\n**Para quem é:** Administradores que querem respostas corretas sobre o negócio.\n\n**Antes de começar:**\n- Um agente criado (veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`))\n\nUm agente só responde bem sobre o seu negócio se tiver informação. O Elor.ia oferece **três fontes**, que podem ser usadas juntas.\n\n| Fonte | Para quê | Onde |\n|---|---|---|\n| **Base de conhecimento** | Documentos longos: PDFs, textos colados e páginas de sites. | `Agentes IA` → `Base de conhecimento` |\n| **FAQ Inteligente** | Perguntas e respostas prontas. Se a pergunta do cliente for parecida, responde direto, sem acionar a IA. | `Automações` → `FAQ Inteligente` |\n| **Aprendizados** | Regras criadas a partir de correções que a equipe faz no chat. | Agente → `Aprendizados` |\n\n[Esquema: Com o FAQ ligado, a mensagem passa por ele antes de chegar ao modelo de IA.]\n\n## 1. Base de conhecimento\n\n[Imagem: Tela Base de conhecimento com formulário Adicionar conteúdo e listas de bases e documentos. (1) Destino: base existente ou nova. (2) Nome da base. (3) Criar base. (4) Lista de bases, à direita.]\n\n1. Abra `Agentes IA` → `Base de conhecimento`.\n2. Em **Adicionar conteúdo**, escolha o **Destino**: *Nova base* ou *Base existente*.\n3. Dê um **Nome da base** (por exemplo, “Atendimento comercial”) e, se quiser, uma descrição.\n4. Clique em **Criar base** e adicione o conteúdo: PDF, texto colado ou rastreio de um site.\n5. Abra o agente → **Conhecimento**, ligue **Habilitar base de conhecimento** e selecione as bases que ele pode consultar.\n - [Imagem: Seção Conhecimento do agente com a chave Habilitar base de conhecimento. (1) Gerenciar bases. (2) Habilitar base de conhecimento. É preciso selecionar pelo menos uma base.]\n6. Clique em **Salvar**.\n\n> **Dica:** Organize em **bases pequenas e temáticas** (por exemplo, preços, políticas, serviços), cada uma com título claro. Documentos enormes e misturados são mais difíceis de consultar com precisão.\n\n## 2. FAQ Inteligente\n\n[Imagem: Seção FAQ Inteligente do agente com as chaves e o limiar de similaridade. (1) Ativar FAQ Inteligente. (2) Incluir FAQ geral do workspace. (3) Aprender automaticamente novas perguntas. (4) Limiar de similaridade. (5) Gerenciar FAQs.]\n\n| Opção | O que faz |\n|---|---|\n| **Ativar FAQ Inteligente** | O agente consulta a base de FAQ **antes** de gerar uma resposta com IA. |\n| **Incluir FAQ geral do workspace** | Além do FAQ deste agente, consulta o FAQ compartilhado do workspace. |\n| **Aprender automaticamente novas perguntas** | Perguntas sem correspondência são salvas para revisão e possível inclusão no FAQ. |\n| **Limiar de similaridade** | Porcentagem mínima de similaridade para aceitar uma resposta do FAQ. De 30% (permissivo) a 99% (exato). Valores altos exigem correspondência mais precisa. |\n\nSugestão de uso: comece com um limiar moderado (a tela de exemplo está em 78%) e suba se o FAQ estiver respondendo perguntas que não são a mesma coisa; desça se perguntas óbvias estiverem caindo na IA.\n\n## 3. Aprendizados\n\n[Imagem: Seção Aprendizados com Aprendizados ativos e Correções pendentes. (1) Aprendizados ativos: regras injetadas no prompt do agente. (2) Gerar regras sugeridas a partir das correções pendentes.]\n\nEm **Aprendizados** você revisa as correções recebidas durante os atendimentos. As regras ativas são **injetadas no prompt** do agente; o prompt escrito à mão **não é alterado**. Quando houver correções pendentes, o botão **Gerar regras sugeridas** transforma em regras.\n\n## Não funcionou?\n\n- **Sintoma:** O agente não usa o documento que enviei\n - Causa provável: A base não está habilitada ou selecionada no agente.\n - O que fazer: Em **Conhecimento**, ligue a chave e selecione a base. Salve.\n- **Sintoma:** O FAQ responde algo parecido, mas errado\n - Causa provável: Limiar de similaridade baixo demais.\n - O que fazer: Aumente o limiar em **FAQ Inteligente**.\n- **Sintoma:** Perguntas comuns estão indo para a IA\n - Causa provável: FAQ desligado, sem a pergunta cadastrada, ou limiar alto demais.\n - O que fazer: Ative o FAQ, cadastre a pergunta e reduza o limiar.\n- **Sintoma:** Informação desatualizada nas respostas\n - Causa provável: Documento antigo na base.\n - O que fazer: Atualize ou substitua o documento e confira se o agente aponta para a base certa.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Posso enviar PDF?**\nSim. A base aceita PDFs, textos colados e páginas de sites.\n\n**O FAQ gasta créditos de IA?**\nA tela informa que o FAQ é consultado antes de gerar resposta com IA. Quando a pergunta casa com o FAQ, a resposta é entregue direto.\n\n**As correções mudam o prompt?**\nNão. As regras de Aprendizados são injetadas sem alterar o prompt escrito à mão.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como ensino meu agente sobre a empresa?\n- Como subir um PDF para a IA consultar?\n- O que é FAQ Inteligente?\n- O que é limiar de similaridade?\n\nResposta curta: Há três fontes. Base de conhecimento (Agentes IA → Base de conhecimento): crie uma base, adicione PDF, texto ou site e habilite no agente em Conhecimento. FAQ Inteligente: perguntas e respostas prontas consultadas antes da IA; o limiar de similaridade vai de 30% a 99%. Aprendizados: regras geradas a partir de correções da equipe, injetadas no prompt sem alterá-lo. Prefira bases pequenas e temáticas.\n\nEscalar para um humano quando:\n- Falha na indexação ou no envio de documentos\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Dar ações ao agente com Functions» (`functions-do-agente`); «Escolher o modelo e ajustar temperatura, tokens e histórico» (`modelo-do-agente`); «Corrigir uma resposta errada do agente de IA» (`corrigir-as-respostas-do-agente`); «Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp» (`ligar-seus-dados-ao-agente`)\n" }, { "slug": "functions-do-agente", "categoria": "Agentes de IA", "titulo": "Dar ações ao agente com Functions", "resumo": "Functions são as ferramentas que o agente executa sozinho na conversa: etiquetar, salvar dados, transferir, criar oportunidades e chamar outros sistemas.", "tags": [ "functions", "ações", "ferramentas", "transferir para humano", "etiqueta", "atualizar contato", "nota interna", "oportunidade", "http", "curl", "webhook", "notificar", "skills", "cep", "frete" ], "publico": "Administradores que querem que o agente faça mais do que responder.", "no_painel": [ "Agentes IA", "Functions" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Posso chamar um sistema meu?", "resposta": "Sim, com uma function do tipo Requisição HTTP / cURL. Você define o endereço e os parâmetros." }, { "pergunta": "Dá para avisar a equipe por e-mail?", "resposta": "Sim, com a function Notificar atendente humano." }, { "pergunta": "Quantas functions posso ter?", "resposta": "A lista mostra o total no topo (por exemplo, “6 functions”). O limite depende do plano." } ], "problemas": [ { "sintoma": "A IA transfere, mas a conversa fica sem responsável", "causa": "Transferência sem destino só pausa a IA.", "solucao": "Crie departamentos ou equipes, coloque atendentes neles e configure o destino fixo na function de ações." }, { "sintoma": "Os dados do contato não salvam", "causa": "A function não tem *Atualizar contato* ligada ou a instrução não manda salvar. Nota interna não preenche campo.", "solucao": "Ligue a ação na function e ajuste a instrução." }, { "sintoma": "O card não aparece no funil", "causa": "Falta *Criar oportunidade* ligada ou o nome da etapa está diferente.", "solucao": "Ligue a ação e use o nome exato da etapa do pipeline." }, { "sintoma": "A function existe, mas o agente não usa", "causa": "Ela não está habilitada no agente, ou a descrição não diz quando usar.", "solucao": "Habilite em Ferramentas e reescreva a descrição como regra." } ], "para_ia": { "perguntas": [ "O que são functions?", "Como faço o agente transferir para uma pessoa?", "Como o agente salva o nome do cliente?", "Como o agente cria um card no pipeline?" ], "resposta": "Functions são ações que o agente executa na conversa. Crie em Agentes IA → Functions → Nova function, escolha o tipo (ações nativas, requisição HTTP/cURL, notificar atendente humano ou skill), descreva quando usar e habilite no agente em Ferramentas. Ações nativas incluem atualizar contato, aplicar etiqueta, nota interna, criar e mover oportunidade, transferir para humano e resolver conversa. Transferir sem destino configurado só pausa a IA.", "escalar": [ "Pedido para alguém configurar no lugar do cliente", "Integração externa com erro persistente" ] }, "relacionados": [ "criar-agente", "ensinar-agente", "outros-problemas-comuns", "convidar-equipe", "ligar-seus-dados-ao-agente", "calendarios-e-agendamentos", "cobrar-e-colher-assinaturas" ], "markdown": "---\nslug: functions-do-agente\ncategoria: Agentes de IA\natualizado: 17/10/2026\ntags: functions, ações, ferramentas, transferir para humano, etiqueta, atualizar contato, nota interna, oportunidade, http, curl, webhook, notificar, skills, cep, frete\nno_painel: Agentes IA > Functions\nverificacao: conferido na tela do painel\n---\n\n# Dar ações ao agente com Functions\n\nFunctions são as ferramentas que o agente executa sozinho na conversa: etiquetar, salvar dados, transferir, criar oportunidades e chamar outros sistemas.\n\n**Para quem é:** Administradores que querem que o agente faça mais do que responder.\n\n**Antes de começar:**\n- Um agente criado (veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`))\n\nUma **function** é uma ação que o agente pode executar durante a conversa. Sem functions, o agente só escreve texto. Com elas, ele também **registra, classifica, agenda, consulta e transfere**.\n\n[Imagem: Tela Functions com o botão Nova function, filtros por tipo e a lista de functions. (1) Nova function. (2) Filtros por tipo e busca por nome. (3) Chave Ativa. (4) Editar.]\n\n## Tipos de function\n\n| Tipo | Para que serve |\n|---|---|\n| **Workspace — Ações nativas** | Ações prontas do próprio painel, como atualizar contato, aplicar etiqueta, criar nota e transferir. |\n| **Requisição HTTP / cURL** | Chama um sistema externo (consultar um pedido, enviar dados). Você define o endereço e os parâmetros. |\n| **Notificar atendente humano** | Avisa uma pessoa, por exemplo por e-mail, quando um caso precisa de atenção. |\n| **Skill** | Procedimento que o agente carrega quando precisa, como um manual de uma plataforma. |\n\n## O que as ações nativas permitem\n\n| Ação | O que faz |\n|---|---|\n| Atualizar contato | Salva nome, e-mail, telefone, notas e campos personalizados, vários de uma vez. |\n| Aplicar / remover etiqueta | Marca o contato com uma etiqueta que já exista no workspace. |\n| Criar nota interna | Registra uma anotação para a equipe. Não é enviada ao cliente. |\n| Criar oportunidade / mover / status | Cria o card no pipeline, move de etapa e marca como ganho ou perdido. Criar não duplica um card ativo. |\n| Transferir para humano | Entrega a conversa à equipe, se o horário de transferência permitir. Opcionalmente a um atendente. |\n| Resolver conversa | Encerra o atendimento quando estiver resolvido. |\n| Memória do contato | Salva e busca fatos de longo prazo sobre o contato. |\n| Consultar CEP, distância e frete | Calcula endereço, distância e valor de entrega. Distância e frete exigem a integração gratuita AwesomeAPI. |\n\n## Passo a passo\n\n1. Abra `Agentes IA` → `Functions` e clique em **Nova function**.\n2. Escolha o **tipo** e preencha o nome e a descrição. A descrição diz ao agente **quando** usar a function: escreva como uma regra (“Use sempre que o cliente pedir…”).\n3. Salve. A function fica **Ativa** na lista.\n4. Abra o agente → **Ferramentas** e clique em **Gerenciar functions** para ver as habilitadas e ligá-la a ele.\n5. Reforce na **instrução** do agente quando ele deve chamar a function, e teste com **Testar agente**.\n\n> **Atenção:** O agente só faz o que a function permite. Para ele **salvar dados do contato**, a function de ações precisa ter *Atualizar contato* ligada **e** a instrução precisa mandar salvar. Para criar card no funil, é preciso *Criar oportunidade* ligada e o nome exato da etapa.\n\n> **Dica:** Uma tarefa em **um lugar só**. Se o agente já aplica a etiqueta ou move o card, a automação não deve repetir a mesma ação, para não duplicar.\n\n## Não funcionou?\n\n- **Sintoma:** A IA transfere, mas a conversa fica sem responsável\n - Causa provável: Transferência sem destino só pausa a IA.\n - O que fazer: Crie departamentos ou equipes, coloque atendentes neles e configure o destino fixo na function de ações.\n- **Sintoma:** Os dados do contato não salvam\n - Causa provável: A function não tem *Atualizar contato* ligada ou a instrução não manda salvar. Nota interna não preenche campo.\n - O que fazer: Ligue a ação na function e ajuste a instrução.\n- **Sintoma:** O card não aparece no funil\n - Causa provável: Falta *Criar oportunidade* ligada ou o nome da etapa está diferente.\n - O que fazer: Ligue a ação e use o nome exato da etapa do pipeline.\n- **Sintoma:** A function existe, mas o agente não usa\n - Causa provável: Ela não está habilitada no agente, ou a descrição não diz quando usar.\n - O que fazer: Habilite em **Ferramentas** e reescreva a descrição como regra.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Posso chamar um sistema meu?**\nSim, com uma function do tipo Requisição HTTP / cURL. Você define o endereço e os parâmetros.\n\n**Dá para avisar a equipe por e-mail?**\nSim, com a function Notificar atendente humano.\n\n**Quantas functions posso ter?**\nA lista mostra o total no topo (por exemplo, “6 functions”). O limite depende do plano.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- O que são functions?\n- Como faço o agente transferir para uma pessoa?\n- Como o agente salva o nome do cliente?\n- Como o agente cria um card no pipeline?\n\nResposta curta: Functions são ações que o agente executa na conversa. Crie em Agentes IA → Functions → Nova function, escolha o tipo (ações nativas, requisição HTTP/cURL, notificar atendente humano ou skill), descreva quando usar e habilite no agente em Ferramentas. Ações nativas incluem atualizar contato, aplicar etiqueta, nota interna, criar e mover oportunidade, transferir para humano e resolver conversa. Transferir sem destino configurado só pausa a IA.\n\nEscalar para um humano quando:\n- Pedido para alguém configurar no lugar do cliente\n- Integração externa com erro persistente\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados» (`ensinar-agente`); «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (`outros-problemas-comuns`); «Convidar pessoas para a equipe e definir o que cada uma acessa» (`convidar-equipe`); «Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp» (`ligar-seus-dados-ao-agente`); «Criar calendários e cuidar dos agendamentos» (`calendarios-e-agendamentos`); «Cobrar e colher assinaturas com InfinitePay e Autentique» (`cobrar-e-colher-assinaturas`)\n" }, { "slug": "ia-nao-responde", "categoria": "Resolver problemas", "titulo": "A IA não responde: diagnóstico passo a passo", "resumo": "Seis verificações, da mais provável à menos provável, para descobrir por que o agente ficou mudo.", "tags": [ "ia não responde", "ia parou", "agente mudo", "sem resposta", "parou do nada", "silêncio", "diagnóstico", "problema", "não funciona", "pausada", "canal desvinculado", "automação mensagem recebida", "sem saldo" ], "publico": "Administradores e atendentes.", "no_painel": [ "Agentes IA", "Conexões", "Automações", "Integrações" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Por que a IA parou depois que reconectei o WhatsApp?", "resposta": "A reconexão cria uma conexão nova e o agente fica desvinculado. Marque o canal novo no agente." }, { "pergunta": "A IA fica muda quando um humano responde?", "resposta": "Sim. Quando um atendente assume, a IA pausa naquela conversa. Para a IA voltar, retome-a na conversa." }, { "pergunta": "Uma automação pode silenciar a IA?", "resposta": "Pode. Automação ativa com gatilho “Mensagem recebida” assume a conversa e a IA fica muda." } ], "problemas": [], "para_ia": { "perguntas": [ "Minha IA parou de responder", "O agente está mudo", "A IA não responde no WhatsApp", "Por que a IA ficou em silêncio?" ], "resposta": "Verifique nesta ordem, perguntando uma coisa por vez: 1) agente ativo; 2) canal marcado no agente (reconectar o WhatsApp cria conexão nova e desvincula o agente); 3) automação ativa com gatilho Mensagem recebida (assume a conversa e silencia a IA); 4) IA pausada na conversa por atendente ou transferência; 5) horário ou filtros (incluindo etiquetas obrigatórias); 6) provedor de IA sem saldo, chave revogada ou inativa. Se nada explicar, escalar com horário exato e nome do contato.", "escalar": [ "Duas tentativas sem resolver", "Suspeita de falha da plataforma", "IA escrevendo em inglês ou raciocínio vazado (prioridade alta)" ] }, "relacionados": [ "criar-agente", "quando-o-agente-responde", "integracoes-e-provedores-de-ia", "outros-problemas-comuns", "whatsapp-qr-code", "corrigir-as-respostas-do-agente" ], "markdown": "---\nslug: ia-nao-responde\ncategoria: Resolver problemas\natualizado: 17/10/2026\ntags: ia não responde, ia parou, agente mudo, sem resposta, parou do nada, silêncio, diagnóstico, problema, não funciona, pausada, canal desvinculado, automação mensagem recebida, sem saldo\nno_painel: Agentes IA > Conexões > Automações > Integrações\nverificacao: baseado no guia oficial do painel\n---\n\n# A IA não responde: diagnóstico passo a passo\n\nSeis verificações, da mais provável à menos provável, para descobrir por que o agente ficou mudo.\n\n**Para quem é:** Administradores e atendentes.\n\nQuando o agente não responde, siga a ordem abaixo. Ela vai da causa **mais provável e mais fácil de checar** até a menos provável. Pare no primeiro item que explicar o problema.\n\n[Esquema: Ordem de verificação.]\n\n## As seis verificações\n\n1. **O agente está ativo?** Em `Agentes IA`, confira a chave de ativação. Na lista, o agente desativado mostra a etiqueta **desativado**.\n2. **O canal está marcado no agente?** Abra o agente, aba **O agente**, e confira *Canais onde o agente atua*. O canal precisa estar marcado e ser o principal. Atenção: quando o WhatsApp do celular é desconectado e reconectado, ele vira uma conexão **nova** e o agente fica desvinculado sem aviso. É a causa mais comum de “a IA parou do nada”. Marque o canal novo e salve.\n3. **Existe automação ativa com gatilho “Mensagem recebida”?** Esse tipo assume a conversa e a IA fica muda em todos os canais, mesmo que a automação apenas mova para uma pasta. Teste: desative a automação e mande uma mensagem. Se a IA voltar, achou a causa.\n4. **A IA está pausada nessa conversa?** Quando um atendente assume ou a IA transfere, ela pausa. Retome a IA na própria conversa.\n5. **Horário e filtros.** Fora do horário configurado em **Filtros**, a IA fica em silêncio ou manda só o recado fixo. Uma regra de **etiquetas obrigatórias** também bloqueia contatos sem a etiqueta.\n6. **Provedor de IA.** Em `Integrações`, confira se a chave do provedor está ativa, válida e com saldo. Chave revogada ou sem saldo faz **todos** os atendimentos falharem. Sem fallback, o agente fica mudo.\n\n> **Bom saber:** Nenhuma das seis explicou? Reúna o **horário exato da mensagem** e o **nome do contato** e fale com a equipe técnica. Isso acelera muito a análise.\n\n> **Atenção:** Se a IA enviou texto em inglês, entre parênteses ou “pensando alto”, trate como prioridade: tire um print e acione a equipe técnica imediatamente.\n\n## Perguntas frequentes\n\n**Por que a IA parou depois que reconectei o WhatsApp?**\nA reconexão cria uma conexão nova e o agente fica desvinculado. Marque o canal novo no agente.\n\n**A IA fica muda quando um humano responde?**\nSim. Quando um atendente assume, a IA pausa naquela conversa. Para a IA voltar, retome-a na conversa.\n\n**Uma automação pode silenciar a IA?**\nPode. Automação ativa com gatilho “Mensagem recebida” assume a conversa e a IA fica muda.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Minha IA parou de responder\n- O agente está mudo\n- A IA não responde no WhatsApp\n- Por que a IA ficou em silêncio?\n\nResposta curta: Verifique nesta ordem, perguntando uma coisa por vez: 1) agente ativo; 2) canal marcado no agente (reconectar o WhatsApp cria conexão nova e desvincula o agente); 3) automação ativa com gatilho Mensagem recebida (assume a conversa e silencia a IA); 4) IA pausada na conversa por atendente ou transferência; 5) horário ou filtros (incluindo etiquetas obrigatórias); 6) provedor de IA sem saldo, chave revogada ou inativa. Se nada explicar, escalar com horário exato e nome do contato.\n\nEscalar para um humano quando:\n- Duas tentativas sem resolver\n- Suspeita de falha da plataforma\n- IA escrevendo em inglês ou raciocínio vazado (prioridade alta)\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Quando e como o agente responde: gatilho, buffer, horários e encerramento» (`quando-o-agente-responde`); «Conectar um provedor de IA e outras integrações» (`integracoes-e-provedores-de-ia`); «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (`outros-problemas-comuns`); «Conectar um número de WhatsApp pelo QR Code» (`whatsapp-qr-code`); «Corrigir uma resposta errada do agente de IA» (`corrigir-as-respostas-do-agente`)\n" }, { "slug": "outros-problemas-comuns", "categoria": "Resolver problemas", "titulo": "Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up", "resumo": "Respostas rápidas por sintoma para os problemas mais frequentes que não são “a IA ficou muda”.", "tags": [ "problemas", "transferência", "follow-up", "automação não dispara", "dados não salvam", "card não aparece", "template recusado", "mensagem falhou", "instagram", "webchat", "inatividade", "observador", "etiqueta" ], "publico": "Administradores e atendentes.", "no_painel": [ "Agentes IA", "Automações", "Conversas" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Posso fazer o Instagram iniciar conversa com um cliente?", "resposta": "Não. Instagram, Messenger, Webchat e Telegram só respondem a quem escreveu." }, { "pergunta": "O follow-up cancela quando o cliente responde?", "resposta": "Sim, é o comportamento esperado." }, { "pergunta": "Onde vejo o valor real de uma variável numa automação?", "resposta": "No Observador do Flow Builder, que mostra o valor de cada variável durante um teste." } ], "problemas": [], "para_ia": { "perguntas": [ "A transferência não chegou a ninguém", "Minha automação não disparou", "Os dados do cliente não foram salvos", "O follow-up não saiu" ], "resposta": "Transferência sem destino só pausa a IA: crie departamentos e configure o destino na function de ações. Dados do contato exigem a ação Atualizar contato ligada e instrução mandando salvar. Card no funil exige Criar oportunidade ligada e nome exato da etapa. Follow-up cancela quando o cliente responde; no WhatsApp oficial, texto não sai fora da janela de 24 horas. Automação: conferir se está ativa, o gatilho, as condições de data e hora com o Observador, e evitar duplicar tarefas do agente.", "escalar": [ "Duas tentativas sem resolver", "Cliente irritado ou pedido para falar com uma pessoa" ] }, "relacionados": [ "ia-nao-responde", "functions-do-agente", "escolher-automacao", "atender-conversa", "disponivel-ou-ausente" ], "markdown": "---\nslug: outros-problemas-comuns\ncategoria: Resolver problemas\natualizado: 17/10/2026\ntags: problemas, transferência, follow-up, automação não dispara, dados não salvam, card não aparece, template recusado, mensagem falhou, instagram, webchat, inatividade, observador, etiqueta\nno_painel: Agentes IA > Automações > Conversas\nverificacao: baseado no guia oficial do painel\n---\n\n# Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up\n\nRespostas rápidas por sintoma para os problemas mais frequentes que não são “a IA ficou muda”.\n\n**Para quem é:** Administradores e atendentes.\n\nProcure o seu sintoma na tabela. Cada linha traz a causa mais provável e a solução. Se o sintoma for “a IA não responde”, vá para «A IA não responde: diagnóstico passo a passo» (artigo `ia-nao-responde`).\n\n## Por sintoma\n\n| Sintoma | Causa provável | O que fazer |\n|---|---|---|\n| A IA responde quando não devia | Emoji, “obrigado” ou mensagem nova em conversa concluída acordam a IA. | Inclua nas instruções: silêncio para cortesia e saída de cena quando um humano respondeu. |\n| A transferência não chega a ninguém | Transferência sem destino só pausa a IA. | Crie departamentos em `Equipe`, coloque atendentes e configure o destino fixo na function de ações. |\n| Mensagem com status “falhou” no WhatsApp do celular | Sessão desconectada. | Reconecte lendo o QR Code. Depois confira agente, automações e avisos. |\n| Template recusado ou parado | Não aprovado, ou nome e idioma divergentes. | Confira o status: precisa estar **aprovado**. |\n| Instagram, Messenger, Webchat ou Telegram não iniciam conversa | Esses canais só respondem a quem escreveu. | Use e-mail, SMS ou WhatsApp para avisar depois. |\n| Automação não dispara ou faz coisa errada | Desativada, gatilho errado, condição de data/hora ou variável vazia. | Siga a lista abaixo. |\n| Dados do contato não salvam | A function não tem *Atualizar contato* ligada, ou a instrução não manda salvar. | Ajuste a function e a instrução. Nota interna não preenche campo. |\n| O card não aparece no funil | Falta *Criar oportunidade* ligada ou etapa com nome diferente. | Ligue a ação e use o nome exato da etapa. |\n| Follow-up não saiu | Cancela sozinho quando o cliente responde. No WhatsApp oficial, texto não sai fora da janela. | Para aviso que não deve cancelar, use *Agendar mensagem*. No oficial, use passos com template. |\n| Mensagens picadas ou lentas | Buffer, atraso e divisão de mensagem. | Ajuste em **Conversa**. Divisão muito curta quebra links. |\n| Conversas não fecham por inatividade | Só atua em conversa aberta, sem pausa, sem humano e sem automação. | Confira o estado da conversa. Conversa transferida fica de fora. |\n\n## Automação não dispara: confira nesta ordem\n\n1. A automação está **ativa**?\n2. O **gatilho** é o certo para o evento?\n3. Em condições de **data e hora**, teste com o **Observador** e veja o valor real da variável. Variável vazia faz a condição nunca bater.\n4. Janela de horário com formato inválido é tratada como “fora da janela”, **sem erro**.\n5. Etiqueta aplicada pela própria plataforma (por exemplo, no encerramento por inatividade) pode não disparar o gatilho “etiqueta adicionada”. Alternativa: gatilho “conversa resolvida” com espera curta e condição na etiqueta.\n6. Regra de ouro: cada tarefa em **um lugar só**. Se o agente já etiqueta ou move o card, a automação não deve repetir.\n\n## Perguntas frequentes\n\n**Posso fazer o Instagram iniciar conversa com um cliente?**\nNão. Instagram, Messenger, Webchat e Telegram só respondem a quem escreveu.\n\n**O follow-up cancela quando o cliente responde?**\nSim, é o comportamento esperado.\n\n**Onde vejo o valor real de uma variável numa automação?**\nNo **Observador** do Flow Builder, que mostra o valor de cada variável durante um teste.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- A transferência não chegou a ninguém\n- Minha automação não disparou\n- Os dados do cliente não foram salvos\n- O follow-up não saiu\n\nResposta curta: Transferência sem destino só pausa a IA: crie departamentos e configure o destino na function de ações. Dados do contato exigem a ação Atualizar contato ligada e instrução mandando salvar. Card no funil exige Criar oportunidade ligada e nome exato da etapa. Follow-up cancela quando o cliente responde; no WhatsApp oficial, texto não sai fora da janela de 24 horas. Automação: conferir se está ativa, o gatilho, as condições de data e hora com o Observador, e evitar duplicar tarefas do agente.\n\nEscalar para um humano quando:\n- Duas tentativas sem resolver\n- Cliente irritado ou pedido para falar com uma pessoa\n\nVeja também: «A IA não responde: diagnóstico passo a passo» (`ia-nao-responde`); «Dar ações ao agente com Functions» (`functions-do-agente`); «Automações: qual usar em cada situação» (`escolher-automacao`); «Atender uma conversa: assumir, transferir e encerrar» (`atender-conversa`); «Ficar disponível ou ausente para receber conversas» (`disponivel-ou-ausente`)\n" }, { "slug": "escolher-automacao", "categoria": "Automações e disparos", "titulo": "Automações: qual usar em cada situação", "resumo": "Um guia de decisão entre Automação Básica, Flow Builder, Disparo em Massa, Webhooks e as automações de Instagram.", "tags": [ "automações", "flow builder", "automação básica", "webhooks", "disparo em massa", "comentários instagram", "histórias instagram", "prospecção ativa", "relatórios de ia", "faq", "catálogo", "qual usar" ], "publico": "Administradores que vão automatizar processos.", "no_painel": [ "Automações" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Qual a diferença entre Automação Básica e Flow Builder?", "resposta": "A Básica é uma regra simples (quando isso acontecer, faça aquilo). O Flow Builder é um construtor visual com ramificações, esperas e atrasos." }, { "pergunta": "Disparo em Massa funciona em qualquer canal?", "resposta": "A tela descreve campanhas de template aprovado do WhatsApp. Veja «Criar um disparo em massa e acompanhar o envio»." } ], "problemas": [ { "sintoma": "A IA parou depois que criei uma automação", "causa": "Automação com gatilho “Mensagem recebida” assume a conversa.", "solucao": "Desative-a para testar. Se a IA voltar, redesenhe o gatilho." }, { "sintoma": "Ações duplicadas (duas etiquetas, dois cards)", "causa": "A mesma tarefa está no agente e na automação.", "solucao": "Deixe a tarefa em um lugar só." } ], "para_ia": { "perguntas": [ "Qual automação devo usar?", "Qual a diferença entre automação básica e flow builder?", "Como recebo dados de outro sistema?", "Como respondo comentários do Instagram?" ], "resposta": "Regra simples (quando X acontecer, faça Y): Automação Básica. Conversa em etapas com ramificação, espera e botões: Flow Builder. Mensagem a muitos contatos com template aprovado: Disparo em Massa. Dados de sistemas externos: Webhooks. Comentários e stories do Instagram têm automações próprias. Cada tarefa deve ficar em um lugar só, e automação ativa com gatilho Mensagem recebida silencia a IA.", "escalar": [ "Integração por webhook ou API com erro persistente" ] }, "relacionados": [ "automacao-basica", "disparo-em-massa", "ensinar-agente", "montar-um-fluxo-no-flow-builder", "receber-dados-com-webhooks", "respostas-automaticas-instagram-e-facebook" ], "markdown": "---\nslug: escolher-automacao\ncategoria: Automações e disparos\natualizado: 17/10/2026\ntags: automações, flow builder, automação básica, webhooks, disparo em massa, comentários instagram, histórias instagram, prospecção ativa, relatórios de ia, faq, catálogo, qual usar\nno_painel: Automações\nverificacao: conferido na tela do painel\n---\n\n# Automações: qual usar em cada situação\n\nUm guia de decisão entre Automação Básica, Flow Builder, Disparo em Massa, Webhooks e as automações de Instagram.\n\n**Para quem é:** Administradores que vão automatizar processos.\n\nA tela **Automações** reúne as ferramentas que automatizam ações com base em eventos dos seus canais. Nem tudo precisa de um fluxo complexo: comece pela opção mais simples que resolve.\n\n[Esquema: Escolha pela forma do que você quer automatizar.]\n\n[Imagem: Tela Automações com cartões: Catálogo de produtos, Comentários Instagram, Histórias Instagram, Webhooks, Automação Básica, Flow Builder, Disparo em Massa, FAQ Inteligente, Relatórios de IA, Prospecção Ativa e Base de dados Supabase. (1) Webhooks. (2) Automação Básica. (3) Flow Builder. (4) Disparo em Massa. (5) FAQ Inteligente.]\n\n## O que cada cartão faz\n\n| Cartão | Para quê |\n|---|---|\n| **Automação Básica** | Regras simples: quando um evento acontece, execute ações — enviar mensagem, aplicar tag, mover no pipeline e mais. |\n| **Flow Builder** | Fluxos visuais com ramificações, espera e atrasos, em um canvas. É o construtor avançado. |\n| **Disparo em Massa** | Campanhas com template aprovado do WhatsApp, com audiência por tags e filtros, agendamento e métricas. |\n| **Webhooks** | Receba dados de sistemas externos (CRMs, formulários, Zapier) para criar contatos, aplicar tags e disparar automações. |\n| **Comentários Instagram** | Responde a comentários em posts, por DM privada e/ou resposta pública, com texto ou agente de IA. |\n| **Histórias Instagram** | Responde por DM a quem menciona ou responde seus stories. |\n| **FAQ Inteligente** | Cache de perguntas e respostas alimentado pelo agente: responde perguntas comuns na hora e pula a IA. |\n| **Relatórios de IA** | Relatórios analíticos escritos por um agente de IA: escolha métricas e período, gere na hora ou veja o histórico. |\n| **Prospecção Ativa** | Encontre empresas por CNAE e UF e importe como contatos, para listas de outreach. |\n| **Catálogo de produtos** e **Base de dados Supabase** | Cadastre produtos e consulte tabelas do seu projeto Supabase sem sair do sistema, inclusive as que o agente usa nas conversas. |\n\n## Regras para não se atrapalhar\n\n- **Cada tarefa em um lugar só.** Se o agente já aplica a etiqueta, a automação não deve aplicar de novo.\n- **Cuidado com “Mensagem recebida”.** Uma automação ativa com esse gatilho assume a conversa e a IA fica muda. Veja «A IA não responde: diagnóstico passo a passo» (artigo `ia-nao-responde`).\n- **Comece pela Automação Básica.** Só migre para Flow Builder quando precisar de etapas, espera e botões.\n\n## Não funcionou?\n\n- **Sintoma:** A IA parou depois que criei uma automação\n - Causa provável: Automação com gatilho “Mensagem recebida” assume a conversa.\n - O que fazer: Desative-a para testar. Se a IA voltar, redesenhe o gatilho.\n- **Sintoma:** Ações duplicadas (duas etiquetas, dois cards)\n - Causa provável: A mesma tarefa está no agente e na automação.\n - O que fazer: Deixe a tarefa em um lugar só.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Qual a diferença entre Automação Básica e Flow Builder?**\nA Básica é uma regra simples (quando isso acontecer, faça aquilo). O Flow Builder é um construtor visual com ramificações, esperas e atrasos.\n\n**Disparo em Massa funciona em qualquer canal?**\nA tela descreve campanhas de template aprovado do WhatsApp. Veja «Criar um disparo em massa e acompanhar o envio» (artigo `disparo-em-massa`).\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Qual automação devo usar?\n- Qual a diferença entre automação básica e flow builder?\n- Como recebo dados de outro sistema?\n- Como respondo comentários do Instagram?\n\nResposta curta: Regra simples (quando X acontecer, faça Y): Automação Básica. Conversa em etapas com ramificação, espera e botões: Flow Builder. Mensagem a muitos contatos com template aprovado: Disparo em Massa. Dados de sistemas externos: Webhooks. Comentários e stories do Instagram têm automações próprias. Cada tarefa deve ficar em um lugar só, e automação ativa com gatilho Mensagem recebida silencia a IA.\n\nEscalar para um humano quando:\n- Integração por webhook ou API com erro persistente\n\nVeja também: «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (`automacao-basica`); «Criar um disparo em massa e acompanhar o envio» (`disparo-em-massa`); «Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados» (`ensinar-agente`); «Montar o primeiro fluxo no Flow Builder» (`montar-um-fluxo-no-flow-builder`); «Receber dados de outros sistemas com webhooks» (`receber-dados-com-webhooks`); «Responder comentários e stories do Instagram automaticamente» (`respostas-automaticas-instagram-e-facebook`)\n" }, { "slug": "automacao-basica", "categoria": "Automações e disparos", "titulo": "Criar uma Automação Básica: quando isso acontecer, faça aquilo", "resumo": "Regras simples com gatilho e ações: envie mensagem, aplique etiqueta, mova no pipeline e acompanhe cada execução.", "tags": [ "automação básica", "regra", "gatilho", "palavra-chave", "execuções", "ativar", "desativar", "ação", "etiqueta", "pipeline", "mensagem automática" ], "publico": "Administradores que querem regras simples.", "no_painel": [ "Automações", "Automação Básica" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Onde vejo quantas vezes a regra rodou?", "resposta": "Na lista, em “Execuções neste mês”, e no botão Execuções." }, { "pergunta": "Como pauso uma regra?", "resposta": "Use Desativar na linha da regra." }, { "pergunta": "Posso remover uma regra?", "resposta": "Sim, com Remover. Se quiser só pausar, prefira Desativar." } ], "problemas": [ { "sintoma": "A regra não dispara", "causa": "Está desativada, ou o gatilho não corresponde ao evento.", "solucao": "Confira ativa, o gatilho e o contador de Execuções. Veja «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up»." }, { "sintoma": "Ações duplicadas", "causa": "A mesma tarefa está no agente de IA.", "solucao": "Deixe a tarefa em um lugar só." }, { "sintoma": "Depois de ativar, a IA parou", "causa": "Gatilho “Mensagem recebida”.", "solucao": "Desative e redesenhe o gatilho." } ], "para_ia": { "perguntas": [ "Como crio uma automação?", "Como pauso uma automação?", "Como vejo se a automação rodou?", "A automação silenciou a IA" ], "resposta": "Em Automações → Automação Básica → Nova automação, escolha o gatilho (mensagem, contato novo, palavra-chave…) e as ações (enviar mensagem, aplicar etiqueta, mover no pipeline…), salve e ative. Na lista, Ativar/Desativar controla o estado e Execuções mostra o histórico; “Execuções neste mês” é o contador. Automação ativa com gatilho Mensagem recebida assume a conversa e silencia a IA.", "escalar": [ "Regra que contradiz a configuração" ] }, "relacionados": [ "escolher-automacao", "outros-problemas-comuns", "ia-nao-responde" ], "markdown": "---\nslug: automacao-basica\ncategoria: Automações e disparos\natualizado: 17/10/2026\ntags: automação básica, regra, gatilho, palavra-chave, execuções, ativar, desativar, ação, etiqueta, pipeline, mensagem automática\nno_painel: Automações > Automação Básica\nverificacao: conferido na tela do painel\n---\n\n# Criar uma Automação Básica: quando isso acontecer, faça aquilo\n\nRegras simples com gatilho e ações: envie mensagem, aplique etiqueta, mova no pipeline e acompanhe cada execução.\n\n**Para quem é:** Administradores que querem regras simples.\n\nA **Automação Básica** cria regras que rodam sozinhas: *quando* algo acontece, o painel executa uma ou mais *ações*. Os gatilhos incluem mensagens, contatos novos e **palavra-chave**.\n\n[Imagem: Lista de automações básicas com botões Nova automação, Ativar ou Desativar, Execuções, Editar e Remover (nomes ocultados). (1) Nova automação. (2) Ativar / Desativar. (3) Execuções. (4) Editar. Os nomes das regras de exemplo foram desfocados.]\n\nCada regra na lista mostra o **nome**, a etiqueta de estado (**ativa** ou **desativada**), o **gatilho** (por exemplo, *Palavra-chave*) e as **execuções neste mês**.\n\n## Passo a passo\n\n1. Abra `Automações` e clique em **Automação Básica**.\n2. Clique em **Nova automação**.\n3. Escolha o **gatilho**: o evento que inicia a regra (por exemplo, uma palavra-chave recebida).\n4. Escolha as **ações** que devem rodar: enviar mensagem, aplicar etiqueta, mover no pipeline e outras.\n5. Salve e use **Ativar**. Para pausar, use **Desativar**.\n6. Acompanhe em **Execuções**: o contador “Execuções neste mês” mostra quantas vezes rodou.\n\n> **Bom saber:** Os campos exatos de cada gatilho e ação não foram capturados nesta revisão. O fluxo acima descreve a lista e os botões confirmados em tela.\n\n> **Atenção:** Uma automação **ativa** com gatilho **“Mensagem recebida”** assume a conversa e deixa a IA muda em todos os canais, mesmo que a automação só mova para uma pasta. Teste antes de ativar.\n\n## Exemplo útil: ativar um agente por palavra-chave\n\nUm padrão comum é usar uma automação com gatilho **Palavra-chave** para ativar um agente específico quando o cliente digitar uma palavra combinada. É útil para testes e para direcionar o contato para o agente certo.\n\n## Não funcionou?\n\n- **Sintoma:** A regra não dispara\n - Causa provável: Está desativada, ou o gatilho não corresponde ao evento.\n - O que fazer: Confira **ativa**, o gatilho e o contador de **Execuções**. Veja «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (artigo `outros-problemas-comuns`).\n- **Sintoma:** Ações duplicadas\n - Causa provável: A mesma tarefa está no agente de IA.\n - O que fazer: Deixe a tarefa em um lugar só.\n- **Sintoma:** Depois de ativar, a IA parou\n - Causa provável: Gatilho “Mensagem recebida”.\n - O que fazer: Desative e redesenhe o gatilho.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Onde vejo quantas vezes a regra rodou?**\nNa lista, em “Execuções neste mês”, e no botão **Execuções**.\n\n**Como pauso uma regra?**\nUse **Desativar** na linha da regra.\n\n**Posso remover uma regra?**\nSim, com **Remover**. Se quiser só pausar, prefira **Desativar**.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como crio uma automação?\n- Como pauso uma automação?\n- Como vejo se a automação rodou?\n- A automação silenciou a IA\n\nResposta curta: Em Automações → Automação Básica → Nova automação, escolha o gatilho (mensagem, contato novo, palavra-chave…) e as ações (enviar mensagem, aplicar etiqueta, mover no pipeline…), salve e ative. Na lista, Ativar/Desativar controla o estado e Execuções mostra o histórico; “Execuções neste mês” é o contador. Automação ativa com gatilho Mensagem recebida assume a conversa e silencia a IA.\n\nEscalar para um humano quando:\n- Regra que contradiz a configuração\n\nVeja também: «Automações: qual usar em cada situação» (`escolher-automacao`); «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (`outros-problemas-comuns`); «A IA não responde: diagnóstico passo a passo» (`ia-nao-responde`)\n" }, { "slug": "disparo-em-massa", "categoria": "Automações e disparos", "titulo": "Criar um disparo em massa e acompanhar o envio", "resumo": "Envie um template aprovado do WhatsApp para vários contatos, na hora ou agendado, e acompanhe entregas, leituras, respostas e falhas.", "tags": [ "disparo em massa", "campanha", "broadcast", "template", "audiência", "agendar", "entregues", "lidas", "respondidas", "falhas", "whatsapp api oficial", "mensagem em massa" ], "publico": "Administradores de marketing e atendimento.", "no_painel": [ "Automações", "Disparo em Massa" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Posso agendar?", "resposta": "Sim, na hora ou agendado." }, { "pergunta": "Preciso de template aprovado?", "resposta": "Sim. A campanha usa template aprovado pela Meta." }, { "pergunta": "Como segmento quem recebe?", "resposta": "Por tags e filtros, com prévia da audiência." } ], "problemas": [ { "sintoma": "O template não aparece na campanha", "causa": "Não está aprovado ou o idioma não confere.", "solucao": "Confira o status do template: precisa estar aprovado." }, { "sintoma": "Muitas falhas", "causa": "Números inválidos ou sem WhatsApp, ou problema na conexão.", "solucao": "Confira a conexão do canal e a qualidade da lista de contatos." }, { "sintoma": "Número bloqueado após disparo", "causa": "Disparo em massa por QR Code.", "solucao": "Use a API Oficial Meta para campanhas." } ], "para_ia": { "perguntas": [ "Como faço um disparo em massa?", "Posso agendar uma campanha?", "Como vejo quem leu?", "Meu número foi bloqueado depois do disparo" ], "resposta": "Em Automações → Disparo em Massa → Nova campanha: escolha um template aprovado pela Meta, defina a audiência por tags e filtros e envie na hora ou agende. A tela mostra campanhas, contatos alcançados, enviadas, entregues, lidas, respondidas e falhas. Requer WhatsApp pela API Oficial; disparo em massa pelo QR Code pode bloquear o número.", "escalar": [ "Template aprovado que não envia", "Falhas em massa sem causa clara" ] }, "relacionados": [ "conectar-whatsapp", "janela-24-horas", "escolher-automacao", "templates-whatsapp" ], "markdown": "---\nslug: disparo-em-massa\ncategoria: Automações e disparos\natualizado: 17/10/2026\ntags: disparo em massa, campanha, broadcast, template, audiência, agendar, entregues, lidas, respondidas, falhas, whatsapp api oficial, mensagem em massa\nno_painel: Automações > Disparo em Massa\nverificacao: conferido na tela do painel\n---\n\n# Criar um disparo em massa e acompanhar o envio\n\nEnvie um template aprovado do WhatsApp para vários contatos, na hora ou agendado, e acompanhe entregas, leituras, respostas e falhas.\n\n**Para quem é:** Administradores de marketing e atendimento.\n\n**Antes de começar:**\n- WhatsApp conectado pela API Oficial Meta\n- Template aprovado pela Meta\n\nO **Disparo em Massa** envia uma campanha de **template aprovado** do WhatsApp para uma audiência de contatos, filtrada por tags e outros filtros. Você pode enviar na hora ou agendar e acompanhar os resultados na mesma tela.\n\n[Imagem: Tela Disparo em Massa com indicadores de campanhas, contatos alcançados, enviadas, entregues, lidas, respondidas e falhas. (1) Nova campanha. (2) Indicadores da operação. (3) Filtro por status da campanha.]\n\n## O que cada indicador mostra\n\n| Indicador | Significado |\n|---|---|\n| Campanhas | Quantidade de campanhas criadas. |\n| Contatos alcançados | Contatos que receberam ao menos uma mensagem. |\n| Enviadas | Mensagens enviadas pelo Elor.ia. |\n| Entregues | Mensagens que chegaram ao celular do contato. |\n| Lidas | Mensagens que o contato abriu. |\n| Respondidas | Contatos que responderam a campanha. |\n| Falhas | Envios que não foram concluídos. |\n\n## Passo a passo\n\n1. Abra `Automações` → `Disparo em Massa`.\n2. Clique em **Nova campanha** (ou em **Criar campanha**, quando a lista estiver vazia).\n3. Escolha o **template aprovado** a ser enviado.\n4. Defina a **audiência** por tags e filtros e veja a prévia de quantos contatos serão alcançados.\n5. Escolha enviar **na hora** ou **agendar**.\n6. Depois, acompanhe entregas, leituras, respostas e falhas nos indicadores e use o filtro de **status**.\n\n> **Bom saber:** Os campos exatos do assistente de campanha não foram capturados nesta revisão; o fluxo acima segue a descrição oficial do painel.\n\n> **Atenção:** Disparo em massa exige a **API Oficial Meta**. No QR Code, a própria tela de conexão avisa que disparar em massa pode bloquear o número. Veja «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (artigo `conectar-whatsapp`).\n\n> **Dica:** Um disparo reabre conversas fora da janela de 24 horas porque usa template. Veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (artigo `janela-24-horas`).\n\n## Não funcionou?\n\n- **Sintoma:** O template não aparece na campanha\n - Causa provável: Não está aprovado ou o idioma não confere.\n - O que fazer: Confira o status do template: precisa estar aprovado.\n- **Sintoma:** Muitas falhas\n - Causa provável: Números inválidos ou sem WhatsApp, ou problema na conexão.\n - O que fazer: Confira a conexão do canal e a qualidade da lista de contatos.\n- **Sintoma:** Número bloqueado após disparo\n - Causa provável: Disparo em massa por QR Code.\n - O que fazer: Use a API Oficial Meta para campanhas.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Posso agendar?**\nSim, na hora ou agendado.\n\n**Preciso de template aprovado?**\nSim. A campanha usa template aprovado pela Meta.\n\n**Como segmento quem recebe?**\nPor tags e filtros, com prévia da audiência.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como faço um disparo em massa?\n- Posso agendar uma campanha?\n- Como vejo quem leu?\n- Meu número foi bloqueado depois do disparo\n\nResposta curta: Em Automações → Disparo em Massa → Nova campanha: escolha um template aprovado pela Meta, defina a audiência por tags e filtros e envie na hora ou agende. A tela mostra campanhas, contatos alcançados, enviadas, entregues, lidas, respondidas e falhas. Requer WhatsApp pela API Oficial; disparo em massa pelo QR Code pode bloquear o número.\n\nEscalar para um humano quando:\n- Template aprovado que não envia\n- Falhas em massa sem causa clara\n\nVeja também: «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (`conectar-whatsapp`); «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (`janela-24-horas`); «Automações: qual usar em cada situação» (`escolher-automacao`); «Criar e aprovar templates do WhatsApp oficial» (`templates-whatsapp`)\n" }, { "slug": "integracoes-e-provedores-de-ia", "categoria": "Painel e integrações", "titulo": "Conectar um provedor de IA e outras integrações", "resumo": "Ligue as chaves dos provedores de IA e de serviços externos para liberar modelos, pagamentos, agenda, bancos de dados e mais.", "tags": [ "integrações", "provedor de ia", "chave de api", "openai", "anthropic", "claude", "gemini", "deepseek", "google workspace", "baserow", "supabase", "cal.com", "clickup", "autentique", "conectada", "sem saldo" ], "publico": "Administradores.", "no_painel": [ "Integrações" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Posso conectar mais de um provedor de IA?", "resposta": "Sim. Isso permite usar um segundo provedor como fallback do agente." }, { "pergunta": "Onde vejo quais estão conectadas?", "resposta": "No contador do topo e no selo “conectada” de cada cartão." }, { "pergunta": "É seguro colar a chave aqui?", "resposta": "Cole somente na tela da integração. Nunca envie a chave em conversa ou e-mail." } ], "problemas": [ { "sintoma": "Todos os atendimentos falham de repente", "causa": "Chave revogada, inativa ou sem saldo no provedor.", "solucao": "Confira a integração e o saldo no provedor. Configure um fallback de outro provedor." }, { "sintoma": "O modelo que eu quero não aparece", "causa": "O provedor desse modelo não está conectado.", "solucao": "Conecte o provedor em Integrações." }, { "sintoma": "Frete e distância não funcionam", "causa": "A integração gratuita AwesomeAPI não está conectada.", "solucao": "Conecte em Integrações." } ], "para_ia": { "perguntas": [ "Como conecto a OpenAI ou o Claude?", "Onde coloco a chave de API?", "Por que meu modelo não aparece?", "Quais integrações existem?" ], "resposta": "Em Integrações, encontre o serviço, clique em Configurar e cole a chave de API na própria tela; o cartão passa a mostrar “conectada”. Os modelos dos provedores conectados ficam disponíveis na aba Modelo do agente. Sem saldo ou com chave revogada, os atendimentos falham. Nunca peça nem aceite chaves, senhas ou tokens na conversa; se enviarem, avise para não compartilhar e sugira trocar.", "escalar": [ "Dúvida sobre plano, cobrança ou limite de uso" ] }, "relacionados": [ "modelo-do-agente", "ia-nao-responde", "functions-do-agente", "ligar-seus-dados-ao-agente", "usar-a-api-e-o-mcp" ], "markdown": "---\nslug: integracoes-e-provedores-de-ia\ncategoria: Painel e integrações\natualizado: 17/10/2026\ntags: integrações, provedor de ia, chave de api, openai, anthropic, claude, gemini, deepseek, google workspace, baserow, supabase, cal.com, clickup, autentique, conectada, sem saldo\nno_painel: Integrações\nverificacao: conferido na tela do painel\n---\n\n# Conectar um provedor de IA e outras integrações\n\nLigue as chaves dos provedores de IA e de serviços externos para liberar modelos, pagamentos, agenda, bancos de dados e mais.\n\n**Para quem é:** Administradores.\n\n**Antes de começar:**\n- Conta no provedor de IA com chave de API e saldo\n\nA tela **Integrações** conecta serviços externos para uso nos agentes de IA, nas automações e nas ferramentas da plataforma. No topo direito ela mostra quantas estão configuradas, por exemplo **“4 de 33 configuradas”**.\n\n[Imagem: Tela Integrações com cartões de serviços como 9router, Anthropic Claude, Apify, Autentique, AwesomeAPI, Baserow, Cal.com, ClickUp, CNPJA, Comtele, DeepSeek e ElevenLabs. (1) Contador de integrações configuradas. (2) Botão Configurar de cada serviço. (3) Selo “conectada” nas integrações ativas.]\n\n## Tipos de integração\n\n| Tipo | Exemplos na tela | Para quê |\n|---|---|---|\n| Provedores de IA | Anthropic Claude, DeepSeek, outros modelos | Liberam os modelos que os agentes usam. |\n| Agenda e tarefas | Cal.com, ClickUp | O agente agenda e consulta tarefas. |\n| Dados | Baserow, Supabase | Ligam suas tabelas ao agente. |\n| Contratos e cobrança | Autentique | Assinatura digital de contratos. |\n| Endereço e empresas | AwesomeAPI, CNPJA, Apify | CEP, frete, prospecção e pesquisa. |\n| Voz e mensagens | ElevenLabs, Comtele | Vozes de alta qualidade, SMS e RCS. |\n\n## Passo a passo\n\n1. Abra `Integrações`.\n2. Encontre o serviço e clique em **Configurar**.\n3. Cole a **chave de API** ou siga a autorização do serviço, nos campos da própria tela.\n4. Salve. O cartão passa a mostrar o selo **conectada**.\n5. Volte ao agente, em **Modelo**, e escolha um modelo do provedor conectado. Veja «Escolher o modelo e ajustar temperatura, tokens e histórico» (artigo `modelo-do-agente`).\n\n> **Atenção:** **Nunca envie chaves, senhas ou tokens por mensagem** para a equipe de suporte ou para o agente. Cole a chave apenas na tela da integração. Se uma chave vazou, gere outra no provedor.\n\n> **Bom saber:** Algumas integrações dependem do plano ou de recursos liberados no workspace. Se um cartão aparecer bloqueado, é limite do plano.\n\n## Não funcionou?\n\n- **Sintoma:** Todos os atendimentos falham de repente\n - Causa provável: Chave revogada, inativa ou sem saldo no provedor.\n - O que fazer: Confira a integração e o saldo no provedor. Configure um fallback de outro provedor.\n- **Sintoma:** O modelo que eu quero não aparece\n - Causa provável: O provedor desse modelo não está conectado.\n - O que fazer: Conecte o provedor em `Integrações`.\n- **Sintoma:** Frete e distância não funcionam\n - Causa provável: A integração gratuita AwesomeAPI não está conectada.\n - O que fazer: Conecte em `Integrações`.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Posso conectar mais de um provedor de IA?**\nSim. Isso permite usar um segundo provedor como fallback do agente.\n\n**Onde vejo quais estão conectadas?**\nNo contador do topo e no selo “conectada” de cada cartão.\n\n**É seguro colar a chave aqui?**\nCole somente na tela da integração. Nunca envie a chave em conversa ou e-mail.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como conecto a OpenAI ou o Claude?\n- Onde coloco a chave de API?\n- Por que meu modelo não aparece?\n- Quais integrações existem?\n\nResposta curta: Em Integrações, encontre o serviço, clique em Configurar e cole a chave de API na própria tela; o cartão passa a mostrar “conectada”. Os modelos dos provedores conectados ficam disponíveis na aba Modelo do agente. Sem saldo ou com chave revogada, os atendimentos falham. Nunca peça nem aceite chaves, senhas ou tokens na conversa; se enviarem, avise para não compartilhar e sugira trocar.\n\nEscalar para um humano quando:\n- Dúvida sobre plano, cobrança ou limite de uso\n\nVeja também: «Escolher o modelo e ajustar temperatura, tokens e histórico» (`modelo-do-agente`); «A IA não responde: diagnóstico passo a passo» (`ia-nao-responde`); «Dar ações ao agente com Functions» (`functions-do-agente`); «Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp» (`ligar-seus-dados-ao-agente`); «Integrar outros sistemas pela API e pelo MCP» (`usar-a-api-e-o-mcp`)\n" }, { "slug": "configuracoes-do-painel", "categoria": "Painel e integrações", "titulo": "Configurações: notificações, fuso horário e o que acontece quando o cliente volta a escrever", "resumo": "Ajuste som, notificações e exibição do chat para você e, se for dono ou admin, PDFs, fuso horário, atribuição ao responder e reabertura de conversas.", "tags": [ "configurações", "notificações", "som", "chat ao vivo", "fila", "transcrição de áudio", "bolha do chat da equipe", "fuso horário", "reabertura de conversas", "assinatura", "preferências", "reabertura", "atribuir a quem responder", "pdf", "tarifa whatsapp" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Configurações" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "As preferências valem em todos os dispositivos?", "resposta": "Depende do bloco. Som e notificações do navegador valem só no dispositivo atual; *Receber notificações de mensagens na fila* vale em todos os dispositivos neste workspace." }, { "pergunta": "Quem altera fuso horário e reabertura de conversas?", "resposta": "Donos e administradores, nos ajustes do workspace." } ], "problemas": [ { "sintoma": "Não vejo a seção Workspace", "causa": "", "solucao": "Ela só aparece para o dono e os admins do workspace. Se você precisa mudar algo nela, peça a um deles." }, { "sintoma": "O botão aparece como \"Notificações bloqueadas\"", "causa": "", "solucao": "As notificações foram recusadas antes neste navegador. Para liberar:\n- clique no ícone à esquerda do endereço do site (um cadeado ou um ícone de ajustes);\n- em Notificações, escolha Permitir;\n- recarregue a página. Deve aparecer Notificações do navegador ativadas." }, { "sintoma": "Aparece \"Este navegador não suporta notificações do sistema.\"", "causa": "", "solucao": "Esse navegador não oferece notificações. Use um navegador atualizado que ofereça, como Chrome, Edge ou Firefox, no computador ou no Android. Os outros ajustes da página continuam funcionando." }, { "sintoma": "O som não toca", "causa": "", "solucao": "Confira se Som ao receber atendimento ou novo contato na fila está ligado neste aparelho e se a tela Conversas está aberta numa aba. O som toca quando uma conversa é atribuída a você ou quando um contato novo entra na fila, não a cada mensagem. Para o som de contato novo na fila, Receber notificações de mensagens na fila também precisa estar ligada. Confira também o volume do computador." }, { "sintoma": "Não recebo avisos das conversas na fila", "causa": "", "solucao": "Confira:\n- se Receber notificações de mensagens na fila está ligada. Ela vale por workspace: troque de workspace e confira em cada um;\n- se aparece Notificações do navegador ativadas neste aparelho;\n- se você enxerga a aba Novos. Quem não vê as conversas sem atendente não recebe esses avisos.\nSe aparecer Não foi possível carregar sua preferência., clique em Tentar novamente. Se aparecer Não foi possível salvar. Sua preferência anterior foi mantida., confira a sua internet e mude a chave de novo." }, { "sintoma": "O nome de quem atende não aparece antes das mensagens", "causa": "", "solucao": "A assinatura é escolhida por pessoa em «Convidar pessoas para a equipe e definir o que cada uma acessa», na coluna Assinatura da aba Membros, que só o dono e os admins veem. Confira se quem respondeu está com Envia: a assinatura só entra nas mensagens de texto enviadas depois dessa escolha. Ela não entra em mensagens da IA, de automações, de disparos, de e-mail nem em arquivos sem legenda. A pessoa também precisa ter o Nome completo preenchido em Meu perfil." }, { "sintoma": "Escolhi Manter o atendente anterior, mas a conversa não voltou para quem atendia", "causa": "", "solucao": "Isso acontece em dois casos:\n- o cliente só reagiu a uma mensagem com um emoji, no WhatsApp ou no Instagram. Nesse caso, a conversa sempre volta para Novos;\n- ninguém da equipe atendia a conversa antes. Ela reabre em Novos, sem atendente e com a IA pausada. Abra a conversa, clique em Mais ações e em Atribuir para passá-la a alguém." }, { "sintoma": "Um PDF chegou sem o texto", "causa": "", "solucao": "Confira:\n- se Extrair texto de PDFs recebidos está ligado;\n- se o PDF tem até 20 MB;\n- se é um PDF escaneado, como a foto de um papel. Ele não tem texto para ler, a não ser que a Mistral esteja configurada em Integrações com Usar Mistral OCR para PDFs (escaneados/tabelas) ligado;\n- se o limite mensal de PDFs lidos do seu plano acabou. Ele renova no mês seguinte; para aumentar, fale com o responsável pela sua agência." } ], "para_ia": { "perguntas": [ "Configurações?", "Não vejo a seção Workspace", "O botão aparece como \"Notificações bloqueadas\"", "Aparece \"Este navegador não suporta notificações do sistema.\"", "O som não toca" ], "resposta": "Ajuste som, notificações e exibição do chat para você e, se for dono ou admin, PDFs, fuso horário, atribuição ao responder e reabertura de conversas. No menu lateral, clique em Configurações. Em Notificações, deixe ligado Som ao receber atendimento ou novo contato na fila para ouvir um aviso quando uma conversa for atribuída a você ou quando um contato novo entrar na fila. O som toca enquanto a tela Conversas estiver aberta numa aba. Clique em Ativar notificações e, na pergunta do navegador, clique em Permitir. Quando aparecer Notificações do navegador ativadas, o navegador passa a avisar, mesmo com a aba em segundo plano, quando um cliente manda mensagem numa conversa sua ou numa conversa sem atendente que você enxerga na aba Novos. Os avisos valem para o workspace aberto: se você atende em mais de um, troque de workspace e abra Configurações em cada um. Ligue ou desligue Receber notifi", "escalar": [] }, "relacionados": [ "como-o-eloria-funciona", "outros-problemas-comuns", "atender-conversa", "entender-o-dashboard" ], "markdown": "---\nslug: configuracoes-do-painel\ncategoria: Painel e integrações\natualizado: 17/10/2026\ntags: configurações, notificações, som, chat ao vivo, fila, transcrição de áudio, bolha do chat da equipe, fuso horário, reabertura de conversas, assinatura, preferências, reabertura, atribuir a quem responder, pdf, tarifa whatsapp\nno_painel: Configurações\nverificacao: baseado no guia oficial do painel\n---\n\n# Configurações: notificações, fuso horário e o que acontece quando o cliente volta a escrever\n\nAjuste som, notificações e exibição do chat para você e, se for dono ou admin, PDFs, fuso horário, atribuição ao responder e reabertura de conversas.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- **Configurações** aparece no menu lateral para todos da equipe.\n- Os ajustes de **Notificações** e **Chat ao vivo** são salvos na hora. Quase todos valem só neste navegador: em outro computador ou celular, ajuste de novo. A exceção é **Receber notificações de mensagens na fila**, que fica salva na sua conta, para o workspace aberto, e vale em todos os seus aparelhos.\n- A seção **Workspace** só aparece para o dono e os admins do workspace. As mudanças dela valem para todos e só são gravadas quando você clica em **Salvar**.\n\nEm **Configurações** ficam dois tipos de ajuste. Os de **Notificações** e **Chat ao vivo** valem só para você e, quase todos, só no navegador e no aparelho que você está usando. Os da seção **Workspace** valem para a equipe toda: a leitura de PDFs, o fuso horário, quem fica com a conversa quando outro atendente responde e o que acontece quando um cliente escreve de novo numa conversa já resolvida.\n\n[Imagem: Página Configurações com os blocos Notificações e Chat ao vivo. (1) Som ao receber atendimento ou novo contato na fila. (2) Receber notificações de mensagens na fila. (3) Informações do contato. (4) Exibir transcrição de áudios no chat.]\n\n## Ajustar as suas notificações e o chat\n\n1. No menu lateral, clique em **Configurações**.\n2. Em **Notificações**, deixe ligado **Som ao receber atendimento ou novo contato na fila** para ouvir um aviso quando uma conversa for atribuída a você ou quando um contato novo entrar na fila. O som toca enquanto a tela **Conversas** estiver aberta numa aba.\n3. Clique em **Ativar notificações** e, na pergunta do navegador, clique em **Permitir**. Quando aparecer **Notificações do navegador ativadas**, o navegador passa a avisar, mesmo com a aba em segundo plano, quando um cliente manda mensagem numa conversa sua ou numa conversa sem atendente que você enxerga na aba **Novos**. Os avisos valem para o workspace aberto: se você atende em mais de um, troque de workspace e abra **Configurações** em cada um.\n4. Ligue ou desligue **Receber notificações de mensagens na fila**. A escolha é salva na hora, e aparece **Preferência salva.** Desligada, você deixa de receber os avisos do navegador das conversas sem atendente e o som de contato novo na fila, neste workspace e em todos os seus aparelhos. Os avisos das conversas atribuídas a você e das menções continuam.\n5. Em **Chat ao vivo**, escolha o que aparece nas conversas:\n - **Informações do contato**: com **Sempre aberto**, o painel do contato abre sozinho quando você seleciona uma conversa no computador. Com **Abrir ao clicar**, o padrão, ele só abre quando você pede. No celular, ele só abre quando você pede, qualquer que seja a escolha. A mesma opção aparece no topo do painel do contato.\n - **Exibir transcrição de áudios no chat**: mostra o texto dos áudios transcritos. Esta opção só mostra ou esconde o texto; ela não liga a transcrição.\n - **Exibir bolha do chat da equipe nas conversas**: mostra o botão flutuante do chat interno da equipe na tela **Conversas**. Desligado, ele some só de lá e continua nas outras telas. Veja «Conversar com a equipe pelo chat interno» (artigo `conversar-com-a-equipe`).\n\n## Ajustar o workspace (dono e admins)\n\n1. Em **Workspace**, ligue as opções que quiser:\n - **Extrair texto de PDFs recebidos**: quando um cliente envia um PDF, o texto dele aparece na conversa, e o agente de IA também consegue lê-lo.\n2. Em **Fuso horário**, escolha o fuso da sua operação, por exemplo *(UTC-03:00) America/Sao_Paulo*. Ele define o que conta como hoje no Dashboard, as datas e horas usadas nas mensagens automáticas e nas automações por data e o **Horário de atendimento** da equipe.\n3. Em **Quando outro atendente responder**, escolha **Atribuir automaticamente a quem responder** para transferir a conversa ao colega que enviar uma resposta manual. O padrão é **Não fazer nada — manter o responsável atual**. A pessoa precisa ter acesso à conversa e estar disponível dentro do seu horário de atendimento. Conversas sem responsável continuam sendo atribuídas a quem responder.\n4. Em **Quando um contato inicia novo atendimento**, escolha o que acontece quando o cliente escreve de novo numa conversa já resolvida, em qualquer canal:\n - **Voltar para a Fila (a IA volta a atender)**, o padrão: a conversa reabre sem atendente. Se houver um agente de IA atendendo esse número, ele volta a responder; se não, a conversa espera em **Novos** até alguém assumir. Quem atendia antes deixa de ser o responsável. Se a conversa estava numa pasta, ela reaparece dentro da pasta.\n - **Manter o atendente anterior (Em atendimento, IA fica pausada)**: a conversa reabre com a mesma pessoa, na aba **Meus atendimentos** dessa pessoa, e a IA fica pausada nela. É a melhor escolha quando o cliente costuma voltar para falar com quem já o atendeu.\n5. Se a equipe usa o custo estimado do Dashboard, preencha também a tarifa por mensagem do WhatsApp Business. Em branco, o custo não aparece. Veja «Entender o Dashboard: atendimento, negócios e anúncios» (artigo `entender-o-dashboard`). Escolha a moeda da estimativa (dólar americano, euro ou real brasileiro) e informe a tarifa nessa moeda. A escolha vale para custos, gráficos e simulador; não há conversão cambial automática.\n6. Clique em **Salvar** e aguarde a mensagem **Workspace atualizado.**\n\n## Não funcionou?\n\n- **Não vejo a seção Workspace**\n Ela só aparece para o dono e os admins do workspace. Se você precisa mudar algo nela, peça a um deles.\n- **O botão aparece como \"Notificações bloqueadas\"**\n As notificações foram recusadas antes neste navegador. Para liberar:\n - clique no ícone à esquerda do endereço do site (um cadeado ou um ícone de ajustes);\n - em **Notificações**, escolha **Permitir**;\n - recarregue a página. Deve aparecer **Notificações do navegador ativadas**.\n- **Aparece \"Este navegador não suporta notificações do sistema.\"**\n Esse navegador não oferece notificações. Use um navegador atualizado que ofereça, como Chrome, Edge ou Firefox, no computador ou no Android. Os outros ajustes da página continuam funcionando.\n- **O som não toca**\n Confira se **Som ao receber atendimento ou novo contato na fila** está ligado neste aparelho e se a tela **Conversas** está aberta numa aba. O som toca quando uma conversa é atribuída a você ou quando um contato novo entra na fila, não a cada mensagem. Para o som de contato novo na fila, **Receber notificações de mensagens na fila** também precisa estar ligada. Confira também o volume do computador.\n- **Não recebo avisos das conversas na fila**\n Confira:\n - se **Receber notificações de mensagens na fila** está ligada. Ela vale por workspace: troque de workspace e confira em cada um;\n - se aparece **Notificações do navegador ativadas** neste aparelho;\n - se você enxerga a aba **Novos**. Quem não vê as conversas sem atendente não recebe esses avisos.\n Se aparecer **Não foi possível carregar sua preferência.**, clique em **Tentar novamente**. Se aparecer **Não foi possível salvar. Sua preferência anterior foi mantida.**, confira a sua internet e mude a chave de novo.\n- **O nome de quem atende não aparece antes das mensagens**\n A assinatura é escolhida por pessoa em «Convidar pessoas para a equipe e definir o que cada uma acessa» (artigo `convidar-equipe`), na coluna **Assinatura** da aba **Membros**, que só o dono e os admins veem. Confira se quem respondeu está com **Envia**: a assinatura só entra nas mensagens de texto enviadas depois dessa escolha. Ela não entra em mensagens da IA, de automações, de disparos, de e-mail nem em arquivos sem legenda. A pessoa também precisa ter o **Nome completo** preenchido em **Meu perfil**.\n- **Escolhi Manter o atendente anterior, mas a conversa não voltou para quem atendia**\n Isso acontece em dois casos:\n - o cliente só reagiu a uma mensagem com um emoji, no WhatsApp ou no Instagram. Nesse caso, a conversa sempre volta para **Novos**;\n - ninguém da equipe atendia a conversa antes. Ela reabre em **Novos**, sem atendente e com a IA pausada. Abra a conversa, clique em **Mais ações** e em **Atribuir** para passá-la a alguém.\n- **Um PDF chegou sem o texto**\n Confira:\n - se **Extrair texto de PDFs recebidos** está ligado;\n - se o PDF tem até 20 MB;\n - se é um PDF escaneado, como a foto de um papel. Ele não tem texto para ler, a não ser que a Mistral esteja configurada em **Integrações** com **Usar Mistral OCR para PDFs (escaneados/tabelas)** ligado;\n - se o limite mensal de PDFs lidos do seu plano acabou. Ele renova no mês seguinte; para aumentar, fale com o responsável pela sua agência.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**As preferências valem em todos os dispositivos?**\nDepende do bloco. Som e notificações do navegador valem só no dispositivo atual; *Receber notificações de mensagens na fila* vale em todos os dispositivos neste workspace.\n\n**Quem altera fuso horário e reabertura de conversas?**\nDonos e administradores, nos ajustes do workspace.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Configurações?\n- Não vejo a seção Workspace\n- O botão aparece como \"Notificações bloqueadas\"\n- Aparece \"Este navegador não suporta notificações do sistema.\"\n- O som não toca\n\nResposta curta: Ajuste som, notificações e exibição do chat para você e, se for dono ou admin, PDFs, fuso horário, atribuição ao responder e reabertura de conversas. No menu lateral, clique em Configurações. Em Notificações, deixe ligado Som ao receber atendimento ou novo contato na fila para ouvir um aviso quando uma conversa for atribuída a você ou quando um contato novo entrar na fila. O som toca enquanto a tela Conversas estiver aberta numa aba. Clique em Ativar notificações e, na pergunta do navegador, clique em Permitir. Quando aparecer Notificações do navegador ativadas, o navegador passa a avisar, mesmo com a aba em segundo plano, quando um cliente manda mensagem numa conversa sua ou numa conversa sem atendente que você enxerga na aba Novos. Os avisos valem para o workspace aberto: se você atende em mais de um, troque de workspace e abra Configurações em cada um. Ligue ou desligue Receber notifi\n\nVeja também: «Como o Elor.ia funciona: do canal à resposta da IA» (`como-o-eloria-funciona`); «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (`outros-problemas-comuns`); «Atender uma conversa: assumir, transferir e encerrar» (`atender-conversa`); «Entender o Dashboard: atendimento, negócios e anúncios» (`entender-o-dashboard`)\n" }, { "slug": "equipes-de-ia", "categoria": "Agentes de IA", "titulo": "Montar uma equipe de agentes de IA", "resumo": "Junte agentes especialistas sob um roteador (manager) que lê cada mensagem e passa para quem sabe responder.", "tags": [ "equipes de ia", "equipe de agentes", "manager", "roteador", "especialista", "vendas", "financeiro", "suporte", "multiagente" ], "publico": "Administradores com mais de um agente.", "no_painel": [ "Agentes IA", "Equipes de IA" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Preciso de equipe para ter mais de um agente?", "resposta": "Não. Você pode ter agentes independentes em canais diferentes. A equipe serve para dividir assuntos em um mesmo atendimento." } ], "problemas": [ { "sintoma": "A mensagem vai para o agente errado", "causa": "As instruções do manager não distinguem bem os assuntos.", "solucao": "Descreva com clareza o que cada especialista atende." } ], "para_ia": { "perguntas": [ "O que é uma equipe de agentes?", "Como faço um agente passar para outro?", "Como separo vendas e suporte?" ], "resposta": "Em Agentes IA → Equipes de IA, uma equipe junta vários agentes sob um manager (roteador) que lê cada mensagem e passa para o especialista certo, como vendas, financeiro ou suporte. Crie e teste os especialistas antes de montar a equipe.", "escalar": [] }, "relacionados": [ "criar-agente", "ensinar-agente" ], "markdown": "---\nslug: equipes-de-ia\ncategoria: Agentes de IA\natualizado: 17/10/2026\ntags: equipes de ia, equipe de agentes, manager, roteador, especialista, vendas, financeiro, suporte, multiagente\nno_painel: Agentes IA > Equipes de IA\nverificacao: conferido na tela do painel\n---\n\n# Montar uma equipe de agentes de IA\n\nJunte agentes especialistas sob um roteador (manager) que lê cada mensagem e passa para quem sabe responder.\n\n**Para quem é:** Administradores com mais de um agente.\n\n**Antes de começar:**\n- Dois ou mais agentes criados (veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`))\n\nUma **Equipe de IA** orquestra vários agentes com um **roteador (manager)**. O manager lê cada mensagem e a passa para o agente especialista adequado, como **vendas**, **financeiro** ou **suporte**. Assim cada agente fica com instruções e conhecimento enxutos.\n\n[Imagem: Tela Equipes de IA vazia com o botão Nova equipe. (1) Nova equipe. Quando não há equipes, a tela explica: “Crie uma equipe para orquestrar vários agentes com um roteador.”]\n\n## Quando vale a pena\n\n- Você atende assuntos muito diferentes no mesmo número (vendas, cobrança, suporte).\n- As instruções de um único agente ficaram longas e confusas.\n- Cada área precisa de conhecimento e functions próprios.\n\n## Passo a passo\n\n1. Crie e teste os agentes especialistas primeiro. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n2. Abra `Agentes IA` → `Equipes de IA` e clique em **Nova equipe**.\n3. Escolha o manager (roteador) e os agentes que fazem parte da equipe.\n4. Salve e teste mandando mensagens de cada assunto.\n\n> **Bom saber:** Os campos da criação de equipe não foram capturados nesta revisão; os passos 3 e 4 seguem a descrição oficial do painel.\n\n## Não funcionou?\n\n- **Sintoma:** A mensagem vai para o agente errado\n - Causa provável: As instruções do manager não distinguem bem os assuntos.\n - O que fazer: Descreva com clareza o que cada especialista atende.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Preciso de equipe para ter mais de um agente?**\nNão. Você pode ter agentes independentes em canais diferentes. A equipe serve para dividir assuntos em um mesmo atendimento.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- O que é uma equipe de agentes?\n- Como faço um agente passar para outro?\n- Como separo vendas e suporte?\n\nResposta curta: Em Agentes IA → Equipes de IA, uma equipe junta vários agentes sob um manager (roteador) que lê cada mensagem e passa para o especialista certo, como vendas, financeiro ou suporte. Crie e teste os especialistas antes de montar a equipe.\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados» (`ensinar-agente`)\n" }, { "slug": "atender-conversa", "categoria": "Conversas", "titulo": "Atender uma conversa: assumir, transferir e encerrar", "resumo": "As abas de Conversas, como assumir e responder, transferir para um colega ou departamento, deixar pendente, resolver e reabrir.", "tags": [ "conversas", "assumir", "atribuir", "transferir", "departamento", "resolver", "encerrar", "reabrir", "pendente", "novos", "meus atendimentos", "outros", "resolvidas", "fila", "responder manualmente", "pausar ia" ], "publico": "Atendentes, donos e administradores.", "no_painel": [ "Conversas" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Qual a diferença entre pendente e resolvida?", "resposta": "Pendente continua com o atendente, na mesma aba, esperando o cliente. Resolvida encerra o atendimento e vai para a aba Resolvidas." }, { "pergunta": "Transferir para um departamento entrega para quem?", "resposta": "Para a próxima pessoa disponível do departamento, em rodízio. Se ninguém estiver disponível, vai para o dono do workspace, se ele estiver disponível." }, { "pergunta": "A IA volta a responder depois que eu assumo?", "resposta": "Não nessa conversa, enquanto ela estiver com você. Se você usar Mover para Novos, a IA volta a atender." } ], "problemas": [ { "sintoma": "Não encontro as abas Fila, Em atendimento ou Pendentes", "causa": "As abas mudaram de nome. A antiga Fila é Novos; Em atendimento e Pendentes ficam em Meus atendimentos (com você) ou Outros (com colegas).", "solucao": "Use as abas novas ou a busca, que procura em todas." }, { "sintoma": "Respondi, mas a conversa não ficou comigo", "causa": "Você está indisponível, fora do seu horário, ou a conversa já tinha outro responsável e a atribuição ao responder está desligada.", "solucao": "Ligue Disponível para atendimento no perfil. Se ela era de um colega, use Atribuir." }, { "sintoma": "Não encontro uma conversa", "causa": "Filtro ligado, conversa com um colega, numa conexão que você não vê, ou removida da inbox.", "solucao": "Clique em Limpar ao lado de Filtros e busque de novo. Veja «Filtros, etiquetas e pastas das conversas»." }, { "sintoma": "A pessoa não aparece em Atendentes, ou aparece “Nenhum atendente disponível para este destino”", "causa": "Só recebe quem está disponível e dentro do horário de atendimento.", "solucao": "Peça para a pessoa ligar a disponibilidade ou escolha outra. Veja «Ficar disponível ou ausente para receber conversas»." }, { "sintoma": "A caixa de texto diz “Janela de 24h fechada — envie um template aprovado”", "causa": "Na API Oficial, o cliente não escreve há mais de 24 horas.", "solucao": "Clique em Enviar template. No Instagram, espere o cliente escrever. Veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial»." }, { "sintoma": "Resolvi a conversa sem querer", "causa": "Clique acidental no ✓.", "solucao": "Clique em Desfazer logo em seguida. Se sumiu, reabra pela aba Resolvidas." }, { "sintoma": "A IA respondeu enquanto eu escrevia", "causa": "Depois de Responder manualmente, a IA só para quando você envia.", "solucao": "Para pará-la antes, clique em Pausar IA no aviso do topo." } ], "para_ia": { "perguntas": [ "Como assumo uma conversa?", "Como transfiro para outro atendente ou departamento?", "Onde foi parar a aba Fila?", "Como reabro uma conversa resolvida?", "Respondi e a conversa não ficou comigo" ], "resposta": "Em Conversas há quatro abas: Novos (sem atendente), Meus atendimentos (com você, inclui pendentes), Outros (com colegas) e Resolvidas. Ao enviar uma mensagem numa conversa sem atendente, ela passa a ser sua. Se a IA estiver atendendo, clique em Responder manualmente. Para transferir: Mais ações (⋮) → Atribuir → pessoa ou departamento (rodízio entre os disponíveis). Mover para Novos devolve à fila e a IA volta. Resolver (✓) encerra, com Desfazer; Reabrir fica na aba Resolvidas. Se o cliente escrever depois de resolvida, a conversa reabre sozinha em Novos.", "escalar": [ "Conversa some ou muda de dono sem ninguém ter mexido", "Pedido para mudar permissões de outra pessoa" ] }, "relacionados": [ "disponivel-ou-ausente", "filtros-etiquetas-e-pastas", "ferramentas-da-conversa", "janela-24-horas" ], "markdown": "---\nslug: atender-conversa\ncategoria: Conversas\natualizado: 17/10/2026\ntags: conversas, assumir, atribuir, transferir, departamento, resolver, encerrar, reabrir, pendente, novos, meus atendimentos, outros, resolvidas, fila, responder manualmente, pausar ia\nno_painel: Conversas\nverificacao: baseado no guia oficial do painel\n---\n\n# Atender uma conversa: assumir, transferir e encerrar\n\nAs abas de Conversas, como assumir e responder, transferir para um colega ou departamento, deixar pendente, resolver e reabrir.\n\n**Para quem é:** Atendentes, donos e administradores.\n\n**Antes de começar:**\n- Acesso ao menu `Conversas`\n- **Disponível para atendimento** ligado no seu perfil (veja «Ficar disponível ou ausente para receber conversas» (artigo `disponivel-ou-ausente`))\n\nEm `Conversas` você cuida de cada atendimento do começo ao fim: assume, responde, passa para outra pessoa quando precisar e resolve quando o assunto termina. Assim a equipe sempre sabe quem está com cada cliente.\n\n[Esquema: Para onde a conversa vai em cada ação.]\n\n## As quatro abas\n\n| Aba | O que mostra |\n|---|---|\n| **Novos** | Conversas sem atendente. A IA pode estar respondendo nelas; as com IA pausada também ficam aqui. |\n| **Meus atendimentos** | Conversas que estão com você, inclusive as marcadas como pendentes. No aplicativo instalado, aparece como **Meus**. |\n| **Outros** | Conversas com colegas. |\n| **Resolvidas** | Atendimentos encerrados. |\n\n> **Bom saber:** Donos e administradores veem todas as conversas. Atendentes veem as próprias; para ver **Novos** e **Outros**, quem administra a equipe liga *Ver Fila (conversas sem atendente)* e *Ver conversas de outros agentes* em `Equipe`. Veja «Convidar pessoas para a equipe e definir o que cada uma acessa» (artigo `convidar-equipe`).\n\n## Assumir e responder\n\n1. No menu lateral, clique em `Conversas` e escolha uma aba. A busca no topo da lista procura por nome, telefone ou e-mail em todas as abas.\n2. Clique na conversa, escreva em *Digite uma mensagem…* e aperte **Enter** (**Shift + Enter** quebra a linha).\n3. Se a conversa estava sem atendente, ela passa a ser sua quando você envia e vai para **Meus atendimentos**.\n4. Se aparecer o aviso de que a IA está atendendo, clique em **Responder manualmente**. A IA para nesta conversa quando você envia.\n5. Para assumir antes de responder: **Mais ações** (⋮) → **Atribuir** → seu nome.\n\n> **Bom saber:** Se a conversa já está com um colega, responder só passa ela para você quando o dono ou um admin ativou **Atribuir automaticamente a quem responder** em Configurações do workspace. Veja «Configurações: notificações, fuso horário e o que acontece quando o cliente volta a escrever» (artigo `configuracoes-do-painel`).\n\n## Transferir\n\n1. Clique em **Mais ações** (⋮) → **Atribuir**.\n2. Na janela **Atribuir conversa**, escolha uma pessoa em **Atendentes** ou um departamento em **Departamentos**. No departamento, o painel entrega em rodízio para a próxima pessoa disponível; se ninguém estiver disponível, vai para o dono do workspace, se ele estiver disponível.\n3. O nome de quem atende aparece no topo. Para você, a conversa passa a aparecer em **Outros**.\n\nPara devolver sem escolher ninguém: **Mais ações** (⋮) → **Mover para Novos**. A conversa fica sem atendente e a IA volta a atender, se houver uma.\n\n## Deixar pendente, resolver e reabrir\n\n- **Marcar como pendente** (em ⋮): para atendimento parado esperando o cliente. A conversa continua com o mesmo atendente e na mesma aba; não existe aba de pendentes.\n- **Resolver conversa** (ícone ✓ no topo): fecha, mostra *Conversa resolvida* com **Desfazer** e vai para **Resolvidas**. Follow-up agendado é cancelado.\n- **Reabrir conversa** (seta circular, na aba Resolvidas): volta para quem atendia; se não tinha atendente, vai para **Novos**.\n\n> **Atenção:** Se o cliente escrever de novo numa conversa resolvida, ela **reabre sozinha** em **Novos**, sem atendente, e a IA volta a atender. Para voltar direto a quem atendia, o dono ou um admin escolhe *Manter o atendente anterior* em Configurações, no campo *Quando um contato inicia novo atendimento*.\n\n## Não funcionou?\n\n- **Sintoma:** Não encontro as abas Fila, Em atendimento ou Pendentes\n - Causa provável: As abas mudaram de nome. A antiga Fila é **Novos**; Em atendimento e Pendentes ficam em **Meus atendimentos** (com você) ou **Outros** (com colegas).\n - O que fazer: Use as abas novas ou a busca, que procura em todas.\n- **Sintoma:** Respondi, mas a conversa não ficou comigo\n - Causa provável: Você está indisponível, fora do seu horário, ou a conversa já tinha outro responsável e a atribuição ao responder está desligada.\n - O que fazer: Ligue **Disponível para atendimento** no perfil. Se ela era de um colega, use **Atribuir**.\n- **Sintoma:** Não encontro uma conversa\n - Causa provável: Filtro ligado, conversa com um colega, numa conexão que você não vê, ou removida da inbox.\n - O que fazer: Clique em **Limpar** ao lado de Filtros e busque de novo. Veja «Filtros, etiquetas e pastas das conversas» (artigo `filtros-etiquetas-e-pastas`).\n- **Sintoma:** A pessoa não aparece em Atendentes, ou aparece “Nenhum atendente disponível para este destino”\n - Causa provável: Só recebe quem está disponível e dentro do horário de atendimento.\n - O que fazer: Peça para a pessoa ligar a disponibilidade ou escolha outra. Veja «Ficar disponível ou ausente para receber conversas» (artigo `disponivel-ou-ausente`).\n- **Sintoma:** A caixa de texto diz “Janela de 24h fechada — envie um template aprovado”\n - Causa provável: Na API Oficial, o cliente não escreve há mais de 24 horas.\n - O que fazer: Clique em **Enviar template**. No Instagram, espere o cliente escrever. Veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (artigo `janela-24-horas`).\n- **Sintoma:** Resolvi a conversa sem querer\n - Causa provável: Clique acidental no ✓.\n - O que fazer: Clique em **Desfazer** logo em seguida. Se sumiu, reabra pela aba **Resolvidas**.\n- **Sintoma:** A IA respondeu enquanto eu escrevia\n - Causa provável: Depois de **Responder manualmente**, a IA só para quando você envia.\n - O que fazer: Para pará-la antes, clique em **Pausar IA** no aviso do topo.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Qual a diferença entre pendente e resolvida?**\nPendente continua com o atendente, na mesma aba, esperando o cliente. Resolvida encerra o atendimento e vai para a aba Resolvidas.\n\n**Transferir para um departamento entrega para quem?**\nPara a próxima pessoa disponível do departamento, em rodízio. Se ninguém estiver disponível, vai para o dono do workspace, se ele estiver disponível.\n\n**A IA volta a responder depois que eu assumo?**\nNão nessa conversa, enquanto ela estiver com você. Se você usar **Mover para Novos**, a IA volta a atender.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como assumo uma conversa?\n- Como transfiro para outro atendente ou departamento?\n- Onde foi parar a aba Fila?\n- Como reabro uma conversa resolvida?\n- Respondi e a conversa não ficou comigo\n\nResposta curta: Em Conversas há quatro abas: Novos (sem atendente), Meus atendimentos (com você, inclui pendentes), Outros (com colegas) e Resolvidas. Ao enviar uma mensagem numa conversa sem atendente, ela passa a ser sua. Se a IA estiver atendendo, clique em Responder manualmente. Para transferir: Mais ações (⋮) → Atribuir → pessoa ou departamento (rodízio entre os disponíveis). Mover para Novos devolve à fila e a IA volta. Resolver (✓) encerra, com Desfazer; Reabrir fica na aba Resolvidas. Se o cliente escrever depois de resolvida, a conversa reabre sozinha em Novos.\n\nEscalar para um humano quando:\n- Conversa some ou muda de dono sem ninguém ter mexido\n- Pedido para mudar permissões de outra pessoa\n\nVeja também: «Ficar disponível ou ausente para receber conversas» (`disponivel-ou-ausente`); «Filtros, etiquetas e pastas das conversas» (`filtros-etiquetas-e-pastas`); «Ferramentas da conversa: iniciar, anotar, agendar e usar a IA» (`ferramentas-da-conversa`); «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (`janela-24-horas`)\n" }, { "slug": "respostas-rapidas-e-galeria", "categoria": "Conversas", "titulo": "Usar respostas rápidas e a galeria de mídias", "resumo": "Crie mensagens prontas com atalho e variáveis, use-as digitando / na conversa e envie arquivos guardados na galeria.", "tags": [ "respostas rápidas", "atalho", "barra", "mensagem pronta", "template interno", "variável", "primeiro nome", "galeria de mídias", "enviar arquivo", "pdf", "imagem", "vídeo", "pública", "privada" ], "publico": "Atendentes, donos e administradores.", "no_painel": [ "Conversas", "Respostas Rápidas" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "A variável de nome funciona em qualquer canal?", "resposta": "Sim. Na hora de usar, o painel troca a variável pelo dado do cliente da conversa." }, { "pergunta": "Quem pode apagar arquivos da galeria?", "resposta": "Só o dono e os admins do workspace." }, { "pergunta": "Posso compartilhar uma resposta privada com a equipe?", "resposta": "Sim. Edite, escolha *Pública (todo o workspace)* em Visibilidade e salve." } ], "problemas": [ { "sintoma": "A opção Pública aparece desativada, ou não vejo lápis e lixeira", "causa": "Só dono e admins criam direto uma resposta pública e gerenciam as já publicadas.", "solucao": "Crie como privada e depois edite para publicar, ou peça a um admin." }, { "sintoma": "Digitei / e a lista não apareceu", "causa": "A barra precisa ser a primeira coisa no campo e combinar com alguma resposta; ou a IA está atendendo.", "solucao": "Apague o campo e digite de novo. Se a IA estiver atendendo, clique antes em Responder manualmente." }, { "sintoma": "Respostas rápidas e Usar da galeria aparecem desativadas", "causa": "Na API Oficial, a janela de 24 horas fechou.", "solucao": "Envie um template aprovado. Veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial»." }, { "sintoma": "O arquivo não entrou na galeria", "causa": "Tipo não aceito, arquivo acima do limite ou falha de rede.", "solucao": "Use um formato aceito, diminua o arquivo ou clique em Tentar novamente." }, { "sintoma": "A galeria mostra “Limite atingido”", "causa": "O espaço da galeria acabou.", "solucao": "Dono ou admin exclui arquivos sem uso (a exclusão é imediata e sem confirmação)." } ], "para_ia": { "perguntas": [ "Como crio uma resposta rápida?", "Como uso o atalho com barra?", "Como envio um PDF que está na galeria?", "Qual o tamanho máximo de arquivo?" ], "resposta": "Em Respostas Rápidas → Nova resposta: título, atalho (sem espaços), mensagem com variáveis em {} e visibilidade privada ou pública; mídia opcional. Na conversa, digite / com o campo vazio, ou use ☰ → Respostas rápidas. Resposta com arquivo é enviada na hora. Na Galeria de mídias, envie arquivos (imagem até 5 MB; vídeo e documento até 16 MB) e use ☰ → Usar da galeria na conversa. Só dono e admins publicam diretamente e excluem da galeria.", "escalar": [ "Falha repetida de upload com arquivo dentro do limite" ] }, "relacionados": [ "atender-conversa", "ferramentas-da-conversa", "janela-24-horas" ], "markdown": "---\nslug: respostas-rapidas-e-galeria\ncategoria: Conversas\natualizado: 17/10/2026\ntags: respostas rápidas, atalho, barra, mensagem pronta, template interno, variável, primeiro nome, galeria de mídias, enviar arquivo, pdf, imagem, vídeo, pública, privada\nno_painel: Conversas > Respostas Rápidas\nverificacao: baseado no guia oficial do painel\n---\n\n# Usar respostas rápidas e a galeria de mídias\n\nCrie mensagens prontas com atalho e variáveis, use-as digitando / na conversa e envie arquivos guardados na galeria.\n\n**Para quem é:** Atendentes, donos e administradores.\n\n**Antes de começar:**\n- Acesso ao menu `Conversas`\n\nAs **respostas rápidas** guardam as mensagens que você manda sempre, já com o nome do cliente. A **Galeria de mídias** deixa imagens, vídeos e documentos à mão, para enviar sem procurar o arquivo toda vez.\n\n> **Bom saber:** Qualquer pessoa da equipe cria respostas **privadas** e pode publicá-las. Respostas já **públicas** são gerenciadas pelo dono e pelos admins. Na galeria, todos enviam arquivos, mas só dono e admins excluem.\n\n## Criar uma resposta rápida\n\n1. No menu lateral, clique em `Respostas Rápidas` (logo abaixo de Conversas) e em **Nova resposta**.\n2. Em **Título**, um nome fácil de achar, como *Boas-vindas*. Em **Atalho**, uma palavra curta sem espaços, como `ola`.\n3. Em **Mensagem**, escreva o texto. Para personalizar, clique em **{}** (Inserir variável) e escolha, por exemplo, *Primeiro nome*.\n4. Em **Visibilidade**, escolha *Privada (só eu)* ou *Pública (todo o workspace)*.\n5. Se quiser um arquivo junto, use **Mídia (opcional)**: do computador ou da **Galeria**. O texto vira legenda.\n6. Clique em **Salvar**. O lápis edita e a lixeira apaga.\n\n## Usar na conversa\n\n- **Pela barra:** com o campo vazio, digite `/` e o atalho ou o título; clique na resposta ou use as setas e Enter.\n- **Pelo menu:** botão **☰** (Ações da mensagem) → **Respostas rápidas**. A aba *Time* tem as do workspace; *Minhas*, as suas.\n- **Atalho direto:** digite `/ola` seguido de espaço e o texto entra na hora.\n\n> **Atenção:** Uma resposta **com arquivo** (marcada com um clipe) é **enviada na hora** que você a escolhe, sem passar pelo campo de mensagem. Confira antes de clicar.\n\n## Enviar um arquivo da galeria\n\n1. Em `Galeria de mídias`, clique em **Enviar mídia** e escolha os arquivos. Deixe a página aberta até a **Fila de uploads** terminar.\n2. Na conversa, clique em **☰** → **Usar da galeria**.\n3. Filtre por Imagens, Vídeos ou Documentos, ou busque pelo nome, e clique no arquivo. Ele é enviado na hora, sem legenda.\n\n| Tipo de arquivo | Limite |\n|---|---|\n| Imagem | 5 MB |\n| Vídeo | 16 MB |\n| Documento (PDF, Word, Excel, PPT, txt) | 16 MB |\n\n> **Dica:** Organize com **Nova pasta** e **Selecionar** → **Mover para…**. Imagens e vídeos enviados nas conversas entram na galeria sozinhos, com o selo *Enviada em conversa*.\n\n## Não funcionou?\n\n- **Sintoma:** A opção Pública aparece desativada, ou não vejo lápis e lixeira\n - Causa provável: Só dono e admins criam direto uma resposta pública e gerenciam as já publicadas.\n - O que fazer: Crie como privada e depois edite para publicar, ou peça a um admin.\n- **Sintoma:** Digitei / e a lista não apareceu\n - Causa provável: A barra precisa ser a primeira coisa no campo e combinar com alguma resposta; ou a IA está atendendo.\n - O que fazer: Apague o campo e digite de novo. Se a IA estiver atendendo, clique antes em **Responder manualmente**.\n- **Sintoma:** Respostas rápidas e Usar da galeria aparecem desativadas\n - Causa provável: Na API Oficial, a janela de 24 horas fechou.\n - O que fazer: Envie um template aprovado. Veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (artigo `janela-24-horas`).\n- **Sintoma:** O arquivo não entrou na galeria\n - Causa provável: Tipo não aceito, arquivo acima do limite ou falha de rede.\n - O que fazer: Use um formato aceito, diminua o arquivo ou clique em **Tentar novamente**.\n- **Sintoma:** A galeria mostra “Limite atingido”\n - Causa provável: O espaço da galeria acabou.\n - O que fazer: Dono ou admin exclui arquivos sem uso (a exclusão é imediata e sem confirmação).\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**A variável de nome funciona em qualquer canal?**\nSim. Na hora de usar, o painel troca a variável pelo dado do cliente da conversa.\n\n**Quem pode apagar arquivos da galeria?**\nSó o dono e os admins do workspace.\n\n**Posso compartilhar uma resposta privada com a equipe?**\nSim. Edite, escolha *Pública (todo o workspace)* em Visibilidade e salve.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como crio uma resposta rápida?\n- Como uso o atalho com barra?\n- Como envio um PDF que está na galeria?\n- Qual o tamanho máximo de arquivo?\n\nResposta curta: Em Respostas Rápidas → Nova resposta: título, atalho (sem espaços), mensagem com variáveis em {} e visibilidade privada ou pública; mídia opcional. Na conversa, digite / com o campo vazio, ou use ☰ → Respostas rápidas. Resposta com arquivo é enviada na hora. Na Galeria de mídias, envie arquivos (imagem até 5 MB; vídeo e documento até 16 MB) e use ☰ → Usar da galeria na conversa. Só dono e admins publicam diretamente e excluem da galeria.\n\nEscalar para um humano quando:\n- Falha repetida de upload com arquivo dentro do limite\n\nVeja também: «Atender uma conversa: assumir, transferir e encerrar» (`atender-conversa`); «Ferramentas da conversa: iniciar, anotar, agendar e usar a IA» (`ferramentas-da-conversa`); «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (`janela-24-horas`)\n" }, { "slug": "filtros-etiquetas-e-pastas", "categoria": "Conversas", "titulo": "Filtros, etiquetas e pastas das conversas", "resumo": "Mostre só as conversas que interessam com filtros salvos, marque contatos com etiquetas e separe atendimentos em pastas que toda a equipe vê.", "tags": [ "filtros", "filtro salvo", "etiquetas", "tags", "gerenciar tags", "pastas", "mover pra pasta", "organizar conversas", "não lidas", "sla", "limpar filtro" ], "publico": "Atendentes, donos e administradores.", "no_painel": [ "Conversas" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Meus filtros salvos aparecem para a equipe?", "resposta": "Não. Filtros salvos ficam na aba Salvos e só você vê." }, { "pergunta": "A etiqueta fica na conversa ou no contato?", "resposta": "No contato. Ela aparece em todas as conversas dele." }, { "pergunta": "Apagar uma pasta apaga as conversas?", "resposta": "Não. As conversas dela voltam para as abas." } ], "problemas": [ { "sintoma": "A lista parece incompleta ou vazia", "causa": "Filtro ligado (mesmo após recarregar) ou aba/pasta errada.", "solucao": "Clique em Limpar ao lado de Filtros e confira a aba." }, { "sintoma": "Uma conversa sumiu depois que movi para pasta", "causa": "É o esperado: ela só aparece dentro da pasta.", "solucao": "Clique no nome da pasta ou use a busca, que procura em todas." }, { "sintoma": "O item Mover pra pasta está apagado", "causa": "A conversa está resolvida.", "solucao": "Reabra antes de mover. Veja «Atender uma conversa: assumir, transferir e encerrar»." }, { "sintoma": "Aparece “Crie tags em Personalização” ou “Nenhuma tag cadastrada neste workspace.”", "causa": "Não há etiquetas, ou falta a permissão *Ver tags*.", "solucao": "Crie em Personalização → Tags ou peça a permissão." }, { "sintoma": "Aparece “Falha ao atualizar etiqueta”", "causa": "Falta a permissão *Editar contatos*.", "solucao": "Peça a quem administra a equipe." }, { "sintoma": "Aparece “Já existe pasta com esse nome.”", "causa": "Nomes de pasta são únicos no workspace.", "solucao": "Use outro nome ou a pasta existente." } ], "para_ia": { "perguntas": [ "Como filtro só as conversas não lidas?", "Como aplico uma etiqueta no contato?", "Como crio uma pasta de conversas?", "Minha lista de conversas está vazia", "A conversa sumiu da aba" ], "resposta": "Filtros: Conversas → Filtros → aba Avançado (canal, responsável, departamento, leitura/SLA, período, tags, campos) → Aplicar; Salvar como… guarda na aba Salvos (só você vê); Limpar desliga, e o filtro persiste ao recarregar. Etiquetas: criadas em Personalização → Tags; aplicadas em Gerenciar tags no topo da conversa; marcam o contato e podem disparar automações de tag. Pastas: Gerenciar pastas abaixo das abas; Mais ações → Mover pra pasta; conversa em pasta sai das abas; resolvida não vai para pasta.", "escalar": [ "Permissões de etiqueta que precisam ser alteradas" ] }, "relacionados": [ "atender-conversa", "contatos", "automacao-basica" ], "markdown": "---\nslug: filtros-etiquetas-e-pastas\ncategoria: Conversas\natualizado: 17/10/2026\ntags: filtros, filtro salvo, etiquetas, tags, gerenciar tags, pastas, mover pra pasta, organizar conversas, não lidas, sla, limpar filtro\nno_painel: Conversas\nverificacao: baseado no guia oficial do painel\n---\n\n# Filtros, etiquetas e pastas das conversas\n\nMostre só as conversas que interessam com filtros salvos, marque contatos com etiquetas e separe atendimentos em pastas que toda a equipe vê.\n\n**Para quem é:** Atendentes, donos e administradores.\n\n**Antes de começar:**\n- Acesso ao menu `Conversas`\n- Para etiquetas: permissões *Ver contatos*, *Editar contatos* e *Ver tags*\n\nTrês recursos deixam a lista de Conversas mais fácil de acompanhar: **filtros** escondem o que não interessa agora, **etiquetas** marcam os contatos e **pastas** separam atendimentos em grupos que toda a equipe vê.\n\n| Recurso | Marca o quê | Quem vê |\n|---|---|---|\n| Filtro | Só muda a sua visão da lista | Só você (filtros salvos ficam na aba Salvos) |\n| Etiqueta | O **contato**, em todas as conversas dele | Toda a equipe |\n| Pasta | A **conversa**, que sai das abas | Toda a equipe |\n\n## Filtros\n\n1. Em `Conversas`, clique em **Filtros**, acima da lista.\n2. Na aba **Avançado**, combine *Canal / conexão*, *Responsável*, *Departamentos*, *Leitura / SLA*, *Período de atividade*, *Tags* e *Campos personalizados*.\n3. Clique em **Aplicar**. Para reusar, clique em **Salvar como…**, dê um nome e salve: ele fica na aba **Salvos**.\n4. Para desligar, clique em **Limpar**, ao lado do botão de filtros.\n\n> **Atenção:** O filtro **continua ligado depois de recarregar a página**, neste navegador. Se a lista parecer incompleta, comece clicando em **Limpar**.\n\n## Etiquetas\n\n1. Crie as etiquetas em `Personalização` → aba **Tags** → **Nova tag**.\n2. Na conversa, clique em **Gerenciar tags** (ícone de etiquetas no topo). Com **Aplicar** selecionado, clique na etiqueta. Para várias, marque *Selecionar várias tags* e use **Aplicar selecionadas**.\n3. Para tirar, clique em **Remover** e na etiqueta.\n\n> **Atenção:** Aplicar ou tirar uma etiqueta vale na hora e pode **disparar automações** com o gatilho *Tag aplicada* ou *Tag removida*. Veja «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (artigo `automacao-basica`).\n\n## Pastas\n\n1. Abaixo das abas, clique em **Gerenciar pastas** (pasta com +). Em **Nova pasta**, dê nome e cor e clique em **Criar**.\n2. Para mover uma conversa: **Mais ações** (⋮) → **Mover pra pasta**. Para várias, marque as caixas à esquerda e use **Mover** na barra de baixo.\n3. Para ver o conteúdo, clique no nome da pasta abaixo das abas. Clique de novo para voltar.\n\n> **Bom saber:** Conversa numa pasta **sai das abas** e aparece só dentro dela. Resolver ou usar *Mover para Novos* tira a conversa da pasta. Conversa resolvida não pode ir para pasta.\n\n## Não funcionou?\n\n- **Sintoma:** A lista parece incompleta ou vazia\n - Causa provável: Filtro ligado (mesmo após recarregar) ou aba/pasta errada.\n - O que fazer: Clique em **Limpar** ao lado de Filtros e confira a aba.\n- **Sintoma:** Uma conversa sumiu depois que movi para pasta\n - Causa provável: É o esperado: ela só aparece dentro da pasta.\n - O que fazer: Clique no nome da pasta ou use a busca, que procura em todas.\n- **Sintoma:** O item Mover pra pasta está apagado\n - Causa provável: A conversa está resolvida.\n - O que fazer: Reabra antes de mover. Veja «Atender uma conversa: assumir, transferir e encerrar» (artigo `atender-conversa`).\n- **Sintoma:** Aparece “Crie tags em Personalização” ou “Nenhuma tag cadastrada neste workspace.”\n - Causa provável: Não há etiquetas, ou falta a permissão *Ver tags*.\n - O que fazer: Crie em Personalização → Tags ou peça a permissão.\n- **Sintoma:** Aparece “Falha ao atualizar etiqueta”\n - Causa provável: Falta a permissão *Editar contatos*.\n - O que fazer: Peça a quem administra a equipe.\n- **Sintoma:** Aparece “Já existe pasta com esse nome.”\n - Causa provável: Nomes de pasta são únicos no workspace.\n - O que fazer: Use outro nome ou a pasta existente.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Meus filtros salvos aparecem para a equipe?**\nNão. Filtros salvos ficam na aba Salvos e só você vê.\n\n**A etiqueta fica na conversa ou no contato?**\nNo contato. Ela aparece em todas as conversas dele.\n\n**Apagar uma pasta apaga as conversas?**\nNão. As conversas dela voltam para as abas.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como filtro só as conversas não lidas?\n- Como aplico uma etiqueta no contato?\n- Como crio uma pasta de conversas?\n- Minha lista de conversas está vazia\n- A conversa sumiu da aba\n\nResposta curta: Filtros: Conversas → Filtros → aba Avançado (canal, responsável, departamento, leitura/SLA, período, tags, campos) → Aplicar; Salvar como… guarda na aba Salvos (só você vê); Limpar desliga, e o filtro persiste ao recarregar. Etiquetas: criadas em Personalização → Tags; aplicadas em Gerenciar tags no topo da conversa; marcam o contato e podem disparar automações de tag. Pastas: Gerenciar pastas abaixo das abas; Mais ações → Mover pra pasta; conversa em pasta sai das abas; resolvida não vai para pasta.\n\nEscalar para um humano quando:\n- Permissões de etiqueta que precisam ser alteradas\n\nVeja também: «Atender uma conversa: assumir, transferir e encerrar» (`atender-conversa`); «Importar, cadastrar e organizar contatos» (`contatos`); «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (`automacao-basica`)\n" }, { "slug": "ferramentas-da-conversa", "categoria": "Conversas", "titulo": "Ferramentas da conversa: iniciar, anotar, agendar e usar a IA", "resumo": "Comece conversas, deixe notas e chame colegas, agende mensagens, peça ajuda à IA para escrever ou resumir, desligue a IA de um contato e baixe o histórico.", "tags": [ "novo contato", "iniciar conversa", "nota", "anotação", "mencionar colega", "@", "agendar mensagem", "follow up", "assistente de ia", "resumir conversa", "traduzir", "desativar ia", "ativar a ia", "buscar mensagens", "apagar mensagem", "editar mensagem", "reagir", "baixar histórico" ], "publico": "Atendentes, donos e administradores.", "no_painel": [ "Conversas" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Qual a diferença entre agendar mensagem e follow-up?", "resposta": "A mensagem agendada sai na hora marcada, mesmo que o cliente responda. O follow-up é uma sequência de até 5 mensagens que para sozinha quando o contato responde." }, { "pergunta": "A IA envia a resposta sugerida sozinha?", "resposta": "Não. Ela coloca o texto no campo; você revisa e envia." }, { "pergunta": "Como faço a IA nunca mais responder um contato?", "resposta": "Em Informações do contato, seção Inteligência Artificial, desligue o interruptor e confirme Desativar IA." } ], "problemas": [ { "sintoma": "Aparece “Nenhum canal conectado. Conecte um canal pra iniciar a conversa.”", "causa": "Só WhatsApp (QR ou API Oficial) e SMS iniciam conversa, e precisam estar conectados.", "solucao": "Confira em Conexões." }, { "sintoma": "Aparece “Este contato já está em atendimento com outro agente.”", "causa": "Já existe conversa aberta com o contato, com um colega ou em Novos.", "solucao": "Peça ao colega para transferir para você." }, { "sintoma": "Digitei @ e a lista de colegas não abriu", "causa": "A menção só funciona na nota do botão amarelo.", "solucao": "Use o botão amarelo. Se sumiu: ⋮ → Mostrar nota flutuante." }, { "sintoma": "Apareceu “Erro ao apagar” ou “Erro ao reagir”", "causa": "O canal não aceita a ação ou a conexão caiu.", "solucao": "Apagar e editar só no WhatsApp por QR Code; espere a mensagem terminar de sair." }, { "sintoma": "O assistente pede para configurar um provedor de IA", "causa": "Não há integração de IA que ele possa usar.", "solucao": "Conecte um provedor em Integrações. Veja «Conectar um provedor de IA e outras integrações»." }, { "sintoma": "Limite de 3 downloads de histórico por dia", "causa": "O limite é por pessoa.", "solucao": "Renova à meia-noite, no fuso do workspace." } ], "para_ia": { "perguntas": [ "Como começo uma conversa com um cliente novo?", "Como deixo uma nota para a equipe?", "Como agendo uma mensagem?", "Como desligo a IA para um contato?", "Como baixo o histórico da conversa?", "Posso apagar uma mensagem enviada?" ], "resposta": "Novo contato (topo da lista) inicia conversa por WhatsApp ou SMS; na API Oficial a primeira mensagem é template. Nota: botão amarelo no canto inferior direito, é do contato, @ menciona colegas. Agendar: ☰ → Agendar mensagem; follow-up: ⋮ → Criar follow up (até 5 mensagens, para quando o cliente responde). Assistente de IA (☰) melhora, corrige, traduz, sugere resposta e resume; você revisa e envia. Pausar IA vale para a conversa; desativar para o contato fica em Informações do contato. Apagar/editar só no WhatsApp por QR Code. Baixar histórico: até 3 por dia por pessoa.", "escalar": [ "Mensagem agendada que não saiu no horário" ] }, "relacionados": [ "atender-conversa", "respostas-rapidas-e-galeria", "janela-24-horas", "contatos" ], "markdown": "---\nslug: ferramentas-da-conversa\ncategoria: Conversas\natualizado: 17/10/2026\ntags: novo contato, iniciar conversa, nota, anotação, mencionar colega, @, agendar mensagem, follow up, assistente de ia, resumir conversa, traduzir, desativar ia, ativar a ia, buscar mensagens, apagar mensagem, editar mensagem, reagir, baixar histórico\nno_painel: Conversas\nverificacao: baseado no guia oficial do painel\n---\n\n# Ferramentas da conversa: iniciar, anotar, agendar e usar a IA\n\nComece conversas, deixe notas e chame colegas, agende mensagens, peça ajuda à IA para escrever ou resumir, desligue a IA de um contato e baixe o histórico.\n\n**Para quem é:** Atendentes, donos e administradores.\n\n**Antes de começar:**\n- Acesso ao menu `Conversas`\n- Para o assistente de IA: uma integração de IA ativa (veja «Conectar um provedor de IA e outras integrações» (artigo `integracoes-e-provedores-de-ia`))\n\nAlém de assumir, responder e encerrar (veja «Atender uma conversa: assumir, transferir e encerrar» (artigo `atender-conversa`)), a tela de Conversas ajuda a começar conversas, deixar recados, programar mensagens, escrever com a IA e guardar uma cópia do atendimento.\n\n## Começar uma conversa\n\n1. Em `Conversas`, clique em **Novo contato** (pessoa com +, no topo da lista).\n2. Preencha **Nome** e pelo menos um número em **WhatsApp** ou **Telefone**, com DDI e DDD (ex.: +5511999999999). Se houver mais de uma conexão, escolha o **Canal**.\n3. Clique em **Criar e abrir conversa**. Se o número já existe, o painel abre a conversa dele.\n\n> **Atenção:** Na API Oficial do WhatsApp, a primeira mensagem precisa ser um **template aprovado**. Veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (artigo `janela-24-horas`). Só conexões de WhatsApp e SMS iniciam conversas.\n\n## Anotar e chamar um colega\n\n- Clique no **botão amarelo de nota**, no canto inferior direito, escreva em *Adicionar anotação…* e clique fora para salvar. A nota é do **contato** e toda a equipe vê.\n- Para chamar alguém, digite `@` e o nome: a pessoa recebe um aviso do navegador, se ativou as notificações.\n\n> **Atenção:** No WhatsApp por QR Code, salvar a nota no painel **substitui** as notas do contato no WhatsApp Business do celular. Copie antes para o painel o que a equipe anotou no celular.\n\n## Agendar mensagens e follow-ups\n\n- **Agendar mensagem:** **☰** (Ações da mensagem) → **Agendar mensagem** → conteúdo, data e hora → **Agendar envio**. Ela aparece com borda tracejada, com **Editar** e **Cancelar agendamento**.\n- **Follow-up:** **Mais ações** (⋮) → **Criar follow up**. Sequência de até 5 mensagens que **para sozinha quando o contato responde**.\n\n## Escrever e resumir com a IA\n\n| Onde | Opção | O que faz |\n|---|---|---|\n| ☰ → Assistente de IA | Melhorar rascunho | Reescreve em tom *Formal*, *Profissional* ou *Amigável*, ou só **Corrigir**. |\n| ☰ → Assistente de IA | Traduzir | Traduz o rascunho para o idioma escolhido. |\n| ☰ → Assistente de IA | Sugerir resposta / Resumir conversa | Escreve a próxima resposta com base nas últimas 30 mensagens, ou resume. |\n| ⋮ → Resumir conversa com IA | Gerar resumo | Resume o atendimento atual e pode **salvar num campo do contato** (até 4.000 caracteres). |\n\nVocê sempre revisa: **Aplicar** põe o texto no campo, e quem envia é você. O assistente usa o modelo do agente principal do canal e entra no consumo da integração de IA.\n\n## Ligar e desligar a IA para um contato\n\n- **Pausar IA** (no topo): vale só para esta conversa.\n- **Desativar para o contato:** ⋮ → **Informações do contato** → seção *Inteligência Artificial* → desligue e confirme **Desativar IA**. Vale em todas as conversas dele.\n- **Ativar a IA com uma orientação:** ⋮ → **Ativar a IA**, escolha o agente e escreva a instrução (ex.: *Ofereça o horário das 15h*). A conversa vai para **Novos** e a IA assume.\n\n## Buscar, editar, apagar e baixar o histórico\n\n- **Buscar:** lupa no topo, pelo menos 2 letras.\n- **Reagir:** WhatsApp por QR Code e API Oficial. **Editar** (até 15 minutos) e **Apagar**: só mensagens enviadas pelo seu número no WhatsApp por QR Code.\n- **Baixar histórico:** ⋮ → Informações do contato → **Baixar histórico**. Arquivo .txt com até 20 mil mensagens; até 3 downloads por pessoa por dia.\n\n## Não funcionou?\n\n- **Sintoma:** Aparece “Nenhum canal conectado. Conecte um canal pra iniciar a conversa.”\n - Causa provável: Só WhatsApp (QR ou API Oficial) e SMS iniciam conversa, e precisam estar conectados.\n - O que fazer: Confira em `Conexões`.\n- **Sintoma:** Aparece “Este contato já está em atendimento com outro agente.”\n - Causa provável: Já existe conversa aberta com o contato, com um colega ou em Novos.\n - O que fazer: Peça ao colega para transferir para você.\n- **Sintoma:** Digitei @ e a lista de colegas não abriu\n - Causa provável: A menção só funciona na nota do botão amarelo.\n - O que fazer: Use o botão amarelo. Se sumiu: ⋮ → **Mostrar nota flutuante**.\n- **Sintoma:** Apareceu “Erro ao apagar” ou “Erro ao reagir”\n - Causa provável: O canal não aceita a ação ou a conexão caiu.\n - O que fazer: Apagar e editar só no WhatsApp por QR Code; espere a mensagem terminar de sair.\n- **Sintoma:** O assistente pede para configurar um provedor de IA\n - Causa provável: Não há integração de IA que ele possa usar.\n - O que fazer: Conecte um provedor em `Integrações`. Veja «Conectar um provedor de IA e outras integrações» (artigo `integracoes-e-provedores-de-ia`).\n- **Sintoma:** Limite de 3 downloads de histórico por dia\n - Causa provável: O limite é por pessoa.\n - O que fazer: Renova à meia-noite, no fuso do workspace.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Qual a diferença entre agendar mensagem e follow-up?**\nA mensagem agendada sai na hora marcada, mesmo que o cliente responda. O follow-up é uma sequência de até 5 mensagens que para sozinha quando o contato responde.\n\n**A IA envia a resposta sugerida sozinha?**\nNão. Ela coloca o texto no campo; você revisa e envia.\n\n**Como faço a IA nunca mais responder um contato?**\nEm Informações do contato, seção Inteligência Artificial, desligue o interruptor e confirme Desativar IA.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como começo uma conversa com um cliente novo?\n- Como deixo uma nota para a equipe?\n- Como agendo uma mensagem?\n- Como desligo a IA para um contato?\n- Como baixo o histórico da conversa?\n- Posso apagar uma mensagem enviada?\n\nResposta curta: Novo contato (topo da lista) inicia conversa por WhatsApp ou SMS; na API Oficial a primeira mensagem é template. Nota: botão amarelo no canto inferior direito, é do contato, @ menciona colegas. Agendar: ☰ → Agendar mensagem; follow-up: ⋮ → Criar follow up (até 5 mensagens, para quando o cliente responde). Assistente de IA (☰) melhora, corrige, traduz, sugere resposta e resume; você revisa e envia. Pausar IA vale para a conversa; desativar para o contato fica em Informações do contato. Apagar/editar só no WhatsApp por QR Code. Baixar histórico: até 3 por dia por pessoa.\n\nEscalar para um humano quando:\n- Mensagem agendada que não saiu no horário\n\nVeja também: «Atender uma conversa: assumir, transferir e encerrar» (`atender-conversa`); «Usar respostas rápidas e a galeria de mídias» (`respostas-rapidas-e-galeria`); «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (`janela-24-horas`); «Importar, cadastrar e organizar contatos» (`contatos`)\n" }, { "slug": "templates-whatsapp", "categoria": "Canais e conexões", "titulo": "Criar e aprovar templates do WhatsApp oficial", "resumo": "Crie modelos de mensagem numa conexão da API Oficial ou Coexistência, envie para aprovação da Meta e entenda cada status.", "tags": [ "template", "modelo de mensagem", "aprovação", "meta", "pendente", "aprovado", "rejeitado", "pausado", "variáveis", "categoria", "marketing", "utilitário", "carrossel", "botões", "api oficial", "coexistência" ], "publico": "Donos e administradores que usam a API Oficial do WhatsApp.", "no_painel": [ "Conexões", "WhatsApp Business", "Templates" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Posso editar um template aprovado?", "resposta": "Não. Crie um novo template com outro nome interno." }, { "pergunta": "Apagar um template apaga na Meta também?", "resposta": "Sim, e não pode ser desfeito." }, { "pergunta": "Quanto tempo a Meta leva para aprovar?", "resposta": "Varia. O painel não controla esse prazo; use Atualizar para conferir." } ], "problemas": [ { "sintoma": "Não encontro o botão Templates", "causa": "Ele só existe em números da API Oficial ou Coexistência.", "solucao": "Conexão por QR Code não usa template. Veja «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code»." }, { "sintoma": "Mensagem em vermelho ao enviar para aprovação", "causa": "Nome repetido, exemplos de variável vazios, variáveis fora de sequência ({{1}}, {{2}}…) ou categoria que não combina.", "solucao": "Corrija o que a mensagem indica e envie de novo." }, { "sintoma": "O template foi rejeitado", "causa": "O painel mostra o status, mas não o motivo; o motivo fica no WhatsApp Manager da Meta.", "solucao": "Revise categoria, exemplos e políticas e crie um novo template, com outro nome interno. O painel não edita template já enviado." }, { "sintoma": "O template continua Pendente", "causa": "A análise é feita pela Meta e o tempo varia.", "solucao": "Clique em Atualizar de tempos em tempos." }, { "sintoma": "Aprovado, mas não consigo usar", "causa": "Conexão diferente da que criou o template, ou template criado fora do painel com recursos não suportados.", "solucao": "Escolha a conexão certa ou outro template." } ], "para_ia": { "perguntas": [ "Como crio um template?", "Meu template foi rejeitado, e agora?", "Por que não acho o botão de templates?", "Quanto tempo demora a aprovação?", "Posso editar um template?" ], "resposta": "Em Conexões → WhatsApp Business → Conectar via API (ou Coexistência) → Templates do número → Novo template: nome interno (minúsculas, números e _), categoria Marketing ou Utilitário, tipo Padrão ou Carrossel, idioma, corpo até 1024 caracteres com variáveis {{1}} e exemplos reais. Enviar pra aprovação e clicar em Atualizar para ver o status (Pendente, Aprovado, Rejeitado, Pausado/Desabilitado, Em apelação). Só aprovados aparecem para envio. QR Code não tem templates. Rejeitado: o motivo fica no WhatsApp Manager; crie outro com novo nome. Prazo de aprovação é da Meta.", "escalar": [ "Template aprovado que não envia", "Dúvida sobre motivo de rejeição que o cliente não consegue ver na Meta" ] }, "relacionados": [ "janela-24-horas", "disparo-em-massa", "conectar-whatsapp" ], "markdown": "---\nslug: templates-whatsapp\ncategoria: Canais e conexões\natualizado: 17/10/2026\ntags: template, modelo de mensagem, aprovação, meta, pendente, aprovado, rejeitado, pausado, variáveis, categoria, marketing, utilitário, carrossel, botões, api oficial, coexistência\nno_painel: Conexões > WhatsApp Business > Templates\nverificacao: baseado no guia oficial do painel\n---\n\n# Criar e aprovar templates do WhatsApp oficial\n\nCrie modelos de mensagem numa conexão da API Oficial ou Coexistência, envie para aprovação da Meta e entenda cada status.\n\n**Para quem é:** Donos e administradores que usam a API Oficial do WhatsApp.\n\n**Antes de começar:**\n- Número conectado pela API Oficial Meta ou por Coexistência (veja «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (artigo `conectar-whatsapp`))\n- Acesso ao menu `Conexões`\n\nTemplates são mensagens prontas que a **Meta analisa antes de liberar**. Com eles você retoma conversas fora da janela de 24 horas e faz campanhas pelo Disparo em Massa. Conexões por **QR Code não usam templates**.\n\n[Esquema: Do envio para aprovação até o uso.]\n\n## Passo a passo\n\n1. Em `Conexões` → **WhatsApp Business**, clique em **Conectar via API** (ou **Conectar via Coexistência**, se o número usa COEX). Abre a lista dos seus números.\n2. Na linha do número, clique em **Templates** e depois em **Novo template**.\n3. **Nome interno:** só minúsculas, números e `_` (ex.: `pedido_confirmado`). O cliente não vê e não dá para mudar depois.\n4. **Categoria:** *Marketing* (promoções, novidades) ou *Utilitário* (notificações, lembretes, status). **Tipo:** *Padrão* (cabeçalho, corpo, rodapé, botões) ou *Carrossel* (2 a 10 cards, sempre Marketing). **Idioma:** o da mensagem.\n5. **Corpo:** até 1024 caracteres. Para partes que mudam, clique em **Variável** ({{1}}, {{2}}…) e preencha um **exemplo real** para cada uma.\n6. Opcional: **Cabeçalho** (texto, imagem, vídeo, documento ou localização), **Rodapé** e até 10 **Botões**.\n7. Confira o **Preview** e clique em **Enviar pra aprovação**. A tela não se atualiza sozinha: clique em **Atualizar** para ver o status.\n\n| Status | Significado |\n|---|---|\n| Pendente | A Meta ainda está analisando. |\n| Aprovado | Pronto para usar em conversas, automações e disparos. |\n| Rejeitado | A Meta recusou. |\n| Pausado / Desabilitado | A Meta suspendeu o uso. |\n| Em apelação | Pedido de revisão em análise na Meta. |\n\n> **Dica:** Enquanto você preenche, o painel guarda um **rascunho neste navegador**. Ao voltar, aparece *Rascunho recuperado.*\n\n## Não funcionou?\n\n- **Sintoma:** Não encontro o botão Templates\n - Causa provável: Ele só existe em números da API Oficial ou Coexistência.\n - O que fazer: Conexão por QR Code não usa template. Veja «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (artigo `conectar-whatsapp`).\n- **Sintoma:** Mensagem em vermelho ao enviar para aprovação\n - Causa provável: Nome repetido, exemplos de variável vazios, variáveis fora de sequência ({{1}}, {{2}}…) ou categoria que não combina.\n - O que fazer: Corrija o que a mensagem indica e envie de novo.\n- **Sintoma:** O template foi rejeitado\n - Causa provável: O painel mostra o status, mas não o motivo; o motivo fica no WhatsApp Manager da Meta.\n - O que fazer: Revise categoria, exemplos e políticas e crie um **novo** template, com outro nome interno. O painel não edita template já enviado.\n- **Sintoma:** O template continua Pendente\n - Causa provável: A análise é feita pela Meta e o tempo varia.\n - O que fazer: Clique em **Atualizar** de tempos em tempos.\n- **Sintoma:** Aprovado, mas não consigo usar\n - Causa provável: Conexão diferente da que criou o template, ou template criado fora do painel com recursos não suportados.\n - O que fazer: Escolha a conexão certa ou outro template.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Posso editar um template aprovado?**\nNão. Crie um novo template com outro nome interno.\n\n**Apagar um template apaga na Meta também?**\nSim, e não pode ser desfeito.\n\n**Quanto tempo a Meta leva para aprovar?**\nVaria. O painel não controla esse prazo; use Atualizar para conferir.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como crio um template?\n- Meu template foi rejeitado, e agora?\n- Por que não acho o botão de templates?\n- Quanto tempo demora a aprovação?\n- Posso editar um template?\n\nResposta curta: Em Conexões → WhatsApp Business → Conectar via API (ou Coexistência) → Templates do número → Novo template: nome interno (minúsculas, números e _), categoria Marketing ou Utilitário, tipo Padrão ou Carrossel, idioma, corpo até 1024 caracteres com variáveis {{1}} e exemplos reais. Enviar pra aprovação e clicar em Atualizar para ver o status (Pendente, Aprovado, Rejeitado, Pausado/Desabilitado, Em apelação). Só aprovados aparecem para envio. QR Code não tem templates. Rejeitado: o motivo fica no WhatsApp Manager; crie outro com novo nome. Prazo de aprovação é da Meta.\n\nEscalar para um humano quando:\n- Template aprovado que não envia\n- Dúvida sobre motivo de rejeição que o cliente não consegue ver na Meta\n\nVeja também: «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (`janela-24-horas`); «Criar um disparo em massa e acompanhar o envio» (`disparo-em-massa`); «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (`conectar-whatsapp`)\n" }, { "slug": "instagram-e-messenger", "categoria": "Canais e conexões", "titulo": "Conectar o Instagram e o Messenger do Facebook", "resumo": "Conecte uma conta profissional do Instagram e uma Página do Facebook para responder Direct e Messenger em Conversas, e entenda a janela de 24 horas desses canais.", "tags": [ "instagram", "direct", "messenger", "facebook", "página", "conta profissional", "conectar instagram", "stories", "janela 24 horas instagram", "token expirou", "popup bloqueado", "fora do plano" ], "publico": "Donos e administradores.", "no_painel": [ "Conexões", "Instagram / Facebook Messenger" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Os comentários dos posts chegam em Conversas?", "resposta": "Não. Para responder comentários e stories automaticamente, use Automações → Comentários Instagram ou Histórias Instagram." }, { "pergunta": "Posso mandar mensagem para um seguidor que não me escreveu?", "resposta": "Não. Instagram e Messenger só respondem a quem escreveu, dentro de 24 horas." }, { "pergunta": "Uma conta do Instagram pode estar em dois workspaces?", "resposta": "Não. Cada conta só pode estar conectada em um workspace." } ], "problemas": [ { "sintoma": "O cartão mostra “fora do plano” ou “não incluído no seu plano”", "causa": "O canal não está no plano e o addon não foi liberado no workspace.", "solucao": "Dono da conta: Agência → Configurar → *Limites e addons* → liberar o addon. Senão, fale com sua agência." }, { "sintoma": "Nova conexão desativada com “limite atingido”", "causa": "O workspace já usa todas as conexões liberadas desse canal.", "solucao": "O dono libera mais uma, do mesmo jeito." }, { "sintoma": "Apareceu “Popup bloqueado pelo navegador”", "causa": "O navegador impediu a janela de login.", "solucao": "Permita pop-ups para o painel e clique em Nova conexão de novo." }, { "sintoma": "O Messenger mostrou erro 400", "causa": "Nenhuma Página dá à sua conta permissão para mensagens, ou a autorização demorou.", "solucao": "Confira seu acesso à Página no Facebook e conecte de novo, sem demora." }, { "sintoma": "O Instagram não conectou", "causa": "Conta não profissional, permissão recusada, falta *Gerenciar Instagram* ou conta já conectada em outro workspace.", "solucao": "Mude para conta profissional, aceite todas as permissões ou peça o acesso. Uma conta só pode estar em um workspace." }, { "sintoma": "Conexão com Erro ou “Token do Instagram expirou ou foi revogado”", "causa": "Acesso expirou ou foi cancelado (ex.: troca de senha).", "solucao": "Clique em Atualizar status. No Instagram, se continuar, apague e conecte de novo; depois marque a conexão nova no agente de IA." } ], "para_ia": { "perguntas": [ "Como conecto meu Instagram?", "Como conecto o Messenger?", "Por que não consigo responder no Instagram?", "Os comentários aparecem no painel?", "O token do Instagram expirou" ], "resposta": "Em Conexões, cartão Instagram ou Facebook Messenger → Nova conexão → login e autorização (Instagram precisa ser conta profissional; Messenger precisa de uma Página). Mensagens do Direct e do Messenger chegam em Conversas; comentários não (use as automações de Instagram). Responda sempre pelo painel. Janela de 24h: só dá para responder até 24h após a última mensagem do cliente e não há template para retomar. Erro ou token expirado: Atualizar status; no Instagram, se continuar, apague, conecte de novo e marque a conexão nova no agente.", "escalar": [ "Erro persistente de autorização com a Meta", "Pedido para liberar addon ou aumentar limite" ] }, "relacionados": [ "janela-24-horas", "criar-agente", "escolher-automacao" ], "markdown": "---\nslug: instagram-e-messenger\ncategoria: Canais e conexões\natualizado: 17/10/2026\ntags: instagram, direct, messenger, facebook, página, conta profissional, conectar instagram, stories, janela 24 horas instagram, token expirou, popup bloqueado, fora do plano\nno_painel: Conexões > Instagram / Facebook Messenger\nverificacao: baseado no guia oficial do painel\n---\n\n# Conectar o Instagram e o Messenger do Facebook\n\nConecte uma conta profissional do Instagram e uma Página do Facebook para responder Direct e Messenger em Conversas, e entenda a janela de 24 horas desses canais.\n\n**Para quem é:** Donos e administradores.\n\n**Antes de começar:**\n- Acesso ao menu `Conexões` (e a permissão *Gerenciar Instagram*, para o Instagram)\n- Instagram: conta profissional (empresa ou criador)\n- Messenger: Página do Facebook e login que gerencie as mensagens dela\n\nConectando o Instagram ou uma Página do Facebook, as mensagens do **Direct** e do **Messenger** chegam em `Conversas`. Do Instagram, chegam também respostas e menções aos seus stories. **Comentários nos posts não viram conversa**: para eles, use as automações de Instagram (veja «Automações: qual usar em cada situação» (artigo `escolher-automacao`)).\n\n> **Atenção:** Responda sempre pelo painel. O que você responde direto no app do Instagram ou pelo Facebook **não aparece aqui**.\n\n## Conectar o Instagram\n\n1. Em `Conexões`, clique no cartão **Instagram** e em **Nova conexão**.\n2. Entre com a conta que quer conectar e permita o acesso às mensagens e comentários.\n3. De volta ao painel, a conta aparece como **Conectado**, com o @ e os seguidores.\n\n## Conectar o Messenger\n\n1. Em `Conexões`, clique em **Facebook Messenger** e em **Nova conexão**. Abre uma janela do Facebook.\n2. Entre e autorize o acesso às suas Páginas. Se administra mais de uma, escolha qual em **Selecionar Página**.\n3. A Página aparece na lista como **Conectado**.\n\nDepois de conectar, marque o canal no agente de IA, se quiser que ele atenda. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\n## A janela de 24 horas no Instagram e no Messenger\n\nNesses canais você só manda mensagem livre até **24 horas depois da última mensagem do cliente**, e **não existe template** para retomar depois disso. No Instagram, uma linha acima do campo mostra quanto falta; depois do prazo o campo bloqueia. No Messenger, o painel avisa que a mensagem pode falhar.\n\n> **Bom saber:** Para retomar o contato depois, só esperando o cliente escrever de novo, ou usando outro canal (WhatsApp, e-mail, SMS).\n\n## Desconectar e reconectar\n\nNa linha da conta, **Desconectar** para de receber e enviar (as conversas ficam). Para reconectar, clique no ícone de setas (**Atualizar status**).\n\n## Não funcionou?\n\n- **Sintoma:** O cartão mostra “fora do plano” ou “não incluído no seu plano”\n - Causa provável: O canal não está no plano e o addon não foi liberado no workspace.\n - O que fazer: Dono da conta: `Agência` → Configurar → *Limites e addons* → liberar o addon. Senão, fale com sua agência.\n- **Sintoma:** Nova conexão desativada com “limite atingido”\n - Causa provável: O workspace já usa todas as conexões liberadas desse canal.\n - O que fazer: O dono libera mais uma, do mesmo jeito.\n- **Sintoma:** Apareceu “Popup bloqueado pelo navegador”\n - Causa provável: O navegador impediu a janela de login.\n - O que fazer: Permita pop-ups para o painel e clique em **Nova conexão** de novo.\n- **Sintoma:** O Messenger mostrou erro 400\n - Causa provável: Nenhuma Página dá à sua conta permissão para mensagens, ou a autorização demorou.\n - O que fazer: Confira seu acesso à Página no Facebook e conecte de novo, sem demora.\n- **Sintoma:** O Instagram não conectou\n - Causa provável: Conta não profissional, permissão recusada, falta *Gerenciar Instagram* ou conta já conectada em outro workspace.\n - O que fazer: Mude para conta profissional, aceite todas as permissões ou peça o acesso. Uma conta só pode estar em um workspace.\n- **Sintoma:** Conexão com Erro ou “Token do Instagram expirou ou foi revogado”\n - Causa provável: Acesso expirou ou foi cancelado (ex.: troca de senha).\n - O que fazer: Clique em **Atualizar status**. No Instagram, se continuar, apague e conecte de novo; depois **marque a conexão nova no agente de IA**.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Os comentários dos posts chegam em Conversas?**\nNão. Para responder comentários e stories automaticamente, use Automações → Comentários Instagram ou Histórias Instagram.\n\n**Posso mandar mensagem para um seguidor que não me escreveu?**\nNão. Instagram e Messenger só respondem a quem escreveu, dentro de 24 horas.\n\n**Uma conta do Instagram pode estar em dois workspaces?**\nNão. Cada conta só pode estar conectada em um workspace.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como conecto meu Instagram?\n- Como conecto o Messenger?\n- Por que não consigo responder no Instagram?\n- Os comentários aparecem no painel?\n- O token do Instagram expirou\n\nResposta curta: Em Conexões, cartão Instagram ou Facebook Messenger → Nova conexão → login e autorização (Instagram precisa ser conta profissional; Messenger precisa de uma Página). Mensagens do Direct e do Messenger chegam em Conversas; comentários não (use as automações de Instagram). Responda sempre pelo painel. Janela de 24h: só dá para responder até 24h após a última mensagem do cliente e não há template para retomar. Erro ou token expirado: Atualizar status; no Instagram, se continuar, apague, conecte de novo e marque a conexão nova no agente.\n\nEscalar para um humano quando:\n- Erro persistente de autorização com a Meta\n- Pedido para liberar addon ou aumentar limite\n\nVeja também: «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (`janela-24-horas`); «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Automações: qual usar em cada situação» (`escolher-automacao`)\n" }, { "slug": "chat-no-site", "categoria": "Canais e conexões", "titulo": "Colocar o chat no seu site (Webchat)", "resumo": "Crie o widget de chat, ajuste aparência e formulário, libere os domínios, cole o código no site e coloque um agente de IA para atender.", "tags": [ "webchat", "chat no site", "widget", "botão de conversa", "código", "domínios", "formulário de contato", "página de teste", "link de campanha", "regenerar key", "site" ], "publico": "Donos, administradores e quem cuida do site.", "no_painel": [ "Conexões", "Webchat" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "O chat do site consegue iniciar conversa depois?", "resposta": "Não. Se o visitante fechou a aba, use o WhatsApp ou e-mail coletado no formulário." }, { "pergunta": "Em que idioma aparecem os textos fixos?", "resposta": "No idioma do navegador do visitante (português, inglês ou espanhol). Para fixar, acrescente data-lang ao código." }, { "pergunta": "Cada visitante vira um contato?", "resposta": "Sim. Sem o formulário, vira um contato sem nome; com o formulário, se o WhatsApp ou e-mail bater com um contato existente, a conversa entra nele." } ], "problemas": [ { "sintoma": "O cartão Webchat mostra “fora do plano”", "causa": "O canal não está no plano e o addon não foi liberado.", "solucao": "Dono da conta: Agência → Configurar → *Limites e addons*. Senão, fale com sua agência." }, { "sintoma": "O chat não aparece no meu site", "causa": "Domínio diferente do cadastrado, código fora de alguma página ou key regenerada.", "solucao": "Use *.meusite.com para valer com e sem www, cole o código antes de em todas as páginas e confira se a key não foi trocada." }, { "sintoma": "Ao salvar, aparece “domínio permitido inválido”", "causa": "Domínio com https://, barras ou nome de página.", "solucao": "Escreva só o endereço, como meusite.com, um por linha." }, { "sintoma": "Não consigo pôr foto no topo do chat", "causa": "O avatar só entra depois de criar o widget.", "solucao": "Clique em Editar → Subir avatar (PNG, JPEG, WebP ou GIF, até 2 MB)." }, { "sintoma": "O visitante não recebeu a minha resposta", "causa": "Ele fechou a aba antes.", "solucao": "Retome por WhatsApp ou e-mail, se foram coletados no formulário." } ], "para_ia": { "perguntas": [ "Como coloco o chat no meu site?", "O chat não aparece no site", "Como ponho a IA para atender no site?", "O visitante não recebeu a resposta" ], "resposta": "Em Conexões → Webchat → Nova conexão: nome, aparência, formulário de contato (Nome, Email, WhatsApp), comportamento e Domínios (sem https://; use *.meusite.com para valer com e sem www). Criar widget → Copiar o código → colar antes de em todas as páginas. Abrir página de teste testa sem mexer no site. Para a IA atender: marque o widget no agente e ligue usar como agente principal. A conversa só chega ao visitante enquanto ele está com a aba aberta. Regenerar key tira do ar na hora.", "escalar": [ "Pedido para alguém instalar o código no site do cliente", "Chat não aparece mesmo com domínio e código corretos" ] }, "relacionados": [ "criar-agente", "janela-24-horas", "como-o-eloria-funciona" ], "markdown": "---\nslug: chat-no-site\ncategoria: Canais e conexões\natualizado: 17/10/2026\ntags: webchat, chat no site, widget, botão de conversa, código, domínios, formulário de contato, página de teste, link de campanha, regenerar key, site\nno_painel: Conexões > Webchat\nverificacao: baseado no guia oficial do painel\n---\n\n# Colocar o chat no seu site (Webchat)\n\nCrie o widget de chat, ajuste aparência e formulário, libere os domínios, cole o código no site e coloque um agente de IA para atender.\n\n**Para quem é:** Donos, administradores e quem cuida do site.\n\n**Antes de começar:**\n- Acesso ao menu `Conexões`\n- Acesso para colar um código nas páginas do site (ou alguém que faça isso)\n\nO chat do site é um botão de conversa no canto das páginas. O visitante escreve e a mensagem chega em `Conversas`, onde você ou um agente de IA responde. No painel, o canal se chama **Webchat** e cada chat criado é um **widget**.\n\n> **Atenção:** A conversa só continua **enquanto o visitante está com o site aberto, na mesma aba**. Se ele fechar antes da resposta, ela não chega. Por isso vale pedir WhatsApp ou e-mail no formulário.\n\n## Criar o widget\n\n1. Em `Conexões`, clique em **Webchat** e em **Nova conexão** (ou **Criar primeiro widget**).\n2. Dê um **Nome do widget** (só a equipe vê) e ajuste a **Aparência**: título, subtítulo, cor, mensagem de boas-vindas e posição.\n3. Para saber com quem fala, ligue **Coletar dados de contato antes de iniciar a conversa** e escolha Nome, Email e WhatsApp como *Não coletar*, *Opcional* ou *Obrigatório*.\n4. Em **Comportamento**, permita ou não emoji e anexos (até 16 MB).\n5. Em **Domínios**, escreva o endereço do site sem `https://`, um por linha. Para valer com e sem www, use `*.meusite.com`.\n6. Clique em **Criar widget**.\n\n## Instalar e testar\n\n1. No cartão do widget, clique em **Copiar**, ao lado do código, e cole em todas as páginas, logo antes de ``.\n2. Para testar sem mexer no site, clique em **Abrir página de teste** e mande uma mensagem. Ela chega em Conversas.\n3. Mudanças salvas depois aparecem ao recarregar o site, sem trocar o código.\n\n> **Dica:** Para anúncios, use **Copiar link de campanha**: abre o chat em tela cheia.\n\n## Colocar um agente de IA no chat\n\nAbra o agente em `Agentes IA`, marque o widget em *Canais onde o agente atua*, ligue *Usar como agente principal de atendimento nos canais selecionados* e salve. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\n## Tirar do ar ou remover\n\n- **Regenerar key:** o código atual para de funcionar na hora. Para voltar, troque pelo código novo.\n- **Excluir:** apaga o widget (não dá para desfazer). As conversas antigas ficam; o widget sai dos agentes e os fluxos que valiam só para ele passam a valer para todos os canais.\n\n## Não funcionou?\n\n- **Sintoma:** O cartão Webchat mostra “fora do plano”\n - Causa provável: O canal não está no plano e o addon não foi liberado.\n - O que fazer: Dono da conta: `Agência` → Configurar → *Limites e addons*. Senão, fale com sua agência.\n- **Sintoma:** O chat não aparece no meu site\n - Causa provável: Domínio diferente do cadastrado, código fora de alguma página ou key regenerada.\n - O que fazer: Use `*.meusite.com` para valer com e sem www, cole o código antes de `` em todas as páginas e confira se a key não foi trocada.\n- **Sintoma:** Ao salvar, aparece “domínio permitido inválido”\n - Causa provável: Domínio com `https://`, barras ou nome de página.\n - O que fazer: Escreva só o endereço, como `meusite.com`, um por linha.\n- **Sintoma:** Não consigo pôr foto no topo do chat\n - Causa provável: O avatar só entra depois de criar o widget.\n - O que fazer: Clique em **Editar** → **Subir avatar** (PNG, JPEG, WebP ou GIF, até 2 MB).\n- **Sintoma:** O visitante não recebeu a minha resposta\n - Causa provável: Ele fechou a aba antes.\n - O que fazer: Retome por WhatsApp ou e-mail, se foram coletados no formulário.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**O chat do site consegue iniciar conversa depois?**\nNão. Se o visitante fechou a aba, use o WhatsApp ou e-mail coletado no formulário.\n\n**Em que idioma aparecem os textos fixos?**\nNo idioma do navegador do visitante (português, inglês ou espanhol). Para fixar, acrescente data-lang ao código.\n\n**Cada visitante vira um contato?**\nSim. Sem o formulário, vira um contato sem nome; com o formulário, se o WhatsApp ou e-mail bater com um contato existente, a conversa entra nele.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como coloco o chat no meu site?\n- O chat não aparece no site\n- Como ponho a IA para atender no site?\n- O visitante não recebeu a resposta\n\nResposta curta: Em Conexões → Webchat → Nova conexão: nome, aparência, formulário de contato (Nome, Email, WhatsApp), comportamento e Domínios (sem https://; use *.meusite.com para valer com e sem www). Criar widget → Copiar o código → colar antes de em todas as páginas. Abrir página de teste testa sem mexer no site. Para a IA atender: marque o widget no agente e ligue usar como agente principal. A conversa só chega ao visitante enquanto ele está com a aba aberta. Regenerar key tira do ar na hora.\n\nEscalar para um humano quando:\n- Pedido para alguém instalar o código no site do cliente\n- Chat não aparece mesmo com domínio e código corretos\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (`janela-24-horas`); «Como o Elor.ia funciona: do canal à resposta da IA» (`como-o-eloria-funciona`)\n" }, { "slug": "contatos", "categoria": "Contatos e vendas", "titulo": "Importar, cadastrar e organizar contatos", "resumo": "Busque e filtre contatos, cadastre e edite, importe uma planilha CSV, crie campos personalizados, exporte e exclua.", "tags": [ "contatos", "cadastrar contato", "adicionar contato", "importar", "csv", "planilha", "exportar", "campos personalizados", "excluir contato", "duplicado", "mesclar", "limite de contatos", "pendente" ], "publico": "Atendentes, donos e administradores.", "no_painel": [ "Contatos" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Quem escreve no WhatsApp vira contato sozinho?", "resposta": "Sim. Quem escreve por um canal conectado entra na lista automaticamente." }, { "pergunta": "A importação apaga dados que estão vazios na planilha?", "resposta": "Não. Em Atualizar existentes, célula vazia não apaga nada." }, { "pergunta": "Dá para recuperar um contato excluído?", "resposta": "Não. A exclusão apaga o contato e tudo ligado a ele." } ], "problemas": [ { "sintoma": "Aparece “Já existe um contato com esse número”", "causa": "O número já está em outro contato (com ou sem 55 ou nono dígito).", "solucao": "Busque o contato existente e edite. Se puser num contato o número de outro, o painel junta os dois e avisa “Contato duplicado mesclado”." }, { "sintoma": "A importação não começa", "causa": "Arquivo não CSV, grande demais, outra importação em andamento ou nenhuma coluna de nome/WhatsApp/telefone/e-mail mapeada.", "solucao": "Salve como CSV, divida o arquivo, espere a outra terminar ou mapeie uma coluna de contato." }, { "sintoma": "Contatos pulados ou erros de linha", "causa": "Modo *Só criar novos* ignora existentes; linhas sem contato ou com número inválido dão erro.", "solucao": "Reimporte com *Atualizar existentes* e corrija as linhas indicadas." }, { "sintoma": "O campo personalizado não aparece na ficha", "causa": "A chave No chat está desligada, ou o campo é de Oportunidade.", "solucao": "Ligue No chat em Personalização → Campos personalizados." }, { "sintoma": "“Limite de contatos do plano atingido” ou contatos com selo Pendente", "causa": "O workspace chegou ao limite do plano; novos contatos ficam pendentes, sem mensagens nem automações.", "solucao": "Exclua contatos sem uso ou fale com sua agência sobre o plano." } ], "para_ia": { "perguntas": [ "Como cadastro um contato?", "Como importo minha lista de clientes?", "Como crio um campo personalizado?", "Meu campo não aparece na conversa", "Excluir contato apaga as conversas?", "Contato aparece como Pendente" ], "resposta": "Em Contatos: busca e Filtros (tags, canais, campos). Adicionar Contato exige Nome e WhatsApp com DDI. Importar: ⋯ → Importar, CSV até 50.000 linhas e 5 MB, conferir Destino das colunas, escolher modo (Só criar novos ou Atualizar existentes) e como identificar duplicados. Campos personalizados: Personalização → Campos personalizados → Contato → Novo campo, e ligar a chave No chat para aparecer. Exportar: ⋯ → Exportar. Excluir apaga conversas, oportunidades e agendamentos, sem desfazer. Limite do plano deixa novos contatos como Pendente.", "escalar": [ "Limite de contatos do plano", "Contatos excluídos por engano" ] }, "relacionados": [ "importar-exportar-contatos", "filtros-etiquetas-e-pastas", "pipeline" ], "markdown": "---\nslug: contatos\ncategoria: Contatos e vendas\natualizado: 17/10/2026\ntags: contatos, cadastrar contato, adicionar contato, importar, csv, planilha, exportar, campos personalizados, excluir contato, duplicado, mesclar, limite de contatos, pendente\nno_painel: Contatos\nverificacao: baseado no guia oficial do painel\n---\n\n# Importar, cadastrar e organizar contatos\n\nBusque e filtre contatos, cadastre e edite, importe uma planilha CSV, crie campos personalizados, exporte e exclua.\n\n**Para quem é:** Atendentes, donos e administradores.\n\n**Antes de começar:**\n- Acesso ao menu `Contatos`\n- Para importar: planilha salva como CSV\n\nEm `Contatos` fica a lista de todas as pessoas do workspace. Quem escreve por um canal conectado **entra sozinho**; você também cadastra um a um ou importa uma planilha. **Campos personalizados** guardam dados extras, como data de aniversário.\n\n> **Bom saber:** Por padrão, toda a equipe cadastra, importa e edita; só dono e admins **excluem**. Isso muda nas permissões *Criar*, *Editar* e *Excluir contatos*.\n\n## Encontrar e cadastrar\n\n1. Em `Contatos`, busque por nome, telefone ou e-mail. **Filtros** permite filtrar por *Tags* (todas devem estar), *Canais / Conexões* ou *Campos customizados*.\n2. Para cadastrar, clique em **Adicionar Contato**. **Nome** e **WhatsApp** são obrigatórios, com DDI e DDD (ex.: +55 11 99999-9999).\n3. Para editar, clique no contato. Abas: **Info**, **Dados e endereço**, **Tags** e **Custom Fields**.\n\n## Importar uma planilha\n\n1. Clique no botão **⋯**, ao lado de Filtros, e em **Importar**. Arquivo `.csv` com até **50.000 linhas** e **5 MB**.\n2. Confira o **Destino** de cada coluna e clique em **Continuar**.\n3. Em **Modo**, escolha *Só criar novos (ignora existentes)* ou *Atualizar existentes*. Em *Identificar duplicados por*, a opção *WhatsApp, depois email, depois telefone* é a mais completa.\n4. Clique em **Importar** e confira o resumo.\n\n> **Bom saber:** Cada linha precisa de WhatsApp, telefone ou e-mail. Em *Atualizar existentes*, célula vazia **não apaga** dados e as etiquetas são **somadas**. Detalhes do formato em «Importar e exportar contatos com etiquetas e campos personalizados» (artigo `importar-exportar-contatos`).\n\n## Criar campos personalizados\n\n1. Em `Personalização` → aba **Campos personalizados**, deixe **Contato** selecionado e clique em **Novo campo**. (*Oportunidade* é para campos do pipeline.)\n2. Preencha **Rótulo** e **Tipo** (texto, número, data, sim/não, seleção…) e salve.\n3. Ligue a chave **No chat** na linha do campo. **Sem ela, o campo não aparece** na ficha nem na conversa.\n\n## Exportar e excluir\n\n- **Exportar:** ⋯ → **Exportar** (traz os contatos da busca ou filtro; sem filtro, todos).\n- **Em massa:** marque as caixas e use **Tag** (+/−), **Exportar** ou **Deletar** na barra de baixo.\n- **Um contato:** ficha → **Deletar contato** → **Excluir contato**.\n\n> **Atenção:** Excluir um contato apaga também **conversas, mensagens, oportunidades, agendamentos, notas e campos** dele. Não dá para desfazer; exporte antes se precisar.\n\n## Não funcionou?\n\n- **Sintoma:** Aparece “Já existe um contato com esse número”\n - Causa provável: O número já está em outro contato (com ou sem 55 ou nono dígito).\n - O que fazer: Busque o contato existente e edite. Se puser num contato o número de outro, o painel junta os dois e avisa “Contato duplicado mesclado”.\n- **Sintoma:** A importação não começa\n - Causa provável: Arquivo não CSV, grande demais, outra importação em andamento ou nenhuma coluna de nome/WhatsApp/telefone/e-mail mapeada.\n - O que fazer: Salve como CSV, divida o arquivo, espere a outra terminar ou mapeie uma coluna de contato.\n- **Sintoma:** Contatos pulados ou erros de linha\n - Causa provável: Modo *Só criar novos* ignora existentes; linhas sem contato ou com número inválido dão erro.\n - O que fazer: Reimporte com *Atualizar existentes* e corrija as linhas indicadas.\n- **Sintoma:** O campo personalizado não aparece na ficha\n - Causa provável: A chave **No chat** está desligada, ou o campo é de Oportunidade.\n - O que fazer: Ligue **No chat** em Personalização → Campos personalizados.\n- **Sintoma:** “Limite de contatos do plano atingido” ou contatos com selo Pendente\n - Causa provável: O workspace chegou ao limite do plano; novos contatos ficam pendentes, sem mensagens nem automações.\n - O que fazer: Exclua contatos sem uso ou fale com sua agência sobre o plano.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Quem escreve no WhatsApp vira contato sozinho?**\nSim. Quem escreve por um canal conectado entra na lista automaticamente.\n\n**A importação apaga dados que estão vazios na planilha?**\nNão. Em Atualizar existentes, célula vazia não apaga nada.\n\n**Dá para recuperar um contato excluído?**\nNão. A exclusão apaga o contato e tudo ligado a ele.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como cadastro um contato?\n- Como importo minha lista de clientes?\n- Como crio um campo personalizado?\n- Meu campo não aparece na conversa\n- Excluir contato apaga as conversas?\n- Contato aparece como Pendente\n\nResposta curta: Em Contatos: busca e Filtros (tags, canais, campos). Adicionar Contato exige Nome e WhatsApp com DDI. Importar: ⋯ → Importar, CSV até 50.000 linhas e 5 MB, conferir Destino das colunas, escolher modo (Só criar novos ou Atualizar existentes) e como identificar duplicados. Campos personalizados: Personalização → Campos personalizados → Contato → Novo campo, e ligar a chave No chat para aparecer. Exportar: ⋯ → Exportar. Excluir apaga conversas, oportunidades e agendamentos, sem desfazer. Limite do plano deixa novos contatos como Pendente.\n\nEscalar para um humano quando:\n- Limite de contatos do plano\n- Contatos excluídos por engano\n\nVeja também: «Importar e exportar contatos com etiquetas e campos personalizados» (`importar-exportar-contatos`); «Filtros, etiquetas e pastas das conversas» (`filtros-etiquetas-e-pastas`); «Acompanhar negócios no pipeline» (`pipeline`)\n" }, { "slug": "importar-exportar-contatos", "categoria": "Contatos e vendas", "titulo": "Importar e exportar contatos com etiquetas e campos personalizados", "resumo": "Monte a planilha no formato certo, importe com etiquetas e campos, exporte tudo preenchido e use a planilha para mudar muitos contatos de uma vez.", "tags": [ "importar", "exportar", "csv", "planilha", "excel", "google planilhas", "etiquetas na planilha", "campos personalizados", "formato de data", "atualizar em massa", "5,51E+12", "telefone" ], "publico": "Donos, administradores e quem faz migração de base.", "no_painel": [ "Contatos", "⋯", "Importar / Exportar" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Posso tirar etiquetas pela planilha?", "resposta": "Não. As etiquetas são somadas. Para tirar de vários, marque os contatos e use Tag com o sinal de menos." }, { "pergunta": "A coluna precisa ter o nome exato do campo?", "resposta": "Precisa bater com o rótulo ou o nome técnico. Se não bater, escolha o campo em Destino na importação." }, { "pergunta": "Os campos sem a chave No chat saem na exportação?", "resposta": "Sim, saem também." } ], "problemas": [ { "sintoma": "No fim aparece “Valor não reconhecido em…”", "causa": "O valor não está num formato aceito para o tipo do campo.", "solucao": "Corrija a célula e reimporte com *Atualizar existentes*." }, { "sintoma": "As etiquetas não apareceram nos contatos", "causa": "Etiqueta nova sem a opção de criar marcada, modo *Só criar novos* ou nome escrito diferente (acento).", "solucao": "Reimporte com a opção marcada e *Atualizar existentes*, ou corrija o nome." }, { "sintoma": "Uma etiqueta virou duas", "causa": "O nome tem vírgula ou ponto e vírgula, que separam etiquetas.", "solucao": "Renomeie a etiqueta sem esses sinais em Personalização → Tags." }, { "sintoma": "Um campo personalizado ficou vazio", "causa": "Título da coluna diferente do rótulo, campo criado depois ou em Oportunidade, ou chave No chat desligada.", "solucao": "Escolha o campo em Destino, crie em Contato e ligue No chat." }, { "sintoma": "No Excel o arquivo exportado abre numa coluna só", "causa": "O arquivo usa vírgula e o Excel em português espera ponto e vírgula.", "solucao": "Use Dados → De Texto/CSV com vírgula como delimitador, ou o Google Planilhas." } ], "para_ia": { "perguntas": [ "Como importo contatos com etiquetas?", "Qual o formato de data na planilha?", "Meus telefones viraram 5,51E+12", "As etiquetas não entraram na importação", "Como atualizo vários contatos de uma vez?" ], "resposta": "Planilha CSV com colunas nome, whatsapp, telefone, email, notas e tags (etiquetas na mesma célula, separadas por vírgula ou ponto e vírgula; acentos importam) e uma coluna por campo personalizado (rótulo ou nome técnico). Formatos: data 25/12/1990, sim/não, número 1500,50. Formate telefones como texto para não virar 5,51E+12. Na importação, marque Criar tags que ainda não existem e use Atualizar existentes para contatos já cadastrados; etiquetas são somadas e células vazias não apagam. Para mudar em massa: exportar, editar mantendo whatsapp/telefone/email e reimportar com Atualizar existentes.", "escalar": [ "Importação grande com erros que o cliente não consegue resolver" ] }, "relacionados": [ "contatos", "filtros-etiquetas-e-pastas" ], "markdown": "---\nslug: importar-exportar-contatos\ncategoria: Contatos e vendas\natualizado: 17/10/2026\ntags: importar, exportar, csv, planilha, excel, google planilhas, etiquetas na planilha, campos personalizados, formato de data, atualizar em massa, 5,51E+12, telefone\nno_painel: Contatos > ⋯ > Importar / Exportar\nverificacao: baseado no guia oficial do painel\n---\n\n# Importar e exportar contatos com etiquetas e campos personalizados\n\nMonte a planilha no formato certo, importe com etiquetas e campos, exporte tudo preenchido e use a planilha para mudar muitos contatos de uma vez.\n\n**Para quem é:** Donos, administradores e quem faz migração de base.\n\n**Antes de começar:**\n- Permissão *Criar contatos* (para importar)\n- Campos personalizados já criados (veja «Importar, cadastrar e organizar contatos» (artigo `contatos`))\n- Arquivo `.csv` com até 50.000 linhas e 5 MB\n\nUma planilha CSV leva e traz, junto com os contatos, as **etiquetas** e os **campos personalizados** deles. Serve para trazer a base de outro sistema, baixar a sua com tudo preenchido ou mudar muitos contatos de uma vez: exporte, edite e importe de volta.\n\n## Montar a planilha\n\n- Colunas reconhecidas sozinhas: `nome`, `whatsapp`, `telefone` (ou `celular`), `email`, `notas` e `tags` (ou `etiquetas`).\n- Na coluna `tags`, todas as etiquetas na mesma célula, separadas por vírgula ou ponto e vírgula. Maiúsculas não importam; **acentos importam**.\n- Para cada campo personalizado, uma coluna com o **rótulo** do campo ou o **nome técnico**.\n\n| Tipo do campo | Formato aceito |\n|---|---|\n| Data | 25/12/1990 ou 1990-12-25 |\n| Data e hora | 15/10/2026 14:30 |\n| Sim/Não | Sim, Não, true, false, 1, 0 |\n| Número | 1500 ou 1500,50; com milhar, 1.500,00 (sozinho, 1.500 fica de fora) |\n| Seleção única | Uma das opções do campo |\n| Seleção múltipla | Opções separadas por vírgula |\n\n> **Atenção:** Excel e Google Planilhas podem transformar um número longo em `5,51E+12` e o telefone se perde. Escreva com espaço ou traço (+55 11 99999-0001) ou formate as colunas de telefone como **texto** antes de colar.\n\n## Importar\n\n1. Em `Contatos`, clique em **⋯** → **Importar** e escolha o `.csv`.\n2. Em **Destino**, confira: etiquetas como *Tags (coluna)*; campos no grupo *Personalizados*. Clique em **Continuar**.\n3. Escolha **Atualizar existentes** se a planilha traz contatos que já estão no painel.\n4. Se houver etiquetas novas, marque **Criar tags da coluna \"Tags\" que ainda não existem**. Sem essa marca, elas ficam de fora **sem aviso**.\n5. Clique em **Importar** e confira o resumo; valores não reconhecidos aparecem em vermelho, com linha e campo.\n\n> **Atenção:** Para deixar uma coluna de fora, **apague-a da planilha**. Escolher *Ignorar* não basta nas colunas que o painel reconhece pelo nome. E tirar uma etiqueta da planilha **não** tira do contato: as etiquetas são somadas.\n\n## Exportar e mudar em massa\n\n1. Exporte em **⋯** → **Exportar** (ou marque contatos e use **Exportar**, até 10.000 por vez). Vêm todas as colunas, etiquetas e campos personalizados.\n2. Abra no Google Planilhas desmarcando *Converter texto em números, datas e fórmulas*.\n3. Mantenha `whatsapp`, `telefone` e `email` (é por elas que o painel acha o contato), edite e baixe como CSV.\n4. Importe com **Atualizar existentes**.\n\n## Não funcionou?\n\n- **Sintoma:** No fim aparece “Valor não reconhecido em…”\n - Causa provável: O valor não está num formato aceito para o tipo do campo.\n - O que fazer: Corrija a célula e reimporte com *Atualizar existentes*.\n- **Sintoma:** As etiquetas não apareceram nos contatos\n - Causa provável: Etiqueta nova sem a opção de criar marcada, modo *Só criar novos* ou nome escrito diferente (acento).\n - O que fazer: Reimporte com a opção marcada e *Atualizar existentes*, ou corrija o nome.\n- **Sintoma:** Uma etiqueta virou duas\n - Causa provável: O nome tem vírgula ou ponto e vírgula, que separam etiquetas.\n - O que fazer: Renomeie a etiqueta sem esses sinais em Personalização → Tags.\n- **Sintoma:** Um campo personalizado ficou vazio\n - Causa provável: Título da coluna diferente do rótulo, campo criado depois ou em Oportunidade, ou chave No chat desligada.\n - O que fazer: Escolha o campo em Destino, crie em Contato e ligue **No chat**.\n- **Sintoma:** No Excel o arquivo exportado abre numa coluna só\n - Causa provável: O arquivo usa vírgula e o Excel em português espera ponto e vírgula.\n - O que fazer: Use Dados → De Texto/CSV com vírgula como delimitador, ou o Google Planilhas.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Posso tirar etiquetas pela planilha?**\nNão. As etiquetas são somadas. Para tirar de vários, marque os contatos e use Tag com o sinal de menos.\n\n**A coluna precisa ter o nome exato do campo?**\nPrecisa bater com o rótulo ou o nome técnico. Se não bater, escolha o campo em Destino na importação.\n\n**Os campos sem a chave No chat saem na exportação?**\nSim, saem também.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como importo contatos com etiquetas?\n- Qual o formato de data na planilha?\n- Meus telefones viraram 5,51E+12\n- As etiquetas não entraram na importação\n- Como atualizo vários contatos de uma vez?\n\nResposta curta: Planilha CSV com colunas nome, whatsapp, telefone, email, notas e tags (etiquetas na mesma célula, separadas por vírgula ou ponto e vírgula; acentos importam) e uma coluna por campo personalizado (rótulo ou nome técnico). Formatos: data 25/12/1990, sim/não, número 1500,50. Formate telefones como texto para não virar 5,51E+12. Na importação, marque Criar tags que ainda não existem e use Atualizar existentes para contatos já cadastrados; etiquetas são somadas e células vazias não apagam. Para mudar em massa: exportar, editar mantendo whatsapp/telefone/email e reimportar com Atualizar existentes.\n\nEscalar para um humano quando:\n- Importação grande com erros que o cliente não consegue resolver\n\nVeja também: «Importar, cadastrar e organizar contatos» (`contatos`); «Filtros, etiquetas e pastas das conversas» (`filtros-etiquetas-e-pastas`)\n" }, { "slug": "pipeline", "categoria": "Contatos e vendas", "titulo": "Acompanhar negócios no pipeline", "resumo": "Monte as etapas da venda, crie oportunidades, arraste os cards, marque ganho ou perdido e entenda estagnação, motivos de perda e limites.", "tags": [ "pipeline", "funil", "crm", "oportunidade", "card", "etapas", "ganha", "perdida", "motivo de perda", "estagnada", "kanban", "vendas", "arquivar etapa" ], "publico": "Donos, administradores e equipe comercial.", "no_painel": [ "Pipelines" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Quantas oportunidades o quadro mostra?", "resposta": "Até 200 ativas. Acima disso, use a busca e os filtros." }, { "pergunta": "Atendentes veem todas as oportunidades?", "resposta": "Com Ver todas as oportunidades desligado, cada um vê só as que criou ou que estão atribuídas a ele." }, { "pergunta": "O agente de IA pode criar cards?", "resposta": "Sim, com a ação Criar oportunidade ligada na function do agente e o nome exato da etapa." } ], "problemas": [ { "sintoma": "Ao marcar como perdida aparece “Nenhum motivo cadastrado”", "causa": "Não há motivos de perda.", "solucao": "Dono ou admin cadastra em Configurar → *Motivos de perda*." }, { "sintoma": "Arrastei o card e ele voltou", "causa": "A mudança não salvou: internet ou falta *Editar oportunidades*.", "solucao": "Tente de novo ou peça a permissão." }, { "sintoma": "Uma oportunidade sumiu do quadro", "causa": "Filtro ligado, foi marcada ganha/perdida, está numa etapa arquivada ou o quadro passou de 200 cards.", "solucao": "Clique em Limpar, veja as abas Ganhas, Perdidas e Todas, ou use a busca." }, { "sintoma": "“Limite de pipelines do plano atingido” ou “Limite de etapas por pipeline”", "causa": "O plano não permite mais.", "solucao": "Arquive etapas sem uso ou fale com sua agência." }, { "sintoma": "“Informe um valor válido com até duas casas decimais”", "causa": "Valor com símbolo de moeda ou formato errado.", "solucao": "Digite só o número, como 1500 ou 1.500,50." }, { "sintoma": "Não acho o contato ao criar a oportunidade", "causa": "A busca mostra só contatos já cadastrados.", "solucao": "Cadastre antes em Contatos." } ], "para_ia": { "perguntas": [ "Como crio um pipeline?", "Como marco um negócio como perdido?", "Por que o card voltou de etapa?", "Uma oportunidade sumiu", "O que é etapa estagnada?" ], "resposta": "Em Pipelines: criar pipeline (nome, template opcional, default), adicionar etapas na aba Etapas (estagnação em dias opcional) e cadastrar motivos de perda (obrigatório para marcar perdida; só dono e admins). Nova oportunidade exige contato cadastrado, título, etapa e valor só com números. Arrastar salva na hora. Marcar ganha/perdida leva às abas Ganhas/Perdidas; Reabrir devolve. Arquive só etapas vazias. O quadro mostra até 200 oportunidades ativas.", "escalar": [ "Limite de pipelines ou etapas do plano", "Oportunidades perdidas após arquivar etapa com cards" ] }, "relacionados": [ "contatos", "functions-do-agente", "outros-problemas-comuns" ], "markdown": "---\nslug: pipeline\ncategoria: Contatos e vendas\natualizado: 17/10/2026\ntags: pipeline, funil, crm, oportunidade, card, etapas, ganha, perdida, motivo de perda, estagnada, kanban, vendas, arquivar etapa\nno_painel: Pipelines\nverificacao: baseado no guia oficial do painel\n---\n\n# Acompanhar negócios no pipeline\n\nMonte as etapas da venda, crie oportunidades, arraste os cards, marque ganho ou perdido e entenda estagnação, motivos de perda e limites.\n\n**Para quem é:** Donos, administradores e equipe comercial.\n\n**Antes de começar:**\n- Acesso ao menu `Pipelines`\n- Contato já cadastrado para cada oportunidade (veja «Importar, cadastrar e organizar contatos» (artigo `contatos`))\n\nO pipeline é um quadro com as **etapas da sua venda**. Cada negócio é uma **oportunidade** (card), ligada a um contato. Você arrasta o card conforme a venda avança e, no fim, marca como ganho ou perdido. Cada etapa mostra a quantidade de cards e a soma dos valores.\n\n[Esquema: O caminho de uma oportunidade no quadro.]\n\n## Criar o pipeline e as etapas\n\n1. Em `Pipelines`, clique em **Criar primeira pipeline** (ou em **Configurar** → **Nova pipeline**).\n2. Dê um **Nome**, escolha um template de etapas ou *Sem template*, marque **Tornar default do workspace** se for o principal e clique em **Criar pipeline**.\n3. Na aba **Etapas**, use **Adicionar etapa** (nome e cor). Opcional: **Estagnação (dias)**, que marca o card como *Estagnada*. Arraste pelos pontinhos para reordenar.\n4. Na aba **Motivos de perda**, adicione pelo menos um motivo (ex.: *Preço alto*).\n\n> **Atenção:** **Sem pelo menos um motivo de perda, ninguém consegue marcar uma oportunidade como perdida.** Só dono e admins cadastram motivos.\n\n## Criar e acompanhar oportunidades\n\n1. Clique em **Nova oportunidade** (ou no **+** de uma etapa). Escolha o **Contato**, preencha **Título**, **Etapa inicial** e o valor só com números (ex.: 1500,00).\n2. Arraste o card para a próxima etapa. A mudança é salva na hora.\n3. Ao fechar: **Marcar ganha** (com valor final opcional) ou **Marcar perdida** (escolha o motivo). Elas vão para as abas **Ganhas** e **Perdidas**; **Reabrir** devolve ao quadro.\n\n> **Dica:** Também dá para criar e mover na conversa: **Mais ações** (⋮) → **Informações do contato** → seção *Pipeline / etapa*. O agente de IA também cria oportunidades, se tiver a ação ligada (veja «Dar ações ao agente com Functions» (artigo `functions-do-agente`)).\n\n## Arquivar uma etapa\n\nMova **todos** os cards para outra etapa, confira que a coluna mostra 0 e só então use **Configurar** → **Etapas** → **Arquivar**. Oportunidade que fica numa etapa arquivada **sai do quadro**.\n\n## Não funcionou?\n\n- **Sintoma:** Ao marcar como perdida aparece “Nenhum motivo cadastrado”\n - Causa provável: Não há motivos de perda.\n - O que fazer: Dono ou admin cadastra em **Configurar** → *Motivos de perda*.\n- **Sintoma:** Arrastei o card e ele voltou\n - Causa provável: A mudança não salvou: internet ou falta *Editar oportunidades*.\n - O que fazer: Tente de novo ou peça a permissão.\n- **Sintoma:** Uma oportunidade sumiu do quadro\n - Causa provável: Filtro ligado, foi marcada ganha/perdida, está numa etapa arquivada ou o quadro passou de 200 cards.\n - O que fazer: Clique em **Limpar**, veja as abas Ganhas, Perdidas e Todas, ou use a busca.\n- **Sintoma:** “Limite de pipelines do plano atingido” ou “Limite de etapas por pipeline”\n - Causa provável: O plano não permite mais.\n - O que fazer: Arquive etapas sem uso ou fale com sua agência.\n- **Sintoma:** “Informe um valor válido com até duas casas decimais”\n - Causa provável: Valor com símbolo de moeda ou formato errado.\n - O que fazer: Digite só o número, como 1500 ou 1.500,50.\n- **Sintoma:** Não acho o contato ao criar a oportunidade\n - Causa provável: A busca mostra só contatos já cadastrados.\n - O que fazer: Cadastre antes em Contatos.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Quantas oportunidades o quadro mostra?**\nAté 200 ativas. Acima disso, use a busca e os filtros.\n\n**Atendentes veem todas as oportunidades?**\nCom Ver todas as oportunidades desligado, cada um vê só as que criou ou que estão atribuídas a ele.\n\n**O agente de IA pode criar cards?**\nSim, com a ação Criar oportunidade ligada na function do agente e o nome exato da etapa.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como crio um pipeline?\n- Como marco um negócio como perdido?\n- Por que o card voltou de etapa?\n- Uma oportunidade sumiu\n- O que é etapa estagnada?\n\nResposta curta: Em Pipelines: criar pipeline (nome, template opcional, default), adicionar etapas na aba Etapas (estagnação em dias opcional) e cadastrar motivos de perda (obrigatório para marcar perdida; só dono e admins). Nova oportunidade exige contato cadastrado, título, etapa e valor só com números. Arrastar salva na hora. Marcar ganha/perdida leva às abas Ganhas/Perdidas; Reabrir devolve. Arquive só etapas vazias. O quadro mostra até 200 oportunidades ativas.\n\nEscalar para um humano quando:\n- Limite de pipelines ou etapas do plano\n- Oportunidades perdidas após arquivar etapa com cards\n\nVeja também: «Importar, cadastrar e organizar contatos» (`contatos`); «Dar ações ao agente com Functions» (`functions-do-agente`); «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (`outros-problemas-comuns`)\n" }, { "slug": "convidar-equipe", "categoria": "Equipe", "titulo": "Convidar pessoas para a equipe e definir o que cada uma acessa", "resumo": "Convide por e-mail, entenda os papéis Owner, Admin e Agente, personalize permissões e canais visíveis, crie equipes (departamentos) e escolha quem assina as mensagens.", "tags": [ "equipe", "convidar", "convite", "membros", "papel", "owner", "admin", "agente", "permissões", "departamento", "equipes", "canais visíveis", "assinatura", "resetar senha", "remover membro", "limite de membros" ], "publico": "Donos e administradores do workspace.", "no_painel": [ "Equipe" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Equipe e departamento são a mesma coisa?", "resposta": "Sim. Na aba Equipes você cria; na transferência de conversas elas aparecem como Departamentos." }, { "pergunta": "O convite vale para todos os meus workspaces?", "resposta": "Não. Vale só para o workspace aberto; para outro, envie outro convite." }, { "pergunta": "O agente vê as conversas dos colegas?", "resposta": "Só se Ver conversas de outros agentes estiver ligado para ele." } ], "problemas": [ { "sintoma": "Ao enviar o convite pede para configurar o Resend", "causa": "Falta a integração de e-mail do workspace.", "solucao": "Configure o Resend em Integrações com o e-mail remetente e envie de novo." }, { "sintoma": "“Limite de membros do plano atingido”", "causa": "Todas as vagas usadas, contando convites pendentes.", "solucao": "Revogue convites sem uso ou fale com sua agência sobre o plano." }, { "sintoma": "O e-mail não chegou, ou o convite está como “Falhou”", "causa": "Spam ou problema na integração de e-mail.", "solucao": "Confira o spam e o Resend; o dono usa Reenviar, ou mande o link do convite." }, { "sintoma": "“Este convite é inválido, expirou ou já foi usado”", "causa": "Link vencido, revogado, substituído por Reenviar ou já usado.", "solucao": "Se a pessoa já está em Membros, basta entrar pelo login; senão, o dono reenvia." }, { "sintoma": "Não vejo Editar ou Remover na linha de alguém", "causa": "Ninguém edita o dono; admin só edita e remove agentes.", "solucao": "Peça ao dono, ou que ele libere *Editar outros administradores*." }, { "sintoma": "“Você só pode conceder novos acessos que também possui”", "causa": "Quem não é dono só dá acessos que também tem.", "solucao": "Peça ao dono para fazer a mudança." } ], "para_ia": { "perguntas": [ "Como convido alguém para a equipe?", "Qual a diferença entre admin e agente?", "Como crio um departamento?", "O convite não chegou", "Como limito o que o atendente vê?", "Esqueci a senha de um atendente" ], "resposta": "Em Equipe → Convidar: nome, e-mail, papel (Agente ou Admin) e equipes; o convite sai pela integração Resend e vale 7 dias; o link aparece após Enviar. Papéis: Owner pode tudo e é o único que troca papéis e reseta senhas; Admin vê todas as conversas e gerencia agentes; Agente atende as próprias conversas e a aba Novos. Editar membro: permissões personalizadas, Ver conversas de outros agentes, Ver Fila e Canais visíveis. Equipes (aba Equipes) são os Departamentos da transferência. O limite do plano conta convites pendentes.", "escalar": [ "Limite de membros do plano", "Troca de dono do workspace", "Acesso perdido do próprio dono" ] }, "relacionados": [ "disponivel-ou-ausente", "atender-conversa", "functions-do-agente", "organizar-tarefas", "conversar-com-a-equipe" ], "markdown": "---\nslug: convidar-equipe\ncategoria: Equipe\natualizado: 17/10/2026\ntags: equipe, convidar, convite, membros, papel, owner, admin, agente, permissões, departamento, equipes, canais visíveis, assinatura, resetar senha, remover membro, limite de membros\nno_painel: Equipe\nverificacao: baseado no guia oficial do painel\n---\n\n# Convidar pessoas para a equipe e definir o que cada uma acessa\n\nConvide por e-mail, entenda os papéis Owner, Admin e Agente, personalize permissões e canais visíveis, crie equipes (departamentos) e escolha quem assina as mensagens.\n\n**Para quem é:** Donos e administradores do workspace.\n\n**Antes de começar:**\n- Ser dono ou admin (só eles veem o menu `Equipe` por padrão)\n- Integração de e-mail **Resend** configurada em `Integrações` (o convite sai por ela)\n\nEm `Equipe` você chama pessoas para o workspace, escolhe o papel de cada uma, organiza as equipes que recebem conversas e decide o que cada pessoa vê. **Tudo vale só para o workspace aberto**; para outro workspace, é preciso outro convite.\n\n[Esquema: O que cada papel pode fazer por padrão.]\n\n## Convidar uma pessoa\n\n1. Em `Equipe`, clique em **Convidar**. Preencha **Nome do membro** e e-mail.\n2. Escolha o papel (**Agente** ou **Admin**) e, se quiser, as equipes da pessoa.\n3. Clique em **Enviar**. Logo abaixo aparece o **link do convite**: se o e-mail não chegar, mande o link por outro canal.\n4. A pessoa aceita pelo e-mail (válido por **7 dias**), cria a senha e passa a aparecer em **Membros**.\n\n> **Bom saber:** O plano limita quantas pessoas o workspace pode ter, **contando convites pendentes**. O uso aparece abaixo do título (ex.: *3 de 5 usados*).\n\n## Definir o que a pessoa acessa\n\n1. Na aba **Membros**, clique em **Editar** na linha da pessoa.\n2. **Role:** Agente ou Admin (só o dono troca, e a troca volta as permissões ao padrão).\n3. **Equipes:** marque as equipes. **Permissões:** *Personalizar permissões* liga e desliga cada acesso; desligar *Ver contatos* ou *Ver pipelines* tira o menu.\n4. Para agentes, em *Visualização no Chat ao Vivo*: **Ver conversas de outros agentes** e **Ver Fila (conversas sem atendente)**.\n5. Em **Canais visíveis**, use *Selecionar conexões* para limitar o que a pessoa vê em Conversas. Clique em **Salvar**.\n\n## Criar equipes (departamentos)\n\nNa aba **Equipes**, clique em **Nova equipe**, dê nome e cor e salve; coloque as pessoas pelo **Editar** de cada membro. Na transferência de conversas, as equipes aparecem como **Departamentos** e recebem em rodízio entre os disponíveis. É também o destino que você configura na function de ações do agente de IA para a transferência não ficar sem responsável (veja «Dar ações ao agente com Functions» (artigo `functions-do-agente`)).\n\n## Outras ações\n\n- **Convites pendentes** (só o dono): *Reenviar* (o link anterior para de valer) ou *Revogar* (libera a vaga).\n- **Remover:** a pessoa perde o acesso na hora; as conversas ficam. Admin remove só agentes.\n- **Senha esquecida** (só o dono): ícone de chave → *Gerar nova senha*. A senha aparece uma única vez e a pessoa não recebe e-mail.\n- **Assinatura:** coluna *Assinatura* (Envia / Não envia). O nome aparece antes das respostas manuais, como *Maria Silva:*.\n\n## Não funcionou?\n\n- **Sintoma:** Ao enviar o convite pede para configurar o Resend\n - Causa provável: Falta a integração de e-mail do workspace.\n - O que fazer: Configure o Resend em `Integrações` com o e-mail remetente e envie de novo.\n- **Sintoma:** “Limite de membros do plano atingido”\n - Causa provável: Todas as vagas usadas, contando convites pendentes.\n - O que fazer: Revogue convites sem uso ou fale com sua agência sobre o plano.\n- **Sintoma:** O e-mail não chegou, ou o convite está como “Falhou”\n - Causa provável: Spam ou problema na integração de e-mail.\n - O que fazer: Confira o spam e o Resend; o dono usa **Reenviar**, ou mande o link do convite.\n- **Sintoma:** “Este convite é inválido, expirou ou já foi usado”\n - Causa provável: Link vencido, revogado, substituído por Reenviar ou já usado.\n - O que fazer: Se a pessoa já está em Membros, basta entrar pelo login; senão, o dono reenvia.\n- **Sintoma:** Não vejo Editar ou Remover na linha de alguém\n - Causa provável: Ninguém edita o dono; admin só edita e remove agentes.\n - O que fazer: Peça ao dono, ou que ele libere *Editar outros administradores*.\n- **Sintoma:** “Você só pode conceder novos acessos que também possui”\n - Causa provável: Quem não é dono só dá acessos que também tem.\n - O que fazer: Peça ao dono para fazer a mudança.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Equipe e departamento são a mesma coisa?**\nSim. Na aba Equipes você cria; na transferência de conversas elas aparecem como Departamentos.\n\n**O convite vale para todos os meus workspaces?**\nNão. Vale só para o workspace aberto; para outro, envie outro convite.\n\n**O agente vê as conversas dos colegas?**\nSó se Ver conversas de outros agentes estiver ligado para ele.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como convido alguém para a equipe?\n- Qual a diferença entre admin e agente?\n- Como crio um departamento?\n- O convite não chegou\n- Como limito o que o atendente vê?\n- Esqueci a senha de um atendente\n\nResposta curta: Em Equipe → Convidar: nome, e-mail, papel (Agente ou Admin) e equipes; o convite sai pela integração Resend e vale 7 dias; o link aparece após Enviar. Papéis: Owner pode tudo e é o único que troca papéis e reseta senhas; Admin vê todas as conversas e gerencia agentes; Agente atende as próprias conversas e a aba Novos. Editar membro: permissões personalizadas, Ver conversas de outros agentes, Ver Fila e Canais visíveis. Equipes (aba Equipes) são os Departamentos da transferência. O limite do plano conta convites pendentes.\n\nEscalar para um humano quando:\n- Limite de membros do plano\n- Troca de dono do workspace\n- Acesso perdido do próprio dono\n\nVeja também: «Ficar disponível ou ausente para receber conversas» (`disponivel-ou-ausente`); «Atender uma conversa: assumir, transferir e encerrar» (`atender-conversa`); «Dar ações ao agente com Functions» (`functions-do-agente`); «Organizar tarefas da equipe» (`organizar-tarefas`); «Conversar com a equipe pelo chat interno» (`conversar-com-a-equipe`)\n" }, { "slug": "disponivel-ou-ausente", "categoria": "Equipe", "titulo": "Ficar disponível ou ausente para receber conversas", "resumo": "Ligue ou desligue Disponível para atendimento no seu perfil, defina horários de atendimento e entenda por que alguém não aparece para receber transferências.", "tags": [ "disponível", "ausente", "indisponível", "disponibilidade", "status", "pausa", "horário de atendimento", "transferência", "rodízio", "não recebo conversas", "meu perfil" ], "publico": "Atendentes, donos e administradores.", "no_painel": [ "Meu perfil", "Disponibilidade" ], "atualizado": "17/10/2026", "faq": [ { "pergunta": "Se eu fechar o navegador fico ausente?", "resposta": "Não. O status só muda quando você desliga a chave." }, { "pergunta": "Ficar ausente tira minhas conversas?", "resposta": "Não. Você só deixa de receber novas transferências." }, { "pergunta": "A IA consegue transferir para mim fora do meu horário?", "resposta": "Não. Fora do horário de atendimento definido, você não recebe transferências." } ], "problemas": [ { "sintoma": "A chave voltou para a posição anterior com mensagem em vermelho", "causa": "O status não foi salvo.", "solucao": "Confira a internet e clique de novo." }, { "sintoma": "Estou disponível, mas não recebo transferências", "causa": "Workspace errado aberto, ou você está fora do seu horário de atendimento.", "solucao": "Confira o workspace no rodapé do menu e peça a quem gerencia para ver seu horário." }, { "sintoma": "Fiquei ausente e minhas conversas continuam comigo", "causa": "É o esperado.", "solucao": "Para passar uma conversa: ⋮ → Atribuir. Veja «Atender uma conversa: assumir, transferir e encerrar»." }, { "sintoma": "Uma pessoa não aparece na lista para transferir", "causa": "A lista mostra só quem está disponível e dentro do horário.", "solucao": "Peça para ela ligar a disponibilidade ou escolha outra pessoa." }, { "sintoma": "Transferi para um departamento e foi para o dono", "causa": "Ninguém do departamento estava disponível.", "solucao": "É o comportamento padrão; deixe alguém do departamento disponível." } ], "para_ia": { "perguntas": [ "Como fico ausente?", "Estou disponível e não recebo conversas", "Por que o colega não aparece para transferir?", "Como defino horário de atendimento de um atendente?" ], "resposta": "Meu perfil (clique no seu nome no rodapé do menu) → Disponibilidade → chave Disponível para atendimento. O status é manual e vale só para o workspace aberto; ausente não recebe novas transferências, mas mantém as conversas atuais. Dono e admins mudam em Equipe → Membros (coluna Disponibilidade) e definem horário em Editar → Receber transferências somente neste horário. A lista de Atribuir mostra só quem está disponível e no horário; departamento sem ninguém disponível manda para o dono.", "escalar": [ "Transferências indo para pessoa errada mesmo com status correto" ] }, "relacionados": [ "atender-conversa", "convidar-equipe", "outros-problemas-comuns" ], "markdown": "---\nslug: disponivel-ou-ausente\ncategoria: Equipe\natualizado: 17/10/2026\ntags: disponível, ausente, indisponível, disponibilidade, status, pausa, horário de atendimento, transferência, rodízio, não recebo conversas, meu perfil\nno_painel: Meu perfil > Disponibilidade\nverificacao: baseado no guia oficial do painel\n---\n\n# Ficar disponível ou ausente para receber conversas\n\nLigue ou desligue Disponível para atendimento no seu perfil, defina horários de atendimento e entenda por que alguém não aparece para receber transferências.\n\n**Para quem é:** Atendentes, donos e administradores.\n\n**Antes de começar:**\n- Nenhuma permissão especial para mudar o próprio status\n\nDisponível, você pode receber conversas transferidas pela equipe, pelas automações e pelos agentes de IA. Ausente, deixa de receber novas transferências até voltar, e **as conversas que já estão com você continuam com você**.\n\n> **Atenção:** O status é **manual**. Fechar o navegador, sair do painel ou ficar parado **não** muda nada. Ao sair para pausa ou fim do expediente, desligue a chave; ao voltar, ligue de novo.\n\n## Mudar o seu status\n\n1. No rodapé do menu lateral, clique no seu nome para abrir **Meu perfil**.\n2. Na seção **Disponibilidade**, ligue ou desligue **Disponível para atendimento**. Salva na hora.\n\n> **Bom saber:** O status vale **só para o workspace aberto**. Se você atende em mais de um, ajuste em cada um. O aplicativo instalado no celular não mostra Meu perfil: mude pelo navegador.\n\n## Se você gerencia a equipe\n\n1. Em `Equipe` → **Membros**, a coluna **Disponibilidade** mostra quem está disponível. Dono e admins clicam na chave para mudar.\n2. Para definir horário: **Editar** na linha da pessoa → marque **Receber transferências somente neste horário**, escolha dias, início e fim (segue o fuso do workspace) e salve.\n\nO dono muda a disponibilidade de qualquer pessoa; um admin, a dos agentes (de outros admins só com permissão do dono).\n\n## Não funcionou?\n\n- **Sintoma:** A chave voltou para a posição anterior com mensagem em vermelho\n - Causa provável: O status não foi salvo.\n - O que fazer: Confira a internet e clique de novo.\n- **Sintoma:** Estou disponível, mas não recebo transferências\n - Causa provável: Workspace errado aberto, ou você está fora do seu horário de atendimento.\n - O que fazer: Confira o workspace no rodapé do menu e peça a quem gerencia para ver seu horário.\n- **Sintoma:** Fiquei ausente e minhas conversas continuam comigo\n - Causa provável: É o esperado.\n - O que fazer: Para passar uma conversa: ⋮ → **Atribuir**. Veja «Atender uma conversa: assumir, transferir e encerrar» (artigo `atender-conversa`).\n- **Sintoma:** Uma pessoa não aparece na lista para transferir\n - Causa provável: A lista mostra só quem está disponível e dentro do horário.\n - O que fazer: Peça para ela ligar a disponibilidade ou escolha outra pessoa.\n- **Sintoma:** Transferi para um departamento e foi para o dono\n - Causa provável: Ninguém do departamento estava disponível.\n - O que fazer: É o comportamento padrão; deixe alguém do departamento disponível.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Perguntas frequentes\n\n**Se eu fechar o navegador fico ausente?**\nNão. O status só muda quando você desliga a chave.\n\n**Ficar ausente tira minhas conversas?**\nNão. Você só deixa de receber novas transferências.\n\n**A IA consegue transferir para mim fora do meu horário?**\nNão. Fora do horário de atendimento definido, você não recebe transferências.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Como fico ausente?\n- Estou disponível e não recebo conversas\n- Por que o colega não aparece para transferir?\n- Como defino horário de atendimento de um atendente?\n\nResposta curta: Meu perfil (clique no seu nome no rodapé do menu) → Disponibilidade → chave Disponível para atendimento. O status é manual e vale só para o workspace aberto; ausente não recebe novas transferências, mas mantém as conversas atuais. Dono e admins mudam em Equipe → Membros (coluna Disponibilidade) e definem horário em Editar → Receber transferências somente neste horário. A lista de Atribuir mostra só quem está disponível e no horário; departamento sem ninguém disponível manda para o dono.\n\nEscalar para um humano quando:\n- Transferências indo para pessoa errada mesmo com status correto\n\nVeja também: «Atender uma conversa: assumir, transferir e encerrar» (`atender-conversa`); «Convidar pessoas para a equipe e definir o que cada uma acessa» (`convidar-equipe`); «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (`outros-problemas-comuns`)\n" }, { "slug": "entender-o-dashboard", "categoria": "Comece por aqui", "titulo": "Entender o Dashboard: atendimento, negócios e anúncios", "resumo": "Entenda os números das abas Atendimento, Negócios e Anúncios, escolha o período e atualize os dados do Dashboard.", "tags": [ "dashboard", "métricas", "relatório", "indicadores", "iniciados", "finalizados", "aguardando", "tempo de resposta", "ia vs humano", "negócios", "taxa de ganho", "anúncios", "custo whatsapp", "atualizar" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Dashboard" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Os números não mudam, mesmo com conversas novas", "causa": "", "solucao": "O Dashboard não busca dados sozinho. Clique em Atualizar (na aba Anúncios, no botão da própria aba). Voltar a um período já aberto mostra os números daquela busca até você atualizar." }, { "sintoma": "Não vejo a aba Negócios ou a aba Anúncios", "causa": "", "solucao": "Elas dependem de Ver todas as oportunidades (Negócios) e Ver todas as conversas (Anúncios). Peça a quem administra a sua equipe para ligar em Equipe e depois recarregue a página." }, { "sintoma": "A aba Anúncios mostra \"Nenhuma origem de anúncio identificada neste período e conexão\"", "causa": "", "solucao": "Nenhuma mensagem com a marca de anúncio chegou nesse período e conexão. Confira se o anúncio abre conversa num número da API Oficial Meta e tente últimos 30 dias com Todas as conexões permitidas." }, { "sintoma": "O Custo estimado mostra \"—\" e \"defina a tarifa\"", "causa": "", "solucao": "A tarifa por mensagem ainda não foi preenchida. O dono ou um admin do workspace preenche esse valor em Configurações, na seção Workspace. Escolha a moeda da estimativa (dólar americano, euro ou real brasileiro) e informe a tarifa nessa moeda. A escolha vale para custos, gráficos e simulador; não há conversão cambial automática." }, { "sintoma": "O número de Em atendimento é diferente das abas de Conversas", "causa": "", "solucao": "No Dashboard, a conversa com agente de IA conta em Em atendimento. Em Conversas, ela fica em Novos até uma pessoa assumir, e as conversas que estão com a equipe se dividem entre Meus atendimentos e Outros. Confira também se você clicou em Atualizar." }, { "sintoma": "Aparece \"Sua conta está pronta!\" e nenhum número", "causa": "", "solucao": "Você ainda não faz parte de nenhum workspace. Aguarde o e-mail de convite e abra o link dele. Se ele não chegar, fale com o responsável pela sua agência." } ], "para_ia": { "perguntas": [ "Entender o Dashboard?", "Os números não mudam, mesmo com conversas novas", "Não vejo a aba Negócios ou a aba Anúncios", "A aba Anúncios mostra \"Nenhuma origem de anúncio identificada neste período e conexão\"", "O Custo estimado mostra \"—\" e \"defina a tarifa\"" ], "resposta": "Entenda os números das abas Atendimento, Negócios e Anúncios, escolha o período e atualize os dados do Dashboard. No menu lateral, clique em Dashboard. No topo, escolha o período: Hoje, Últimos 7 dias (o padrão), Últimos 30 dias, Este mês ou Personalizado. Em Personalizado, preencha as duas datas; o intervalo pode ter até 92 dias. Clique em Atualizar para ver os números de agora. O Dashboard não se atualiza sozinho: ao lado do período aparece a hora da última busca, por exemplo Atualizado às 14:30. Clique na aba Atendimento. Os quatro cartões do topo também são filtros: clique num deles para trocar o que aparece embaixo.", "escalar": [] }, "relacionados": [ "configuracoes-do-painel", "medir-anuncios-com-a-meta", "pipeline" ], "markdown": "---\nslug: entender-o-dashboard\ncategoria: Comece por aqui\natualizado: 17/10/2026\ntags: dashboard, métricas, relatório, indicadores, iniciados, finalizados, aguardando, tempo de resposta, ia vs humano, negócios, taxa de ganho, anúncios, custo whatsapp, atualizar\nno_painel: Dashboard\nverificacao: baseado no guia oficial do painel\n---\n\n# Entender o Dashboard: atendimento, negócios e anúncios\n\nEntenda os números das abas Atendimento, Negócios e Anúncios, escolha o período e atualize os dados do Dashboard.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- O **Dashboard** e a aba **Atendimento** aparecem para todos da equipe.\n- A aba **Negócios** aparece para quem tem **Ver todas as oportunidades**. A aba **Anúncios**, para quem tem **Ver todas as conversas** (para atendentes, é a opção **Ver conversas de outros agentes**). Por padrão, o dono e os admins do workspace veem as três. Essas permissões ficam em **Equipe**.\n- Se você só enxerga algumas conexões (**Canais visíveis**, em **Equipe**), os números de **Atendimento** e **Anúncios** contam só essas conexões.\n- O que conta como **Hoje** ou **Este mês** segue o **Fuso horário** do workspace. Veja «Configurações: notificações, fuso horário e o que acontece quando o cliente volta a escrever» (artigo `configuracoes-do-painel`).\n\nO **Dashboard** é a primeira tela do painel. Ele mostra, em números e gráficos, como está o atendimento, quanto a equipe está vendendo e quantos clientes chegaram por anúncios.\n\n## Escolher o período e atualizar\n\n1. No menu lateral, clique em **Dashboard**.\n2. No topo, escolha o período: **Hoje**, **Últimos 7 dias** (o padrão), **Últimos 30 dias**, **Este mês** ou **Personalizado**. Em **Personalizado**, preencha as duas datas; o intervalo pode ter até 92 dias.\n3. Clique em **Atualizar** para ver os números de agora. O Dashboard não se atualiza sozinho: ao lado do período aparece a hora da última busca, por exemplo *Atualizado às 14:30*.\n\n## Ler a aba Atendimento\n\n1. Clique na aba **Atendimento**. Os quatro cartões do topo também são filtros: clique num deles para trocar o que aparece embaixo.\n - **Iniciados**: conversas que começaram no período.\n - **Finalizados**: conversas resolvidas no período.\n - **Em atendimento**: conversas abertas agora com alguém da equipe ou com um agente de IA.\n - **Aguardando**: conversas abertas agora sem ninguém, nem pessoa nem IA, mais as pendentes.\n A porcentagem em **Iniciados** e **Finalizados** compara com o período anterior do mesmo tamanho.\n2. Com **Iniciados** ou **Finalizados** selecionado, veja:\n - o gráfico por dia e o mapa de calor (quanto mais forte a cor, mais conversas naquele dia da semana e hora);\n - **IA vs Humano**: quanto das mensagens enviadas saiu da IA e quanto saiu da equipe. Embaixo, **Tempo de resposta (mediana)** mostra o tempo típico de cada um para responder ao cliente;\n - **1ª resposta** e **Resolução**: o tempo médio até a primeira resposta e até a conversa ser resolvida;\n - **Carga por atendente** e **Carga por equipe** (abertas agora e resolvidas no período) e **Carga por conexão**.\n3. Com **Em atendimento** ou **Aguardando** selecionado, aparece uma lista com até 50 conversas. Clique numa linha para abrir a conversa. Em **Aguardando**, a coluna **Espera** mostra há quanto tempo o cliente espera.\n4. No fim, **WhatsApp Cloud API — mensagens & custo** conta as mensagens enviadas pela **API Oficial Meta** (as do QR Code ficam de fora). O **Custo estimado** só aparece depois que o dono ou um admin preenche a tarifa por mensagem em **Configurações**. É uma estimativa: o valor real vem da cobrança da Meta.\n\n## Ler a aba Negócios\n\n1. Clique na aba **Negócios**. Se quiser, escolha uma pipeline em **Todas as pipelines** e alterne entre **Valor** e **Quantidade**.\n2. Leia os cartões:\n - **Criados**, **Ganhos** e **Perdidos**: negócios criados, ganhos ou perdidos no período.\n - **Em aberto**: negócios abertos agora, de qualquer data.\n - **Taxa de ganho**: dos negócios fechados no período, a parte que foi ganha.\n3. Clique num cartão para ver o gráfico por dia e as listas **Por atendente**, **Por etapa**, **Por motivo de perda** ou **Por pipeline**.\n4. Na lista de oportunidades, mais abaixo, clique no título de uma delas para abri-la em **Pipelines**.\n\n## Ler a aba Anúncios\n\n1. Clique na aba **Anúncios**. Ela tem filtros próprios: em **Período**, escolha **hoje**, **últimos 7 dias** ou **últimos 30 dias** (o padrão e o máximo); em **Conexão WhatsApp**, escolha um número ou deixe **Todas as conexões permitidas**.\n2. Leia os três números:\n - **Entradas por anúncios**: cada vez que alguém chegou clicando num anúncio. O mesmo clique conta uma vez só.\n - **Contatos únicos**: pessoas diferentes. Quem chegou por dois anúncios conta uma vez.\n - **Conversas de anúncios**: conversas que receberam pelo menos uma entrada.\n3. Veja a **Evolução diária** e a lista **20 anúncios com mais contatos**. A mesma pessoa pode aparecer em vários dias ou anúncios, então não some essas linhas.\n4. Em **Negócios vinculados a anúncios** (só para quem também vê a aba **Negócios**), veja os negócios criados e ganhos a partir de anúncios e o **Valor dos negócios ganhos**. O negócio conta para o último anúncio que trouxe a pessoa, na mesma conversa, nos 30 dias antes de ele ser criado.\n5. Em **Entrega de eventos à Meta**, acompanhe os avisos enviados à Meta quando o envio de conversões está ligado em **Integrações** (**Meta Conversions API**). **Recebido pela Meta** quer dizer só que a Meta aceitou o aviso, não que ele virou conversão no Gerenciador de Anúncios. **Não enviado** aparece quando a integração ou aquele evento estava desligado.\n6. Clique em **Ver entradas identificadas** para ver cada entrada, com data, contato, anúncio e conexão. Clique no nome do contato para abrir a conversa.\n\n> **Atenção:** A aba **Anúncios** só conta mensagens que chegam de um clique em anúncio que abre o WhatsApp, quando a própria Meta informa que vieram do anúncio. Vale para números da **API Oficial Meta**, inclusive em **Coexistência (COEX)**. QR Code, Instagram e Messenger não entram, nem mensagens de antes de o recurso ser ativado.\n\n## Não funcionou?\n\n- **Os números não mudam, mesmo com conversas novas**\n O Dashboard não busca dados sozinho. Clique em **Atualizar** (na aba **Anúncios**, no botão da própria aba). Voltar a um período já aberto mostra os números daquela busca até você atualizar.\n- **Não vejo a aba Negócios ou a aba Anúncios**\n Elas dependem de **Ver todas as oportunidades** (**Negócios**) e **Ver todas as conversas** (**Anúncios**). Peça a quem administra a sua equipe para ligar em **Equipe** e depois recarregue a página.\n- **A aba Anúncios mostra \"Nenhuma origem de anúncio identificada neste período e conexão\"**\n Nenhuma mensagem com a marca de anúncio chegou nesse período e conexão. Confira se o anúncio abre conversa num número da **API Oficial Meta** e tente **últimos 30 dias** com **Todas as conexões permitidas**.\n- **O Custo estimado mostra \"—\" e \"defina a tarifa\"**\n A tarifa por mensagem ainda não foi preenchida. O dono ou um admin do workspace preenche esse valor em **Configurações**, na seção **Workspace**. Escolha a moeda da estimativa (dólar americano, euro ou real brasileiro) e informe a tarifa nessa moeda. A escolha vale para custos, gráficos e simulador; não há conversão cambial automática.\n- **O número de Em atendimento é diferente das abas de Conversas**\n No Dashboard, a conversa com agente de IA conta em **Em atendimento**. Em **Conversas**, ela fica em **Novos** até uma pessoa assumir, e as conversas que estão com a equipe se dividem entre **Meus atendimentos** e **Outros**. Confira também se você clicou em **Atualizar**.\n- **Aparece \"Sua conta está pronta!\" e nenhum número**\n Você ainda não faz parte de nenhum workspace. Aguarde o e-mail de convite e abra o link dele. Se ele não chegar, fale com o responsável pela sua agência.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Entender o Dashboard?\n- Os números não mudam, mesmo com conversas novas\n- Não vejo a aba Negócios ou a aba Anúncios\n- A aba Anúncios mostra \"Nenhuma origem de anúncio identificada neste período e conexão\"\n- O Custo estimado mostra \"—\" e \"defina a tarifa\"\n\nResposta curta: Entenda os números das abas Atendimento, Negócios e Anúncios, escolha o período e atualize os dados do Dashboard. No menu lateral, clique em Dashboard. No topo, escolha o período: Hoje, Últimos 7 dias (o padrão), Últimos 30 dias, Este mês ou Personalizado. Em Personalizado, preencha as duas datas; o intervalo pode ter até 92 dias. Clique em Atualizar para ver os números de agora. O Dashboard não se atualiza sozinho: ao lado do período aparece a hora da última busca, por exemplo Atualizado às 14:30. Clique na aba Atendimento. Os quatro cartões do topo também são filtros: clique num deles para trocar o que aparece embaixo.\n\nVeja também: «Configurações: notificações, fuso horário e o que acontece quando o cliente volta a escrever» (`configuracoes-do-painel`); «Enviar à Meta os leads e as vendas dos seus anúncios» (`medir-anuncios-com-a-meta`); «Acompanhar negócios no pipeline» (`pipeline`)\n" }, { "slug": "personalizar-o-painel", "categoria": "Painel e integrações", "titulo": "Personalizar o painel: tema, idioma e perfil", "resumo": "Troque entre o tema claro e o escuro, escolha o idioma, atualize nome, foto e senha e use o painel como aplicativo no celular.", "tags": [ "tema escuro", "tema claro", "idioma", "perfil", "foto", "senha", "trocar senha", "aplicativo", "celular", "instalar app", "whatsapp para notificações", "dois fatores" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Meu perfil" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Troquei o tema, mas em outro computador ou navegador ele voltou ao anterior", "causa": "", "solucao": "O tema fica salvo só no navegador em que você escolheu. Na primeira vez, o painel segue o tema claro ou escuro do seu computador ou celular. Para mudar, clique no botão do tema de novo nesse navegador." }, { "sintoma": "Escolhi outro idioma, mas o painel não mudou", "causa": "", "solucao": "Se apareceu um traço vermelho embaixo da bandeira, a escolha não foi salva. Passe o mouse sobre a bandeira para ver o motivo, confira a sua internet e escolha o idioma de novo." }, { "sintoma": "Salvei o nome ou a foto, mas o menu lateral ainda mostra o antigo", "causa": "", "solucao": "Atualize a página do navegador. A foto nova pode levar alguns minutos para aparecer em todos os lugares." }, { "sintoma": "A foto não foi enviada", "causa": "", "solucao": "Veja a mensagem que apareceu:\n- Se aparecer Imagem grande demais (máx 5MB)., escolha uma imagem menor ou reduza o tamanho dela.\n- Se aparecer Formato não suportado. Use JPG, PNG, WebP ou GIF., salve a imagem em um desses formatos e envie de novo." }, { "sintoma": "A senha não foi trocada", "causa": "", "solucao": "Veja a mensagem que apareceu:\n- Se aparecer Senha atual inválida., a senha atual digitada não confere. Se você a esqueceu, peça ao dono do workspace para gerar uma senha nova para você em Equipe.\n- Se aparecer A nova senha precisa ter no mínimo 8 caracteres., use uma senha mais longa.\n- Se aparecer A confirmação não confere., digite a mesma senha nova nos dois campos." }, { "sintoma": "Quero trocar o e-mail de acesso", "causa": "", "solucao": "O campo Email aparece com um cadeado: ele não pode ser trocado por aqui. Fale com o responsável pela sua agência." }, { "sintoma": "No aplicativo instalado, não encontro o menu lateral", "causa": "", "solucao": "O aplicativo instalado não tem o menu lateral. No lugar dele, use o botão Menu, no topo da tela, que mostra também o nome do workspace. Ali você troca de workspace e abre Conversas, Agendamentos, Pipelines e Contatos, conforme o seu acesso. A bandeira do idioma, o botão do tema e Meu perfil não aparecem no aplicativo. Para trocar o idioma ou editar o perfil, abra o painel no navegador: essas escolhas ficam na sua conta e também valem no aplicativo." }, { "sintoma": "O botão Instalar app não aparece", "causa": "", "solucao": "Ele só aparece quando o navegador oferece instalar o painel, e some depois que o painel está instalado. Se o painel já estiver instalado, abra o aplicativo: nele, o botão Configurar notificações fica no mesmo lugar." } ], "para_ia": { "perguntas": [ "Personalizar o painel?", "Troquei o tema, mas em outro computador ou navegador ele voltou ao anterior", "Escolhi outro idioma, mas o painel não mudou", "Salvei o nome ou a foto, mas o menu lateral ainda mostra o antigo", "A foto não foi enviada" ], "resposta": "Troque entre o tema claro e o escuro, escolha o idioma, atualize nome, foto e senha e use o painel como aplicativo no celular. No rodapé do menu lateral, clique no botão com o ícone de lua ou de sol, ao lado da bandeira. A lua indica que o tema escuro está ativo; o sol, que o claro está ativo. Ao passar o mouse, aparece Mudar pra tema claro ou Mudar pra tema escuro. O painel troca de tema na hora. Para voltar, clique de novo. No rodapé do menu lateral, clique na bandeira. Escolha Português (Brasil), English (US) ou Español (España). O painel muda de idioma assim que a escolha é salva.", "escalar": [ "Troca do e-mail de acesso", "Senha esquecida (só o dono gera uma nova)" ] }, "relacionados": [ "disponivel-ou-ausente", "configuracoes-do-painel" ], "markdown": "---\nslug: personalizar-o-painel\ncategoria: Painel e integrações\natualizado: 17/10/2026\ntags: tema escuro, tema claro, idioma, perfil, foto, senha, trocar senha, aplicativo, celular, instalar app, whatsapp para notificações, dois fatores\nno_painel: Meu perfil\nverificacao: baseado no guia oficial do painel\n---\n\n# Personalizar o painel: tema, idioma e perfil\n\nTroque entre o tema claro e o escuro, escolha o idioma, atualize nome, foto e senha e use o painel como aplicativo no celular.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Qualquer pessoa da equipe pode fazer esses ajustes, sem permissão especial.\n- Os atalhos ficam no rodapé do menu lateral, no cartão com o seu nome (ou o seu e-mail): a bandeira do idioma, o botão do tema e o botão **Sair**. Se o menu estiver recolhido, eles aparecem um embaixo do outro.\n- O tema fica salvo no navegador que você está usando. O idioma, o nome, a foto e a senha ficam salvos na sua conta e valem em qualquer computador ou celular.\n\nDeixe o painel do seu jeito: use o tema claro ou o escuro, escolha o idioma das telas e mantenha o seu nome, a sua foto e a sua senha em dia. O tema e o idioma valem só para você, não para o resto da equipe.\n\n## Tema claro ou escuro\n\n1. No rodapé do menu lateral, clique no botão com o ícone de lua ou de sol, ao lado da bandeira. A lua indica que o tema escuro está ativo; o sol, que o claro está ativo. Ao passar o mouse, aparece **Mudar pra tema claro** ou **Mudar pra tema escuro**.\n2. O painel troca de tema na hora. Para voltar, clique de novo.\n\n## Idioma\n\n1. No rodapé do menu lateral, clique na bandeira.\n2. Escolha **Português (Brasil)**, **English (US)** ou **Español (España)**. O painel muda de idioma assim que a escolha é salva.\n\nVocê também pode trocar o idioma em **Meu perfil**, no campo **Idioma**, e depois clicar em **Salvar alterações**.\n\n## Nome, foto e senha\n\n1. No rodapé do menu lateral, clique no seu nome para abrir **Meu perfil**.\n2. Em **Foto de perfil**, clique em **Enviar foto** (ou em **Trocar foto**, se já tiver uma) e escolha uma imagem JPG, PNG, WebP ou GIF de até 5 MB. A foto é salva na hora; para tirá-la, use **Remover**.\n3. Em **Informações pessoais**, altere o **Nome completo**.\n4. Se quiser receber no WhatsApp os avisos que as automações e os agentes de IA enviam para você, preencha **WhatsApp para notificações** com DDI e DDD. Deixe vazio para não receber.\n5. Clique em **Salvar alterações** e aguarde a mensagem **Perfil atualizado.**\n6. Para trocar a senha, em **Alterar senha**, preencha **Senha atual**, **Nova senha** (no mínimo 8 caracteres) e **Confirmar nova senha**.\n7. Clique em **Alterar senha**. Se a sua conta usa autenticação em dois fatores, digite também o código do seu aplicativo autenticador. No fim, aparece **Senha alterada com sucesso.**\n\n> **Dica:** Em **Meu perfil** fica também a seção **Disponibilidade**, que define se você recebe transferências de conversas. Veja «Ficar disponível ou ausente para receber conversas» (artigo `disponivel-ou-ausente`).\n\n## Usar no celular como aplicativo\n\n1. No navegador do celular, abra **Conversas**. Se o navegador oferecer a instalação, aparece o botão **Instalar app** acima da busca. Clique nele e confirme na janela do navegador.\n2. Abra o aplicativo instalado. Ele abre em **Conversas** e não tem o menu lateral.\n3. Para receber avisos de conversas no aparelho, clique em **Configurar notificações**, acima da busca, e depois em **Ativar notificações**. Autorize na pergunta do aparelho e aguarde **Notificações do navegador ativadas**. Esses avisos valem só neste aparelho. O som e os outros ajustes de aviso ficam em **Configurações**, que você abre no navegador; veja «Configurações: notificações, fuso horário e o que acontece quando o cliente volta a escrever» (artigo `configuracoes-do-painel`).\n4. Para trocar de workspace ou abrir **Agendamentos**, **Pipelines** ou **Contatos**, clique em **Menu**, no topo da tela, e escolha o destino. Só aparecem as telas que o seu acesso permite.\n\n## Não funcionou?\n\n- **Troquei o tema, mas em outro computador ou navegador ele voltou ao anterior**\n O tema fica salvo só no navegador em que você escolheu. Na primeira vez, o painel segue o tema claro ou escuro do seu computador ou celular. Para mudar, clique no botão do tema de novo nesse navegador.\n- **Escolhi outro idioma, mas o painel não mudou**\n Se apareceu um traço vermelho embaixo da bandeira, a escolha não foi salva. Passe o mouse sobre a bandeira para ver o motivo, confira a sua internet e escolha o idioma de novo.\n- **Salvei o nome ou a foto, mas o menu lateral ainda mostra o antigo**\n Atualize a página do navegador. A foto nova pode levar alguns minutos para aparecer em todos os lugares.\n- **A foto não foi enviada**\n Veja a mensagem que apareceu:\n - Se aparecer **Imagem grande demais (máx 5MB).**, escolha uma imagem menor ou reduza o tamanho dela.\n - Se aparecer **Formato não suportado. Use JPG, PNG, WebP ou GIF.**, salve a imagem em um desses formatos e envie de novo.\n- **A senha não foi trocada**\n Veja a mensagem que apareceu:\n - Se aparecer **Senha atual inválida.**, a senha atual digitada não confere. Se você a esqueceu, peça ao dono do workspace para gerar uma senha nova para você em **Equipe**.\n - Se aparecer **A nova senha precisa ter no mínimo 8 caracteres.**, use uma senha mais longa.\n - Se aparecer **A confirmação não confere.**, digite a mesma senha nova nos dois campos.\n- **Quero trocar o e-mail de acesso**\n O campo **Email** aparece com um cadeado: ele não pode ser trocado por aqui. Fale com o responsável pela sua agência.\n- **No aplicativo instalado, não encontro o menu lateral**\n O aplicativo instalado não tem o menu lateral. No lugar dele, use o botão **Menu**, no topo da tela, que mostra também o nome do workspace. Ali você troca de workspace e abre **Conversas**, **Agendamentos**, **Pipelines** e **Contatos**, conforme o seu acesso. A bandeira do idioma, o botão do tema e **Meu perfil** não aparecem no aplicativo. Para trocar o idioma ou editar o perfil, abra o painel no navegador: essas escolhas ficam na sua conta e também valem no aplicativo.\n- **O botão Instalar app não aparece**\n Ele só aparece quando o navegador oferece instalar o painel, e some depois que o painel está instalado. Se o painel já estiver instalado, abra o aplicativo: nele, o botão **Configurar notificações** fica no mesmo lugar.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Personalizar o painel?\n- Troquei o tema, mas em outro computador ou navegador ele voltou ao anterior\n- Escolhi outro idioma, mas o painel não mudou\n- Salvei o nome ou a foto, mas o menu lateral ainda mostra o antigo\n- A foto não foi enviada\n\nResposta curta: Troque entre o tema claro e o escuro, escolha o idioma, atualize nome, foto e senha e use o painel como aplicativo no celular. No rodapé do menu lateral, clique no botão com o ícone de lua ou de sol, ao lado da bandeira. A lua indica que o tema escuro está ativo; o sol, que o claro está ativo. Ao passar o mouse, aparece Mudar pra tema claro ou Mudar pra tema escuro. O painel troca de tema na hora. Para voltar, clique de novo. No rodapé do menu lateral, clique na bandeira. Escolha Português (Brasil), English (US) ou Español (España). O painel muda de idioma assim que a escolha é salva.\n\nEscalar para um humano quando:\n- Troca do e-mail de acesso\n- Senha esquecida (só o dono gera uma nova)\n\nVeja também: «Ficar disponível ou ausente para receber conversas» (`disponivel-ou-ausente`); «Configurações: notificações, fuso horário e o que acontece quando o cliente volta a escrever» (`configuracoes-do-painel`)\n" }, { "slug": "campos-do-sistema-e-iframes", "categoria": "Painel e integrações", "titulo": "Usar os campos do sistema e colocar outros sites no menu", "resumo": "Use os campos que o painel preenche sozinho nas mensagens, escolha o que aparece na conversa e coloque páginas de outros sites no menu lateral.", "tags": [ "campos do sistema", "placeholder", "variáveis", "primeiro nome", "contact_first_name", "protocolo", "iframe", "menu lateral", "incorporar site", "no chat", "personalização" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Personalização", "Campos do sistema / Iframes" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "A página fica em branco ou o login do site não funciona dentro do painel", "causa": "", "solucao": "Muitos sites não se deixam mostrar dentro de outra página, ou bloqueiam o login ali. É uma trava do próprio site, e o painel não consegue contornar. Clique em Abrir em nova aba. Se o site tem a opção de incorporar ou de compartilhar uma página, use o endereço ou o código que ela gera." }, { "sintoma": "Aparece \"Informe uma URL HTTPS válida ou um código iframe com endereço HTTPS.\"", "causa": "", "solucao": "O endereço precisa começar com https:// e não pode trazer usuário e senha. Se colou um código, ele deve ter um só iframe, com endereço https." }, { "sintoma": "O botão Criar novo está desativado e aparece \"Limite de iframes do plano atingido.\"", "causa": "", "solucao": "O workspace já usa todos os iframes liberados para ele. Exclua um que não usa mais ou peça mais vagas:\n- Se você é o dono da conta: no menu lateral, clique em Agência, clique em Configurar na linha do workspace e confira Iframes na aba Limites e addons. Veja «Liberar um addon no workspace».\n- Se você não é o dono da conta: fale com o responsável pela sua agência." }, { "sintoma": "Não vejo o item no menu, ou aparece \"Nenhum iframe disponível para você neste workspace.\"", "causa": "", "solucao": "O dono ou um administrador precisa marcar o seu nome em Quem pode acessar, no iframe. Depois, recarregue a página." }, { "sintoma": "O cliente recebeu o placeholder com as chaves, como `{{contact_first_name}}`", "causa": "", "solucao": "O código foi digitado direto no campo de mensagem da conversa, onde ele não é trocado. Use-o numa resposta rápida, que entra no campo já preenchida, ou numa mensagem agendada." }, { "sintoma": "A chave No chat está apagada ou volta à posição anterior", "causa": "", "solucao": "Apagada: o seu acesso não inclui Editar campos personalizados; peça a quem administra a sua equipe. Se ela volta sozinha, a mudança não foi salva: recarregue a página e tente de novo." } ], "para_ia": { "perguntas": [ "Usar os campos do sistema e colocar outros sites no menu?", "A página fica em branco ou o login do site não funciona dentro do painel", "Aparece \"Informe uma URL HTTPS válida ou um código iframe com endereço HTTPS.\"", "O botão Criar novo está desativado e aparece \"Limite de iframes do plano atingido.\"", "Não vejo o item no menu, ou aparece \"Nenhum iframe disponível para você neste workspace.\"" ], "resposta": "Use os campos que o painel preenche sozinho nas mensagens, escolha o que aparece na conversa e coloque páginas de outros sites no menu lateral. No menu lateral, clique em Personalização e na aba Campos do sistema. Encontre o campo no grupo dele: Contato, Data e hora, Agendamento, Conversa ou Agente. A coluna Descrição diz o que ele traz. Por exemplo, Primeiro nome é a primeira palavra do nome do contato, e Número de protocolo é o código do atendimento. Na coluna Placeholder, clique no código, por exemplo {{contact_first_name}}, para copiá-lo. O ícone ao lado vira um ✓. Cole o placeholder no texto de uma resposta rápida, de uma mensagem agendada, de um follow up, das instruções do agente de IA ou nas variáveis do template de um disparo. Na hora de usar, o painel troca o código pelo valor. Se o contato não tem o dado, o trecho fica vazio.", "escalar": [] }, "relacionados": [ "contatos", "respostas-rapidas-e-galeria", "liberar-addon-no-workspace" ], "markdown": "---\nslug: campos-do-sistema-e-iframes\ncategoria: Painel e integrações\natualizado: 17/10/2026\ntags: campos do sistema, placeholder, variáveis, primeiro nome, contact_first_name, protocolo, iframe, menu lateral, incorporar site, no chat, personalização\nno_painel: Personalização > Campos do sistema / Iframes\nverificacao: baseado no guia oficial do painel\n---\n\n# Usar os campos do sistema e colocar outros sites no menu\n\nUse os campos que o painel preenche sozinho nas mensagens, escolha o que aparece na conversa e coloque páginas de outros sites no menu lateral.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Qualquer pessoa da equipe abre **Personalização** e copia os placeholders. Para mudar a chave **No chat**, o seu acesso em **Equipe** precisa incluir **Editar campos personalizados**, que os atendentes têm por padrão. A mudança vale para todo o workspace.\n- Só o dono e os administradores do workspace criam, editam e excluem iframes. As outras pessoas veem e abrem só os que foram liberados para elas.\n- A página do iframe precisa ter endereço HTTPS e aceitar ser mostrada dentro de outro site.\n\nEm **Personalização**, duas abas ajudam a adaptar o painel. **Campos do sistema** lista os dados que o painel já conhece e preenche sozinho, como o nome do contato, a data de hoje ou o nome do atendente, com o placeholder de cada um para usar nas mensagens. **Iframes** coloca páginas de outros sites, como um relatório ou um portal, no menu lateral, para a equipe abrir sem sair do painel.\n\n## Usar um campo do sistema numa mensagem\n\n1. No menu lateral, clique em **Personalização** e na aba **Campos do sistema**.\n2. Encontre o campo no grupo dele: **Contato**, **Data e hora**, **Agendamento**, **Conversa** ou **Agente**. A coluna **Descrição** diz o que ele traz. Por exemplo, **Primeiro nome** é a primeira palavra do nome do contato, e **Número de protocolo** é o código do atendimento.\n3. Na coluna **Placeholder**, clique no código, por exemplo `{{contact_first_name}}`, para copiá-lo. O ícone ao lado vira um ✓.\n4. Cole o placeholder no texto de uma resposta rápida, de uma mensagem agendada, de um follow up, das instruções do agente de IA ou nas variáveis do template de um disparo. Na hora de usar, o painel troca o código pelo valor. Se o contato não tem o dado, o trecho fica vazio.\n\nNos disparos, só os dados do contato, a data e a hora e os campos personalizados são preenchidos. Nas automações e no Flow Builder, as variáveis têm outro formato: escolha-as na lista de variáveis da própria tela.\n\nOs campos do sistema não podem ser criados, renomeados nem apagados. Para guardar um dado seu, como a data de nascimento, crie um campo personalizado (veja «Importar, cadastrar e organizar contatos» (artigo `contatos`)). O placeholder dele é `{{cf_` mais o nome técnico do campo e `}}`, por exemplo `{{cf_data_de_nascimento}}`. O nome técnico aparece embaixo do rótulo, na aba **Campos personalizados**.\n\n## Escolher o que aparece na conversa\n\n1. Na aba **Campos do sistema**, ligue ou desligue a chave **No chat** na linha do campo. Com ela ligada, o campo aparece em **Informações do contato**, no painel da conversa (**Mais ações** > **Informações do contato**); desligada, ele some dali para toda a equipe. Vêm ligados **Nome completo**, **Email**, **WhatsApp**, **Telefone** e **Observações**.\n2. Confira numa conversa. Os campos de **Contato** ficam na seção **Dados do contato**: **Nome completo**, **WhatsApp**, **Telefone** e **Email** podem ser editados ali, e **Observações** controla a seção **Anotações**. Os campos dos outros grupos aparecem numa seção com o nome do grupo, só para leitura, com o valor da conversa aberta.\n\n## Colocar uma página no menu\n\n1. No menu lateral, clique em **Personalização** e na aba **Iframes**.\n2. Clique em **Criar novo**.\n3. Em **Nome**, escreva como a equipe vai ver o item no menu, por exemplo *Relatório de vendas*.\n4. Em **URL ou código iframe**, cole o endereço da página, começando com https://, ou o código de incorporação que o site oferece (em geral, na opção *Incorporar* ou *Embed*). O painel guarda só o endereço.\n5. Em **Ícone no menu**, escolha um dos seis ícones.\n6. Em **Quem pode acessar**, marque as pessoas que vão ver o item; use **Buscar usuários** se a lista for grande. O dono e os administradores sempre veem. Sem ninguém marcado, fica **Somente dono e administradores**.\n7. Confira a **Prévia da sidebar** e clique em **Salvar**.\n\nO item entra no fim do menu lateral, num grupo chamado **Iframes**. Para trocar o nome do grupo, clique em **Editar título do menu**. Os itens ficam na ordem em que foram criados; não há como reordenar.\n\n> **Atenção:** Quem tem acesso ao item vê o endereço da página, no botão **Abrir em nova aba**. Se o link abre dados sem pedir login, como um relatório compartilhado por link, trate-o como senha e libere o item só para quem pode ver esses dados.\n\n## Abrir, editar e excluir\n\n1. Clique no item no menu lateral ou em **Abrir**, no cartão dele. A página aparece dentro do painel. Se o site pede login, cada pessoa entra com a própria conta nele.\n2. Se a página não carregar, clique em **Abrir em nova aba**, no topo.\n3. Para mudar nome, endereço, ícone ou acesso, clique no lápis (**Editar iframe**) no cartão. Para tirar do menu de todos, clique na lixeira (**Excluir iframe**) e confirme em **Excluir**.\n\n## Não funcionou?\n\n- **A página fica em branco ou o login do site não funciona dentro do painel**\n Muitos sites não se deixam mostrar dentro de outra página, ou bloqueiam o login ali. É uma trava do próprio site, e o painel não consegue contornar. Clique em **Abrir em nova aba**. Se o site tem a opção de incorporar ou de compartilhar uma página, use o endereço ou o código que ela gera.\n- **Aparece \"Informe uma URL HTTPS válida ou um código iframe com endereço HTTPS.\"**\n O endereço precisa começar com https:// e não pode trazer usuário e senha. Se colou um código, ele deve ter um só iframe, com endereço https.\n- **O botão Criar novo está desativado e aparece \"Limite de iframes do plano atingido.\"**\n O workspace já usa todos os iframes liberados para ele. Exclua um que não usa mais ou peça mais vagas:\n - Se você é o dono da conta: no menu lateral, clique em **Agência**, clique em **Configurar** na linha do workspace e confira **Iframes** na aba **Limites e addons**. Veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n - Se você não é o dono da conta: fale com o responsável pela sua agência.\n- **Não vejo o item no menu, ou aparece \"Nenhum iframe disponível para você neste workspace.\"**\n O dono ou um administrador precisa marcar o seu nome em **Quem pode acessar**, no iframe. Depois, recarregue a página.\n- **O cliente recebeu o placeholder com as chaves, como `{{contact_first_name}}`**\n O código foi digitado direto no campo de mensagem da conversa, onde ele não é trocado. Use-o numa resposta rápida, que entra no campo já preenchida, ou numa mensagem agendada.\n- **A chave No chat está apagada ou volta à posição anterior**\n Apagada: o seu acesso não inclui **Editar campos personalizados**; peça a quem administra a sua equipe. Se ela volta sozinha, a mudança não foi salva: recarregue a página e tente de novo.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Usar os campos do sistema e colocar outros sites no menu?\n- A página fica em branco ou o login do site não funciona dentro do painel\n- Aparece \"Informe uma URL HTTPS válida ou um código iframe com endereço HTTPS.\"\n- O botão Criar novo está desativado e aparece \"Limite de iframes do plano atingido.\"\n- Não vejo o item no menu, ou aparece \"Nenhum iframe disponível para você neste workspace.\"\n\nResposta curta: Use os campos que o painel preenche sozinho nas mensagens, escolha o que aparece na conversa e coloque páginas de outros sites no menu lateral. No menu lateral, clique em Personalização e na aba Campos do sistema. Encontre o campo no grupo dele: Contato, Data e hora, Agendamento, Conversa ou Agente. A coluna Descrição diz o que ele traz. Por exemplo, Primeiro nome é a primeira palavra do nome do contato, e Número de protocolo é o código do atendimento. Na coluna Placeholder, clique no código, por exemplo {{contact_first_name}}, para copiá-lo. O ícone ao lado vira um ✓. Cole o placeholder no texto de uma resposta rápida, de uma mensagem agendada, de um follow up, das instruções do agente de IA ou nas variáveis do template de um disparo. Na hora de usar, o painel troca o código pelo valor. Se o contato não tem o dado, o trecho fica vazio.\n\nVeja também: «Importar, cadastrar e organizar contatos» (`contatos`); «Usar respostas rápidas e a galeria de mídias» (`respostas-rapidas-e-galeria`); «Liberar um addon no workspace» (`liberar-addon-no-workspace`)\n" }, { "slug": "whatsapp-api-oficial", "categoria": "Canais e conexões", "titulo": "Conectar o WhatsApp pela API Oficial Meta ou pela coexistência", "resumo": "Passo a passo para conectar um número à API Oficial Meta ou pela coexistência, que mantém o app WhatsApp Business no celular, para usar templates e campanhas.", "tags": [ "api oficial", "cloud api", "waba", "coexistência", "coex", "meta", "business manager", "conectar número", "embedded signup", "verificação", "templates" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Conexões", "WhatsApp Business", "API Oficial / Coexistência" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O cartão API Oficial Meta ou Coexistência (COEX) mostra \"não incluído no seu plano\"", "causa": "", "solucao": "A API oficial não está incluída no plano, e o addon ainda não foi liberado para este workspace.\n- Se você é o dono da conta: no menu lateral, clique em Agência. Na linha do workspace, clique em Configurar e abra a aba Limites e addons. Em Canais e addons, encontre WhatsApp Cloud API, clique em Liberar +1 addon neste workspace e depois em Salvar alterações. Se aparecer Nenhum addon contratado para este recurso ou Todos os extras estão em outros workspaces, veja «Liberar um addon no workspace».\n- Se você não é o dono da conta: fale com o responsável pela sua agência para liberar." }, { "sintoma": "O botão Nova conexão está desativado e aparece \"limite atingido\"", "causa": "", "solucao": "O workspace já usa todas as conexões da API oficial liberadas para ele. API Oficial Meta e Coexistência (COEX) contam juntas nesse limite. O dono da conta pode liberar mais uma do mesmo jeito, no cartão WhatsApp Cloud API." }, { "sintoma": "Aparece \"Configuração Meta pendente.\"", "causa": "", "solucao": "A ligação do painel com a Meta ainda não foi configurada. Fale com o responsável pela sua agência." }, { "sintoma": "Apareceu \"Erro ao vincular WABA: você não tem permissão para esta ação.\"", "causa": "", "solucao": "Falta a permissão Gerenciar WhatsApp Business no seu usuário. Peça a quem administra a sua equipe para ativá-la e conecte de novo." }, { "sintoma": "A janela da Meta não abriu, fechou antes do fim ou mostrou \"Autorização negada pelo usuário\"", "causa": "", "solucao": "Clique em Conectar via Facebook de novo e vá até o fim das telas da Meta, aceitando as permissões pedidas. Se nenhuma janela abrir, permita janelas pop-up para o painel no navegador. Vale o mesmo para o aviso \"Meta não retornou…\"." }, { "sintoma": "Não sei o PIN, ou o número aparece com \"Concluir registro do número\"", "causa": "", "solucao": "Se você não configurou um PIN ou usou o padrão da plataforma, na lista clique em Usar PIN padrão (000000) e depois em Concluir registro. Se existe outro PIN e ninguém o sabe, redefina-o no WhatsApp Manager da Meta, na verificação em duas etapas do número. Depois:\n- Se você ainda está na tela do PIN, clique em Reiniciar conexão e refaça com o PIN novo.\n- Se o número já está na lista, digite o PIN em PIN de 6 dígitos e clique em Concluir registro. Depois de muitas tentativas erradas, espere 5 minutos." }, { "sintoma": "O número aparece como Conectando, Pendente, Desconectado ou Erro", "causa": "", "solucao": "Clique no ícone de setas (Atualizar status) na linha do número: o painel refaz a ligação com a Meta. É assim também que você reconecta depois de usar Desconectar. Se continuar com Erro, fale com o responsável pela sua agência antes de remover a conexão. A remoção não pode ser desfeita: as conversas antigas continuam em Conversas, mas as mensagens novas chegam em conversas novas; o número sai dos agentes de IA; os fluxos que valiam só para ele passam a valer para todos os canais; e os dados de anúncios dele somem do Dashboard." } ], "para_ia": { "perguntas": [ "Conectar o WhatsApp pela API Oficial Meta ou pela coexistência?", "O cartão API Oficial Meta ou Coexistência (COEX) mostra \"não incluído no seu plano\"", "O botão Nova conexão está desativado e aparece \"limite atingido\"", "Aparece \"Configuração Meta pendente.\"", "Apareceu \"Erro ao vincular WABA: você não tem permissão para esta ação.\"" ], "resposta": "Passo a passo para conectar um número à API Oficial Meta ou pela coexistência, que mantém o app WhatsApp Business no celular, para usar templates e campanhas. No menu lateral, clique em Conexões e depois no cartão WhatsApp Business. Na tela Conectar WhatsApp, compare os cartões API Oficial Meta (Recomendado), Coexistência (COEX) e QR Code. Em cada um, O que entrega e Pré-requisitos resumem o tipo. No cartão API Oficial Meta, clique em Conectar via API. Abre a tela WhatsApp — API Oficial (Cloud API). Clique em Nova conexão.", "escalar": [ "Falha na autorização da Meta", "Número bloqueado ou restrito pela Meta" ] }, "relacionados": [ "conectar-whatsapp", "templates-whatsapp", "janela-24-horas", "disparo-em-massa" ], "markdown": "---\nslug: whatsapp-api-oficial\ncategoria: Canais e conexões\natualizado: 17/10/2026\ntags: api oficial, cloud api, waba, coexistência, coex, meta, business manager, conectar número, embedded signup, verificação, templates\nno_painel: Conexões > WhatsApp Business > API Oficial / Coexistência\nverificacao: baseado no guia oficial do painel\n---\n\n# Conectar o WhatsApp pela API Oficial Meta ou pela coexistência\n\nPasso a passo para conectar um número à API Oficial Meta ou pela coexistência, que mantém o app WhatsApp Business no celular, para usar templates e campanhas.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Você precisa ter acesso ao menu **Conexões**. Se ele não aparece para você, peça a quem administra a sua equipe.\n- Para conectar, desconectar ou remover um número, você também precisa da permissão **Gerenciar WhatsApp Business**. O dono e os admins do workspace já têm.\n- Tenha o Business Manager da empresa no Facebook e uma conta do Facebook com acesso a ele.\n- Para a **API Oficial Meta**: um número só para isso, que não esteja em uso em nenhum app do WhatsApp ou do WhatsApp Business.\n- Para a **Coexistência (COEX)**: o celular com o app WhatsApp Business atualizado (Android ou iPhone), no número que você vai conectar.\n- A API oficial precisa estar liberada no seu workspace. Se o cartão aparecer bloqueado, veja o primeiro item de *Se algo der errado*.\n\nPela API oficial da Meta, as mensagens do seu número chegam em **Conversas**. É o caminho indicado para campanhas e muito volume: você usa templates aprovados pela Meta e faz disparos em massa, o que não se recomenda no QR Code.\n\nHá dois jeitos de ligar o número à API oficial: pela **API Oficial Meta** ou pela **Coexistência (COEX)**, em que você continua usando o app WhatsApp Business no celular e as mensagens aparecem aqui e no app. Se prefere conectar lendo um QR Code, veja «Conectar um número de WhatsApp pelo QR Code» (artigo `whatsapp-qr-code`).\n\n> **Atenção:** Na **API Oficial Meta**, o número sai do app do WhatsApp no celular de vez. Para continuar atendendo pelo celular, escolha **Coexistência (COEX)**.\n\n## Escolher o tipo de conexão\n\n1. No menu lateral, clique em **Conexões** e depois no cartão **WhatsApp Business**.\n2. Na tela **Conectar WhatsApp**, compare os cartões **API Oficial Meta** (**Recomendado**), **Coexistência (COEX)** e **QR Code**. Em cada um, **O que entrega** e **Pré-requisitos** resumem o tipo.\n\n## Conectar pela API Oficial Meta\n\n1. No cartão **API Oficial Meta**, clique em **Conectar via API**. Abre a tela **WhatsApp — API Oficial (Cloud API)**.\n2. Clique em **Nova conexão**.\n3. Confira a lista **Antes de conectar, confirme** e clique em **Conectar via Facebook**.\n4. Na janela da Meta, entre com o Facebook e siga as telas até escolher a empresa, a conta do WhatsApp Business e o número.\n5. De volta ao painel, em **Proteja seu número do WhatsApp**, responda **Este número já tem um PIN?**:\n - **Não tenho PIN — usar padrão**: o painel usa `000000` (seis zeros) ao concluir, sem precisar digitar. Esse será o PIN de verificação em duas etapas; você pode alterá-lo depois no WhatsApp Manager da Meta.\n - **Já tenho PIN**: digite o PIN atual em **Informe o PIN atual do WhatsApp**.\n - **Não sei ou esqueci meu PIN**: veja *Se algo der errado*.\n O PIN não é a senha do Facebook nem o código que chega por SMS.\n6. Clique em **Concluir conexão** e aguarde **Conectado com sucesso!**. O painel volta sozinho para a lista, e o número aparece como **Conectado**.\n\n## Conectar pela Coexistência\n\n1. No cartão **Coexistência (COEX)**, clique em **Conectar via Coexistência**. Abre a tela **WhatsApp — Coexistência**.\n2. Clique em **Nova conexão**, confira **O que muda na Coexistência** e clique em **Conectar via Facebook**.\n3. Na janela da Meta, entre com o Facebook e siga as telas, com o celular do app WhatsApp Business por perto. Aqui não tem PIN.\n4. Aguarde **Conectado em Coexistência!**. O painel volta para a lista, e o número aparece como **Conectado**.\n\n> **Bom saber:** Na Coexistência, o que você manda pelo app também aparece no painel. Depois da conexão, a Meta envia o histórico de até 180 dias do app, só com textos e localizações.\n\n## Depois de conectar\n\n1. Confira o status na linha do número. Se aparecer **Conectando** ou **Pendente**, clique no ícone de setas (**Atualizar status**).\n2. Para campanhas e para retomar conversas, crie templates: na linha do número, clique em **Templates**. Veja «Criar e aprovar templates do WhatsApp oficial» (artigo `templates-whatsapp`).\n3. Atenda em **Conversas**. Mensagem livre só vale até 24 horas depois da última mensagem do cliente: veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (artigo `janela-24-horas`).\n\n## Não funcionou?\n\n- **O cartão API Oficial Meta ou Coexistência (COEX) mostra \"não incluído no seu plano\"**\n A API oficial não está incluída no plano, e o addon ainda não foi liberado para este workspace.\n - Se você é o dono da conta: no menu lateral, clique em **Agência**. Na linha do workspace, clique em **Configurar** e abra a aba **Limites e addons**. Em **Canais e addons**, encontre **WhatsApp Cloud API**, clique em **Liberar +1 addon neste workspace** e depois em **Salvar alterações**. Se aparecer **Nenhum addon contratado para este recurso** ou **Todos os extras estão em outros workspaces**, veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n - Se você não é o dono da conta: fale com o responsável pela sua agência para liberar.\n- **O botão Nova conexão está desativado e aparece \"limite atingido\"**\n O workspace já usa todas as conexões da API oficial liberadas para ele. **API Oficial Meta** e **Coexistência (COEX)** contam juntas nesse limite. O dono da conta pode liberar mais uma do mesmo jeito, no cartão **WhatsApp Cloud API**.\n- **Aparece \"Configuração Meta pendente.\"**\n A ligação do painel com a Meta ainda não foi configurada. Fale com o responsável pela sua agência.\n- **Apareceu \"Erro ao vincular WABA: você não tem permissão para esta ação.\"**\n Falta a permissão **Gerenciar WhatsApp Business** no seu usuário. Peça a quem administra a sua equipe para ativá-la e conecte de novo.\n- **A janela da Meta não abriu, fechou antes do fim ou mostrou \"Autorização negada pelo usuário\"**\n Clique em **Conectar via Facebook** de novo e vá até o fim das telas da Meta, aceitando as permissões pedidas. Se nenhuma janela abrir, permita janelas pop-up para o painel no navegador. Vale o mesmo para o aviso \"Meta não retornou…\".\n- **Não sei o PIN, ou o número aparece com \"Concluir registro do número\"**\n Se você não configurou um PIN ou usou o padrão da plataforma, na lista clique em **Usar PIN padrão (000000)** e depois em **Concluir registro**. Se existe outro PIN e ninguém o sabe, redefina-o no WhatsApp Manager da Meta, na verificação em duas etapas do número. Depois:\n - Se você ainda está na tela do PIN, clique em **Reiniciar conexão** e refaça com o PIN novo.\n - Se o número já está na lista, digite o PIN em **PIN de 6 dígitos** e clique em **Concluir registro**. Depois de muitas tentativas erradas, espere 5 minutos.\n- **O número aparece como Conectando, Pendente, Desconectado ou Erro**\n Clique no ícone de setas (**Atualizar status**) na linha do número: o painel refaz a ligação com a Meta. É assim também que você reconecta depois de usar **Desconectar**. Se continuar com **Erro**, fale com o responsável pela sua agência antes de remover a conexão. A remoção não pode ser desfeita: as conversas antigas continuam em **Conversas**, mas as mensagens novas chegam em conversas novas; o número sai dos agentes de IA; os fluxos que valiam só para ele passam a valer para todos os canais; e os dados de anúncios dele somem do **Dashboard**.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Conectar o WhatsApp pela API Oficial Meta ou pela coexistência?\n- O cartão API Oficial Meta ou Coexistência (COEX) mostra \"não incluído no seu plano\"\n- O botão Nova conexão está desativado e aparece \"limite atingido\"\n- Aparece \"Configuração Meta pendente.\"\n- Apareceu \"Erro ao vincular WABA: você não tem permissão para esta ação.\"\n\nResposta curta: Passo a passo para conectar um número à API Oficial Meta ou pela coexistência, que mantém o app WhatsApp Business no celular, para usar templates e campanhas. No menu lateral, clique em Conexões e depois no cartão WhatsApp Business. Na tela Conectar WhatsApp, compare os cartões API Oficial Meta (Recomendado), Coexistência (COEX) e QR Code. Em cada um, O que entrega e Pré-requisitos resumem o tipo. No cartão API Oficial Meta, clique em Conectar via API. Abre a tela WhatsApp — API Oficial (Cloud API). Clique em Nova conexão.\n\nEscalar para um humano quando:\n- Falha na autorização da Meta\n- Número bloqueado ou restrito pela Meta\n\nVeja também: «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (`conectar-whatsapp`); «Criar e aprovar templates do WhatsApp oficial» (`templates-whatsapp`); «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (`janela-24-horas`); «Criar um disparo em massa e acompanhar o envio» (`disparo-em-massa`)\n" }, { "slug": "whatsapp-qr-code", "categoria": "Canais e conexões", "titulo": "Conectar um número de WhatsApp pelo QR Code", "resumo": "Passo a passo para ligar o WhatsApp do celular ao painel lendo um QR Code ou digitando um código de pareamento.", "tags": [ "qr code", "pareamento", "código de pareamento", "whatsapp celular", "reconectar", "desconectado", "whatsapp web", "conexão caiu" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Conexões", "WhatsApp Business", "QR Code" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O WhatsApp aparece como \"fora do plano\" ou o cartão QR Code aparece bloqueado", "causa": "", "solucao": "Isso acontece quando a conexão por QR Code não está incluída no plano e o adicional (addon) ainda não foi liberado para este workspace.\n- Se você é o dono da conta: no menu lateral, clique em Agência. Na linha do workspace, clique em Configurar e abra a aba Limites e addons. Em Canais e addons, encontre WhatsApp QR Code, clique em Liberar +1 addon neste workspace e depois em Salvar alterações. Se aparecer Nenhum addon contratado para este recurso ou Todos os extras estão em outros workspaces, veja «Liberar um addon no workspace».\n- Se você não é o dono da conta: fale com o responsável pela sua agência para liberar." }, { "sintoma": "O botão Nova conexão mostra \"limite atingido\"", "causa": "", "solucao": "Este workspace já usa todas as conexões por QR Code liberadas para ele. O dono da conta pode liberar mais uma do mesmo jeito, em Liberar +1 addon neste workspace." }, { "sintoma": "O QR Code não lê ou expirou", "causa": "", "solucao": "Clique em Gerar novo QR e aponte a câmera logo em seguida." }, { "sintoma": "Li o QR Code, mas a tela continua esperando", "causa": "", "solucao": "Clique em Atualizar status. Se aparecer QR escaneado. Sincronizando WhatsApp…, é só aguardar mais um pouco." }, { "sintoma": "O código de pareamento não chegou", "causa": "", "solucao": "Clique em Gerar novo código e digite o novo código no celular." }, { "sintoma": "O número desconectou sozinho", "causa": "", "solucao": "Na lista de conexões, clique em Conectar na linha do número e leia o QR Code de novo. As conversas não se perdem. Isso costuma acontecer quando o celular fica muitos dias sem internet ou quando alguém remove o aparelho em Dispositivos conectados." } ], "para_ia": { "perguntas": [ "Conectar um número de WhatsApp pelo QR Code?", "O WhatsApp aparece como \"fora do plano\" ou o cartão QR Code aparece bloqueado", "O botão Nova conexão mostra \"limite atingido\"", "O QR Code não lê ou expirou", "Li o QR Code, mas a tela continua esperando" ], "resposta": "Passo a passo para ligar o WhatsApp do celular ao painel lendo um QR Code ou digitando um código de pareamento. No menu lateral, clique em Conexões e depois no cartão WhatsApp Business. No cartão QR Code, clique em Conectar via QR. Se aparecer a tela Escolha o tipo de conexão QR, escolha WhatsApp QR Pro, a opção recomendada, e clique em Escolher. Clique em Nova conexão.", "escalar": [ "Número bloqueado ou banido" ] }, "relacionados": [ "conectar-whatsapp", "ia-nao-responde", "outros-problemas-comuns" ], "markdown": "---\nslug: whatsapp-qr-code\ncategoria: Canais e conexões\natualizado: 17/10/2026\ntags: qr code, pareamento, código de pareamento, whatsapp celular, reconectar, desconectado, whatsapp web, conexão caiu\nno_painel: Conexões > WhatsApp Business > QR Code\nverificacao: baseado no guia oficial do painel\n---\n\n# Conectar um número de WhatsApp pelo QR Code\n\nPasso a passo para ligar o WhatsApp do celular ao painel lendo um QR Code ou digitando um código de pareamento.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Tenha por perto o celular com o WhatsApp do número que você vai conectar, desbloqueado e com internet.\n- Você precisa ter acesso ao menu **Conexões**. Se ele não aparece para você, peça a quem administra a sua equipe.\n- A conexão por QR Code precisa estar liberada no seu workspace. Se o cartão **QR Code** aparecer bloqueado, veja o primeiro item de *Se algo der errado*.\n\nAo conectar pelo QR Code, as mensagens desse número passam a chegar em **Conversas** e você responde por aqui. Leva poucos minutos, e o WhatsApp continua funcionando normalmente no celular.\n\n> **Atenção:** A conexão por QR Code é indicada para o atendimento do dia a dia e para pouco volume de mensagens. Disparos em massa por QR podem levar o WhatsApp a bloquear o número. Para campanhas, use a **API Oficial Meta**: veja «Conectar o WhatsApp pela API Oficial Meta ou pela coexistência» (artigo `whatsapp-api-oficial`).\n\n1. No menu lateral, clique em **Conexões** e depois no cartão **WhatsApp Business**.\n2. No cartão **QR Code**, clique em **Conectar via QR**.\n3. Se aparecer a tela **Escolha o tipo de conexão QR**, escolha **WhatsApp QR Pro**, a opção recomendada, e clique em **Escolher**.\n4. Clique em **Nova conexão**.\n5. Em **Nome da conexão**, escreva um nome que a sua equipe reconheça, por exemplo *Atendimento Comercial*. Só a equipe vê esse nome.\n6. Em **Como conectar**, escolha uma opção:\n - **Ler QR code**: o jeito mais comum. Você aponta a câmera do celular para a tela do computador.\n - **Código de pareamento**: para quando não dá para apontar a câmera, por exemplo se você está usando o painel no próprio celular. Preencha o **Número do WhatsApp** com DDI e DDD, só números (ex.: 5511999999999).\n7. Clique em **Criar e gerar QR Code** (ou em **Criar e gerar código**).\n8. No celular, abra o WhatsApp e entre em **Dispositivos conectados** (em algumas versões, **Aparelhos conectados**). No Android, fica no menu **⋮**; no iPhone, em **Configurações**.\n9. Toque em **Conectar um dispositivo**. Depois:\n - se escolheu **Ler QR code**, aponte a câmera para o QR Code que está na tela;\n - se escolheu **Código de pareamento**, toque em **Conectar com número de telefone** e digite o código que aparece no painel.\n10. Aguarde a mensagem **Conectado com sucesso!**. O painel volta sozinho para a lista de conexões, e o número aparece como **Conectado**.\n\n> **Dica:** O QR Code vale por pouco tempo. Se você demorar, clique em **Gerar novo QR** e leia o novo código logo em seguida.\n\n## Não funcionou?\n\n- **O WhatsApp aparece como \"fora do plano\" ou o cartão QR Code aparece bloqueado**\n Isso acontece quando a conexão por QR Code não está incluída no plano e o adicional (addon) ainda não foi liberado para este workspace.\n - Se você é o dono da conta: no menu lateral, clique em **Agência**. Na linha do workspace, clique em **Configurar** e abra a aba **Limites e addons**. Em **Canais e addons**, encontre **WhatsApp QR Code**, clique em **Liberar +1 addon neste workspace** e depois em **Salvar alterações**. Se aparecer **Nenhum addon contratado para este recurso** ou **Todos os extras estão em outros workspaces**, veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n - Se você não é o dono da conta: fale com o responsável pela sua agência para liberar.\n- **O botão Nova conexão mostra \"limite atingido\"**\n Este workspace já usa todas as conexões por QR Code liberadas para ele. O dono da conta pode liberar mais uma do mesmo jeito, em **Liberar +1 addon neste workspace**.\n- **O QR Code não lê ou expirou**\n Clique em **Gerar novo QR** e aponte a câmera logo em seguida.\n- **Li o QR Code, mas a tela continua esperando**\n Clique em **Atualizar status**. Se aparecer **QR escaneado. Sincronizando WhatsApp…**, é só aguardar mais um pouco.\n- **O código de pareamento não chegou**\n Clique em **Gerar novo código** e digite o novo código no celular.\n- **O número desconectou sozinho**\n Na lista de conexões, clique em **Conectar** na linha do número e leia o QR Code de novo. As conversas não se perdem. Isso costuma acontecer quando o celular fica muitos dias sem internet ou quando alguém remove o aparelho em **Dispositivos conectados**.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Conectar um número de WhatsApp pelo QR Code?\n- O WhatsApp aparece como \"fora do plano\" ou o cartão QR Code aparece bloqueado\n- O botão Nova conexão mostra \"limite atingido\"\n- O QR Code não lê ou expirou\n- Li o QR Code, mas a tela continua esperando\n\nResposta curta: Passo a passo para ligar o WhatsApp do celular ao painel lendo um QR Code ou digitando um código de pareamento. No menu lateral, clique em Conexões e depois no cartão WhatsApp Business. No cartão QR Code, clique em Conectar via QR. Se aparecer a tela Escolha o tipo de conexão QR, escolha WhatsApp QR Pro, a opção recomendada, e clique em Escolher. Clique em Nova conexão.\n\nEscalar para um humano quando:\n- Número bloqueado ou banido\n\nVeja também: «Conectar o WhatsApp: API Oficial, Coexistência ou QR Code» (`conectar-whatsapp`); «A IA não responde: diagnóstico passo a passo» (`ia-nao-responde`); «Outros problemas comuns: transferência, WhatsApp, automação, dados e follow-up» (`outros-problemas-comuns`)\n" }, { "slug": "conectar-o-telegram", "categoria": "Canais e conexões", "titulo": "Conectar um bot do Telegram", "resumo": "Conecte um bot do Telegram criado no @BotFather para receber e responder em Conversas as mensagens privadas enviadas a ele.", "tags": [ "telegram", "bot", "botfather", "token do bot", "mensagens privadas", "conectar telegram" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Conexões", "Telegram" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O cartão Telegram mostra \"fora do plano\" ou \"Telegram não incluído no seu plano\"", "causa": "", "solucao": "O canal não está incluído no plano, e o addon ainda não foi liberado para este workspace.\n- Se você é o dono da conta: no menu lateral, clique em Agência. Na linha do workspace, clique em Configurar e abra a aba Limites e addons. Em Canais e addons, encontre Telegram, clique em Liberar +1 addon neste workspace e depois em Salvar alterações. Se aparecer Nenhum addon contratado para este recurso ou Todos os extras estão em outros workspaces, veja «Liberar um addon no workspace».\n- Se você não é o dono da conta: fale com o responsável pela sua agência para liberar." }, { "sintoma": "O botão Novo bot está desativado e aparece \"limite atingido\"", "causa": "", "solucao": "O workspace já usa todos os bots liberados. Remova um que não usa mais (veja o que muda em *Testar e remover*), ou o dono da conta libera mais um do mesmo jeito, no cartão Telegram." }, { "sintoma": "O botão Conectar bot não fica ativo, ou aparece \"token do bot inválido\"", "causa": "", "solucao": "Confira:\n- se o campo mostra \"Formato inválido\": o token está incompleto. Copie de novo a linha inteira que o @BotFather enviou;\n- se você preencheu Nome da conexão: use pelo menos 2 caracteres, ou deixe em branco;\n- se aparece \"token do bot inválido — confira o token gerado pelo @BotFather\": o token está errado ou foi trocado. No @BotFather, envie /mybots, escolha o bot e copie o token atual;\n- se aparece \"não foi possível falar com o Telegram agora\": tente de novo em alguns minutos." }, { "sintoma": "Aparece \"este bot já está conectado\"", "causa": "", "solucao": "Um bot só pode estar conectado a um workspace. Se ele já está na lista, use essa conexão. Se está em outro workspace, remova-o lá primeiro, ou crie outro bot no @BotFather." }, { "sintoma": "O bot aparece como Desconectado, com \"Usuário bloqueou o bot\", e as respostas falham", "causa": "", "solucao": "Isso acontece quando alguém bloqueia o bot no Telegram. Enquanto o bot estiver Desconectado, as mensagens continuam chegando, mas as respostas de todas as conversas dele mostram Falha ao enviar. Clique no ícone de setas (Testar conexão) na linha do bot: se aparecer \"Webhook ativo\", ele volta para Conectado. Depois, envie de novo as respostas que falharam." }, { "sintoma": "O teste mostra \"Webhook não está registrado neste bot — reconecte\"", "causa": "", "solucao": "O Telegram deixou de entregar as mensagens ao painel, em geral porque o token foi configurado em outro sistema, e o bot fica com o status Erro. Pare de usar o token no outro sistema. Depois, remova o bot na lixeira e conecte de novo em Novo bot, com o mesmo token. Por fim, marque a conexão nova no agente de IA e confira os fluxos que eram só do bot antigo." }, { "sintoma": "As mensagens de um grupo não chegam", "causa": "", "solucao": "O painel só recebe as conversas privadas com o bot. Mensagens em grupos e canais do Telegram, e as enviadas por outros bots, ficam de fora. Peça para a pessoa escrever direto para o bot." } ], "para_ia": { "perguntas": [ "Conectar um bot do Telegram?", "O cartão Telegram mostra \"fora do plano\" ou \"Telegram não incluído no seu plano\"", "O botão Novo bot está desativado e aparece \"limite atingido\"", "O botão Conectar bot não fica ativo, ou aparece \"token do bot inválido\"", "Aparece \"este bot já está conectado\"" ], "resposta": "Conecte um bot do Telegram criado no @BotFather para receber e responder em Conversas as mensagens privadas enviadas a ele. No menu lateral, clique em Conexões e depois no cartão Telegram. Clique em Novo bot. Abre o formulário Nova conexão do Telegram. Em Token do bot, cole o token que o @BotFather enviou. O campo esconde o que você digita, e o painel guarda o token criptografado. Em Nome da conexão, escreva um nome que a sua equipe reconheça, por exemplo Atendimento Telegram. É opcional: em branco, o painel usa o @ do bot.", "escalar": [] }, "relacionados": [ "criar-agente", "atender-conversa" ], "markdown": "---\nslug: conectar-o-telegram\ncategoria: Canais e conexões\natualizado: 17/10/2026\ntags: telegram, bot, botfather, token do bot, mensagens privadas, conectar telegram\nno_painel: Conexões > Telegram\nverificacao: baseado no guia oficial do painel\n---\n\n# Conectar um bot do Telegram\n\nConecte um bot do Telegram criado no @BotFather para receber e responder em Conversas as mensagens privadas enviadas a ele.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Você precisa ter acesso ao menu **Conexões**. Se ele não aparece para você, peça a quem administra a sua equipe.\n- Tenha o token do bot. Para criar o bot, abra o @BotFather no Telegram, envie `/newbot`, responda o nome e o nome de usuário do bot e copie o token que ele devolve, parecido com *123456789:AAH…*.\n- O canal precisa estar liberado no seu workspace. Se o cartão **Telegram** aparecer bloqueado, veja o primeiro item de *Se algo der errado*.\n\nAo conectar um bot do Telegram, as mensagens que as pessoas mandam para ele chegam em **Conversas**, e você responde por aqui, como nos outros canais. Você cria o bot no próprio Telegram, com o @BotFather, e o painel só precisa do token dele.\n\nSó entram as conversas privadas com o bot: mensagens em grupos e canais do Telegram, e mensagens de outros bots, não chegam ao painel. O Telegram não informa o telefone da pessoa, então o contato chega com o nome do perfil dela.\n\n> **Atenção:** Use o bot só com o painel. O Telegram entrega as mensagens de um bot a um único destino: se o mesmo token for configurado em outro sistema, o painel pode parar de receber as mensagens.\n\n## Conectar o bot\n\n1. No menu lateral, clique em **Conexões** e depois no cartão **Telegram**.\n2. Clique em **Novo bot**. Abre o formulário **Nova conexão do Telegram**.\n3. Em **Token do bot**, cole o token que o @BotFather enviou. O campo esconde o que você digita, e o painel guarda o token criptografado.\n4. Em **Nome da conexão**, escreva um nome que a sua equipe reconheça, por exemplo *Atendimento Telegram*. É opcional: em branco, o painel usa o @ do bot.\n5. Clique em **Conectar bot**. O painel confere o token com o Telegram e configura sozinho o recebimento das mensagens.\n6. Confira o bot na lista: ele aparece como **Conectado**, com o @ dele abaixo do nome. Divulgue esse @ para as pessoas acharem o bot.\n7. Para testar, abra o bot no seu Telegram, inicie a conversa e mande uma mensagem. Ela chega em **Conversas** em alguns segundos. A primeira costuma ser */start*, que o Telegram envia quando alguém inicia o bot.\n\n## Responder pelo Telegram\n\n1. Em **Conversas**, abra a conversa e responda normalmente, com texto, foto, vídeo, áudio ou documento.\n2. Para um agente de IA atender, abra o agente em **Agentes IA**, marque o bot em **Canais onde o agente atua**, ligue **Usar como agente principal de atendimento nos canais selecionados** e clique em **Salvar**. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\nDo Telegram, chegam textos, fotos, vídeos, GIFs, áudios, documentos, figurinhas, localizações e contatos. Se a pessoa editar uma mensagem, o texto muda na conversa. Nas suas respostas, textos com mais de 4.096 caracteres vão em mais de uma mensagem, e legendas de arquivos com mais de 1.024 caracteres são cortadas.\n\n## Testar e remover\n\n1. Para conferir se o bot está recebendo, clique no ícone de setas (**Testar conexão**) na linha dele. Se aparecer \"Webhook ativo\", está tudo certo. O webhook é o endereço por onde o Telegram entrega as mensagens ao painel; um \"último erro registrado\" nessa mensagem é só histórico.\n2. Para desligar o bot do painel, clique na lixeira (**Remover**) e confirme em **Remover**. O bot para de receber mensagens aqui, e não dá para desfazer.\n\nAo remover, as conversas antigas continuam em **Conversas**. O bot sai dos agentes de IA que o atendiam, os fluxos que valiam só para ele passam a valer para todos os canais, e os follow-ups ativos dele somem. Se você conectar o mesmo bot de novo, as mensagens novas chegam em conversas novas, com contatos novos.\n\n## Não funcionou?\n\n- **O cartão Telegram mostra \"fora do plano\" ou \"Telegram não incluído no seu plano\"**\n O canal não está incluído no plano, e o addon ainda não foi liberado para este workspace.\n - Se você é o dono da conta: no menu lateral, clique em **Agência**. Na linha do workspace, clique em **Configurar** e abra a aba **Limites e addons**. Em **Canais e addons**, encontre **Telegram**, clique em **Liberar +1 addon neste workspace** e depois em **Salvar alterações**. Se aparecer **Nenhum addon contratado para este recurso** ou **Todos os extras estão em outros workspaces**, veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n - Se você não é o dono da conta: fale com o responsável pela sua agência para liberar.\n- **O botão Novo bot está desativado e aparece \"limite atingido\"**\n O workspace já usa todos os bots liberados. Remova um que não usa mais (veja o que muda em *Testar e remover*), ou o dono da conta libera mais um do mesmo jeito, no cartão **Telegram**.\n- **O botão Conectar bot não fica ativo, ou aparece \"token do bot inválido\"**\n Confira:\n - se o campo mostra \"Formato inválido\": o token está incompleto. Copie de novo a linha inteira que o @BotFather enviou;\n - se você preencheu **Nome da conexão**: use pelo menos 2 caracteres, ou deixe em branco;\n - se aparece \"token do bot inválido — confira o token gerado pelo @BotFather\": o token está errado ou foi trocado. No @BotFather, envie `/mybots`, escolha o bot e copie o token atual;\n - se aparece \"não foi possível falar com o Telegram agora\": tente de novo em alguns minutos.\n- **Aparece \"este bot já está conectado\"**\n Um bot só pode estar conectado a um workspace. Se ele já está na lista, use essa conexão. Se está em outro workspace, remova-o lá primeiro, ou crie outro bot no @BotFather.\n- **O bot aparece como Desconectado, com \"Usuário bloqueou o bot\", e as respostas falham**\n Isso acontece quando alguém bloqueia o bot no Telegram. Enquanto o bot estiver **Desconectado**, as mensagens continuam chegando, mas as respostas de todas as conversas dele mostram **Falha ao enviar**. Clique no ícone de setas (**Testar conexão**) na linha do bot: se aparecer \"Webhook ativo\", ele volta para **Conectado**. Depois, envie de novo as respostas que falharam.\n- **O teste mostra \"Webhook não está registrado neste bot — reconecte\"**\n O Telegram deixou de entregar as mensagens ao painel, em geral porque o token foi configurado em outro sistema, e o bot fica com o status **Erro**. Pare de usar o token no outro sistema. Depois, remova o bot na lixeira e conecte de novo em **Novo bot**, com o mesmo token. Por fim, marque a conexão nova no agente de IA e confira os fluxos que eram só do bot antigo.\n- **As mensagens de um grupo não chegam**\n O painel só recebe as conversas privadas com o bot. Mensagens em grupos e canais do Telegram, e as enviadas por outros bots, ficam de fora. Peça para a pessoa escrever direto para o bot.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Conectar um bot do Telegram?\n- O cartão Telegram mostra \"fora do plano\" ou \"Telegram não incluído no seu plano\"\n- O botão Novo bot está desativado e aparece \"limite atingido\"\n- O botão Conectar bot não fica ativo, ou aparece \"token do bot inválido\"\n- Aparece \"este bot já está conectado\"\n\nResposta curta: Conecte um bot do Telegram criado no @BotFather para receber e responder em Conversas as mensagens privadas enviadas a ele. No menu lateral, clique em Conexões e depois no cartão Telegram. Clique em Novo bot. Abre o formulário Nova conexão do Telegram. Em Token do bot, cole o token que o @BotFather enviou. O campo esconde o que você digita, e o painel guarda o token criptografado. Em Nome da conexão, escreva um nome que a sua equipe reconheça, por exemplo Atendimento Telegram. É opcional: em branco, o painel usa o @ do bot.\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Atender uma conversa: assumir, transferir e encerrar» (`atender-conversa`)\n" }, { "slug": "conectar-um-email", "categoria": "Canais e conexões", "titulo": "Receber e responder e-mails pelo painel", "resumo": "Conecte um endereço de e-mail do seu domínio pelo Resend para receber os e-mails dos clientes em Conversas e responder por aqui.", "tags": [ "e-mail", "email", "resend", "domínio", "dns", "caixa de entrada", "responder e-mail", "encaminhamento" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Conexões", "E-mail" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O cartão Email mostra \"fora do plano\", ou o botão Nova conexão mostra \"limite atingido\"", "causa": "", "solucao": "O canal não está no plano, ou o workspace já usa todas as conexões de e-mail liberadas, contando as Pendente e Desconectado.\n- Se você é o dono da conta: no menu lateral, clique em Agência e, na linha do workspace, em Configurar. Na aba Limites e addons, no cartão E-mail, clique em Liberar +1 addon neste workspace e em Salvar alterações. Veja «Liberar um addon no workspace».\n- Se você não é o dono da conta: fale com o responsável pela sua agência para liberar." }, { "sintoma": "Aparece \"Conecte a integração Resend primeiro\", \"Não foi possível usar a integração Resend\" ou \"Nenhum domínio verificado na sua conta Resend\"", "causa": "", "solucao": "Nos dois primeiros, falta a integração ou a chave salva não funciona: o dono ou um admin do workspace confere no cartão Resend, em Integrações. A chave precisa poder ler os domínios da conta, e não só enviar. No terceiro, termine a verificação do domínio no Resend. Depois, clique em Nova conexão de novo." }, { "sintoma": "A conexão continua Pendente", "causa": "", "solucao": "Ela só passa para Conectado quando chega o primeiro e-mail. Confira:\n- se o teste foi para o endereço exato da conexão: e-mails para outros endereços do domínio são ignorados;\n- se o webhook no Resend tem a URL mostrada no aviso \"Configuração pendente — falta colar a URL no Resend\" e o evento email.received marcado;\n- se o Signing Secret colado é o desse webhook. Se não for, remova a conexão e crie de novo, com o valor certo." }, { "sintoma": "Ao criar, aparece que já existe uma conexão Email usando esse remetente", "causa": "", "solucao": "Cada endereço só pode estar em uma conexão por workspace, mesmo que a outra esteja Pendente. Remova a conexão antiga ou use outro endereço." }, { "sintoma": "O cliente respondeu, mas a conversa continua pendente", "causa": "", "solucao": "No e-mail, a conversa marcada como pendente continua pendente quando o cliente escreve de novo. Ela segue em Meus atendimentos de quem atende (para o resto da equipe, em Outros). Confira essa aba, ou use Resolver conversa em vez de Marcar como pendente: a conversa resolvida reabre sozinha quando o cliente responde." }, { "sintoma": "A resposta aparece com \"Falha ao enviar\"", "causa": "", "solucao": "Passe o mouse sobre o aviso e veja o motivo. \"Canal desconectado — verifique a conexão na página de Conexões.\" aparece quando a conexão está Pendente ou Desconectado: as respostas só saem de conexões Conectado. Nos outros casos, confira a integração do Resend e o e-mail do contato." } ], "para_ia": { "perguntas": [ "Receber e responder e-mails pelo painel?", "O cartão Email mostra \"fora do plano\", ou o botão Nova conexão mostra \"limite atingido\"", "Aparece \"Conecte a integração Resend primeiro\", \"Não foi possível usar a integração Resend\" ou \"Nenhum domínio verificado na sua conta Resend\"", "A conexão continua Pendente", "Ao criar, aparece que já existe uma conexão Email usando esse remetente" ], "resposta": "Conecte um endereço de e-mail do seu domínio pelo Resend para receber os e-mails dos clientes em Conversas e responder por aqui. No menu lateral, clique em Integrações e, no cartão Resend, em Configurar. Crie uma chave no Resend, como mostra o quadro Como obter sua API Key, e cole no campo API Key. Preencha Email Remetente e Nome Remetente. Eles também aparecem nos convites da equipe. Clique em Salvar integração e aguarde Integração salva.", "escalar": [ "Configuração de DNS do domínio do cliente" ] }, "relacionados": [ "integracoes-e-provedores-de-ia", "atender-conversa" ], "markdown": "---\nslug: conectar-um-email\ncategoria: Canais e conexões\natualizado: 17/10/2026\ntags: e-mail, email, resend, domínio, dns, caixa de entrada, responder e-mail, encaminhamento\nno_painel: Conexões > E-mail\nverificacao: baseado no guia oficial do painel\n---\n\n# Receber e responder e-mails pelo painel\n\nConecte um endereço de e-mail do seu domínio pelo Resend para receber os e-mails dos clientes em Conversas e responder por aqui.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Tenha uma conta no Resend com o seu domínio verificado e pronto para receber e-mails (siga as instruções do Resend).\n- Só o dono e os admins do workspace salvam a integração do Resend, no menu **Integrações**.\n- Para criar a conexão, você precisa do menu **Conexões**. Se ele não aparece, peça a quem administra a sua equipe.\n- O canal precisa estar liberado no seu workspace. Se o cartão **Email** aparecer bloqueado, veja o primeiro item de *Se algo der errado*.\n\nAo conectar um endereço de e-mail, cada e-mail que um cliente manda para ele vira uma conversa em **Conversas**, e a sua resposta sai por e-mail, no mesmo assunto. A conexão usa o Resend, um serviço de e-mail que você contrata, com um domínio seu, como o do site da empresa.\n\nCada cliente tem uma conversa só por conexão, com todos os e-mails dele. Um agente de IA também pode responder por ela: veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\n## Salvar a integração do Resend\n\n1. No menu lateral, clique em **Integrações** e, no cartão **Resend**, em **Configurar**.\n2. Crie uma chave no Resend, como mostra o quadro **Como obter sua API Key**, e cole no campo **API Key**.\n3. Preencha **Email Remetente** e **Nome Remetente**. Eles também aparecem nos convites da equipe.\n4. Clique em **Salvar integração** e aguarde **Integração salva.**\n\n> **Atenção:** Não desative nem remova a integração do Resend enquanto usar o canal: sem ela, os e-mails param de chegar e as respostas não saem.\n\n## Conectar o endereço\n\n1. No menu lateral, clique em **Conexões** e depois no cartão **Email**.\n2. Clique em **Nova conexão**.\n3. Na etapa **Remetente**, preencha o **Nome da conexão**, que só a equipe vê, por exemplo *Atendimento*.\n4. Em **Email remetente**, escreva o começo do endereço, por exemplo *contato*, e escolha o domínio em **Selecione um domínio**. Os clientes escrevem para este endereço, e as respostas saem dele.\n5. Se quiser, preencha **Nome de exibição do remetente**, que o cliente vê antes do endereço, e clique em **Próximo →**.\n6. Na etapa **Webhook** (o aviso que o Resend manda ao painel a cada e-mail recebido), clique em **Copiar**, ao lado de **URL do webhook**.\n7. No Resend, na página de webhooks, clique em **Add Endpoint**, cole a URL em **Endpoint URL** e marque o evento `email.received`. Os eventos de status são opcionais: com eles, o e-mail que voltar sem ser entregue aparece com **Falha ao enviar**.\n8. Copie o **Signing Secret** que o Resend mostrar, cole no campo **Signing Secret** do painel e clique em **Próximo →**.\n9. Na etapa **Configurações**, preencha o **Assunto padrão (envio proativo)**, por exemplo *Atendimento Acme*. Nas respostas, o painel usa o assunto do e-mail do cliente, com o **Prefixo de resposta** na frente (*Re:*, se você não mudar).\n10. Clique em **Criar conexão**. A conexão aparece como **Pendente**.\n11. De outra caixa, mande um e-mail de teste para o endereço da conexão. Quando ele chegar em **Conversas**, a conexão passa sozinha para **Conectado**.\n\n## Responder em Conversas\n\n1. Em **Conversas**, abra a conversa. O e-mail chega limpo, sem o histórico citado, e o assunto aparece acima da mensagem sempre que muda. Para vê-lo como o cliente mandou, clique em **Ver email original**, logo abaixo.\n2. Escreva a resposta e envie. Ela sai pelo endereço da conexão, como resposta ao último e-mail do cliente e com o assunto dele.\n3. Para mandar um arquivo, clique no botão **☰** (**Ações da mensagem**) e escolha **Foto ou vídeo**, **Documento** ou **Áudio**. Vai um arquivo por mensagem, de até 16 MB, e o texto escrito junto vai no corpo do e-mail.\n\n> **Bom saber:** Localização e contato não saem por e-mail. Se o cliente mandar vários anexos num e-mail, só o primeiro aparece na conversa: peça um arquivo por e-mail.\n\n## Desconectar ou remover\n\n1. Em **Conexões**, abra o cartão **Email**, clique na lixeira (**Remover**) da conexão e confirme em **Remover**. As conversas antigas ficam em **Conversas**; se o endereço for conectado de novo, os e-mails chegam em conversas novas. A conexão sai dos agentes de IA, os fluxos filtrados só por ela passam a valer para todos os canais, e os follow-ups ativos dela somem.\n2. No Resend, apague o webhook que você criou para essa conexão.\n\nO botão **Desconectar** só aparece em conexões **Conectado**. Depois dele, as respostas por esta conexão não saem mais, e não há botão para reconectar: para voltar a responder, remova a conexão e crie outra.\n\n## Não funcionou?\n\n- **O cartão Email mostra \"fora do plano\", ou o botão Nova conexão mostra \"limite atingido\"**\n O canal não está no plano, ou o workspace já usa todas as conexões de e-mail liberadas, contando as **Pendente** e **Desconectado**.\n - Se você é o dono da conta: no menu lateral, clique em **Agência** e, na linha do workspace, em **Configurar**. Na aba **Limites e addons**, no cartão **E-mail**, clique em **Liberar +1 addon neste workspace** e em **Salvar alterações**. Veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n - Se você não é o dono da conta: fale com o responsável pela sua agência para liberar.\n- **Aparece \"Conecte a integração Resend primeiro\", \"Não foi possível usar a integração Resend\" ou \"Nenhum domínio verificado na sua conta Resend\"**\n Nos dois primeiros, falta a integração ou a chave salva não funciona: o dono ou um admin do workspace confere no cartão **Resend**, em **Integrações**. A chave precisa poder ler os domínios da conta, e não só enviar. No terceiro, termine a verificação do domínio no Resend. Depois, clique em **Nova conexão** de novo.\n- **A conexão continua Pendente**\n Ela só passa para **Conectado** quando chega o primeiro e-mail. Confira:\n - se o teste foi para o endereço exato da conexão: e-mails para outros endereços do domínio são ignorados;\n - se o webhook no Resend tem a URL mostrada no aviso \"Configuração pendente — falta colar a URL no Resend\" e o evento `email.received` marcado;\n - se o **Signing Secret** colado é o desse webhook. Se não for, remova a conexão e crie de novo, com o valor certo.\n- **Ao criar, aparece que já existe uma conexão Email usando esse remetente**\n Cada endereço só pode estar em uma conexão por workspace, mesmo que a outra esteja **Pendente**. Remova a conexão antiga ou use outro endereço.\n- **O cliente respondeu, mas a conversa continua pendente**\n No e-mail, a conversa marcada como pendente continua pendente quando o cliente escreve de novo. Ela segue em **Meus atendimentos** de quem atende (para o resto da equipe, em **Outros**). Confira essa aba, ou use **Resolver conversa** em vez de **Marcar como pendente**: a conversa resolvida reabre sozinha quando o cliente responde.\n- **A resposta aparece com \"Falha ao enviar\"**\n Passe o mouse sobre o aviso e veja o motivo. \"Canal desconectado — verifique a conexão na página de Conexões.\" aparece quando a conexão está **Pendente** ou **Desconectado**: as respostas só saem de conexões **Conectado**. Nos outros casos, confira a integração do Resend e o e-mail do contato.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Receber e responder e-mails pelo painel?\n- O cartão Email mostra \"fora do plano\", ou o botão Nova conexão mostra \"limite atingido\"\n- Aparece \"Conecte a integração Resend primeiro\", \"Não foi possível usar a integração Resend\" ou \"Nenhum domínio verificado na sua conta Resend\"\n- A conexão continua Pendente\n- Ao criar, aparece que já existe uma conexão Email usando esse remetente\n\nResposta curta: Conecte um endereço de e-mail do seu domínio pelo Resend para receber os e-mails dos clientes em Conversas e responder por aqui. No menu lateral, clique em Integrações e, no cartão Resend, em Configurar. Crie uma chave no Resend, como mostra o quadro Como obter sua API Key, e cole no campo API Key. Preencha Email Remetente e Nome Remetente. Eles também aparecem nos convites da equipe. Clique em Salvar integração e aguarde Integração salva.\n\nEscalar para um humano quando:\n- Configuração de DNS do domínio do cliente\n\nVeja também: «Conectar um provedor de IA e outras integrações» (`integracoes-e-provedores-de-ia`); «Atender uma conversa: assumir, transferir e encerrar» (`atender-conversa`)\n" }, { "slug": "conectar-sms", "categoria": "Canais e conexões", "titulo": "Conectar o SMS pela Comtele", "resumo": "Conecte a sua conta da Comtele para enviar SMS aos contatos em Conversas, receber as respostas e usar o SMS em lembretes e automações.", "tags": [ "sms", "comtele", "mensagem de texto", "lembrete por sms", "rcs" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Conexões", "SMS" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O cartão SMS mostra \"fora do plano\", ou o botão Nova conexão mostra \"limite atingido\"", "causa": "", "solucao": "O canal não está no plano, ou o workspace já usa todas as conexões de SMS liberadas para ele.\n- Se você é o dono da conta: no menu lateral, clique em Agência e, na linha do workspace, em Configurar. Na aba Limites e addons, em Canais e addons, encontre SMS / RCS (Comtele), clique em Liberar +1 addon neste workspace e em Salvar alterações. Veja «Liberar um addon no workspace».\n- Se você não é o dono da conta: fale com o responsável pela sua agência para liberar." }, { "sintoma": "A mensagem aparece com \"Falha ao enviar\"", "causa": "", "solucao": "Passe o mouse sobre o aviso e veja o motivo:\n- \"comtele_credentials_missing\": não há chave da Comtele ativa. O dono ou um admin salva a chave em Integrações;\n- \"comtele_auth_failed\", ou uma mensagem da Comtele sobre a chave: a chave está errada ou foi trocada. Cole a chave atual no cartão Comtele;\n- \"Tipo de mensagem não suportado neste canal.\": o tipo não sai por SMS, como áudio ou vídeo;\n- outra mensagem da Comtele: confira o remetente da conexão e o número do contato.\nDepois de corrigir, envie de novo." }, { "sintoma": "As respostas dos clientes não chegam", "causa": "", "solucao": "Confira no painel da Comtele se a URL que aparece em Webhook:, na linha da conexão, está nos campos de retorno de resposta e de status. Se você removeu e criou a conexão de novo, o endereço mudou." }, { "sintoma": "O cliente respondeu, mas o agente de IA não atendeu, ou a automação não rodou", "causa": "", "solucao": "As respostas por SMS não são atendidas por agente de IA e não disparam fluxos nem automações. Alguém da equipe responde em Conversas." }, { "sintoma": "O contador mostra \"Unicode (70/seg)\" e mais segmentos do que o esperado", "causa": "", "solucao": "Letras como *ã*, *õ*, *á*, *ê* e *ç*, e os emojis, mudam o texto para Unicode, com 70 caracteres por segmento em vez de 160. Em mensagens longas, cada parte leva 67 caracteres no Unicode e 153 no GSM-7. Para gastar menos, evite esses caracteres." }, { "sintoma": "O lembrete por SMS não saiu", "causa": "", "solucao": "O contato precisa ter uma conversa na conexão de SMS escolhida no lembrete. Abra uma em Conversas, pelo ícone de SMS ao lado do contato, e confira os outros pontos em «Criar calendários e cuidar dos agendamentos»." } ], "para_ia": { "perguntas": [ "Conectar o SMS pela Comtele?", "O cartão SMS mostra \"fora do plano\", ou o botão Nova conexão mostra \"limite atingido\"", "A mensagem aparece com \"Falha ao enviar\"", "As respostas dos clientes não chegam", "O cliente respondeu, mas o agente de IA não atendeu, ou a automação não rodou" ], "resposta": "Conecte a sua conta da Comtele para enviar SMS aos contatos em Conversas, receber as respostas e usar o SMS em lembretes e automações. No menu lateral, clique em Integrações e, no cartão Comtele, em Configurar. Pegue a chave no painel da Comtele, como mostra o quadro Como obter sua API Key, e cole em API Key. A chave funciona como uma senha: não a compartilhe. Clique em Salvar integração e aguarde Integração salva. O painel só confere a chave no primeiro envio. No menu lateral, clique em Conexões e depois no cartão SMS.", "escalar": [] }, "relacionados": [ "calendarios-e-agendamentos", "automacao-basica" ], "markdown": "---\nslug: conectar-sms\ncategoria: Canais e conexões\natualizado: 17/10/2026\ntags: sms, comtele, mensagem de texto, lembrete por sms, rcs\nno_painel: Conexões > SMS\nverificacao: baseado no guia oficial do painel\n---\n\n# Conectar o SMS pela Comtele\n\nConecte a sua conta da Comtele para enviar SMS aos contatos em Conversas, receber as respostas e usar o SMS em lembretes e automações.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Tenha uma conta na Comtele com um remetente (o short-code, número curto que aparece para quem recebe) e a chave de API dela.\n- Só o dono e os admins do workspace salvam a chave, no menu **Integrações**.\n- Para criar a conexão, você precisa do menu **Conexões**. Se ele não aparece, peça a quem administra a sua equipe.\n- O canal precisa estar liberado no seu workspace. Se o cartão **SMS** aparecer bloqueado, veja o primeiro item de *Se algo der errado*.\n\nAo conectar a sua conta da Comtele, a empresa que entrega os SMS, você manda mensagens aos contatos pela tela **Conversas**, e as respostas deles chegam por aqui. O SMS também pode sair nos lembretes de agendamento e nas automações.\n\nO painel tenta primeiro o RCS, a mensagem mais completa que alguns celulares recebem, e, se ele falhar, manda por SMS. No SMS não existe janela de 24 horas: você pode escrever primeiro, a qualquer momento.\n\n> **Atenção:** A chave da Comtele, salva em **Integrações**, vale para todas as conexões de SMS do workspace. Se ela for removida ou desativada, nenhum SMS sai.\n\n## Salvar a chave da Comtele\n\n1. No menu lateral, clique em **Integrações** e, no cartão **Comtele**, em **Configurar**.\n2. Pegue a chave no painel da Comtele, como mostra o quadro **Como obter sua API Key**, e cole em **API Key**. A chave funciona como uma senha: não a compartilhe.\n3. Clique em **Salvar integração** e aguarde **Integração salva.** O painel só confere a chave no primeiro envio.\n\n## Criar a conexão\n\n1. No menu lateral, clique em **Conexões** e depois no cartão **SMS**.\n2. Clique em **Nova conexão**. Abre o formulário **Nova conexão SMS / RCS (Comtele)**.\n3. Em **Nome da conexão**, escreva um nome que a equipe reconheça, por exemplo *SMS Atendimento*.\n4. Em **Sender (short-code numérico)**, digite o remetente configurado na sua conta da Comtele, por exemplo *28181*.\n5. Em **URL do webhook**, clique em **Copiar**. No painel da Comtele, cole esse endereço nos campos de retorno (callback) de resposta e de status. É por ele que a Comtele avisa o painel das respostas e das entregas.\n6. Clique em **Criar conexão**. Ela aparece na lista como **Conectado**, com o remetente abaixo do nome e o endereço em **Webhook:**, para copiar de novo quando precisar.\n\n## Enviar e receber SMS\n\n1. Em **Conversas**, busque o contato pelo nome e, na parte **Contatos** do resultado, clique no ícone de SMS ao lado dele. Para alguém novo, clique em **Novo contato** (ícone de pessoa com +), preencha **Nome** e o número, escolha o canal, se pedir, e clique em **Criar e abrir conversa**.\n2. Escreva a mensagem. Ao lado do campo, o contador estima os caracteres, os segmentos que a Comtele cobra e o tipo de texto, como *80 car · 1 seg · GSM-7 (160/seg)*.\n3. Para mandar um arquivo, clique no botão **☰** (**Ações da mensagem**) e escolha **Foto ou vídeo** (só fotos) ou **Documento**. Se o arquivo não for por RCS, vai um SMS com o texto e um link para ele, que vale por 24 horas.\n4. Envie. As respostas do cliente chegam em **Conversas**, só com texto.\n\nNa conversa aberta pelo painel, o SMS vai para o número do campo **WhatsApp** do contato ou, se ele estiver vazio, para o **Telefone**. Áudio, vídeo, localização e contato não saem por SMS.\n\n## Usar em lembretes e automações\n\n1. Nos lembretes de um calendário, clique em **Adicionar lembrete**, escolha **SMS** em **Método**, a conexão em **Conexão SMS (Comtele)** e escreva a **Mensagem personalizada**. O contato precisa já ter uma conversa nessa conexão. Veja «Criar calendários e cuidar dos agendamentos» (artigo `calendarios-e-agendamentos`).\n2. Numa Automação Básica, em **Então (passos)**, adicione **Enviar SMS**, no grupo **Ações**. Em **Para (número)**, deixe *{{contact.phone}}* ou digite um número, e escreva a **Mensagem**. O passo usa a primeira conexão de SMS do workspace, e esse SMS não aparece na conversa.\n\n## Editar ou remover\n\n1. Para trocar o nome ou o remetente, clique no lápis (**Editar**) da conexão, mude os campos e clique em **Salvar**. O endereço do webhook continua o mesmo.\n2. Para remover, clique na lixeira (**Remover**) e confirme em **Remover**. Não dá para desfazer.\n\nAo remover, as conversas antigas continuam em **Conversas**, mas as mensagens novas chegam em conversas novas. A conexão sai dos agentes de IA, os fluxos filtrados só por ela passam a valer para todos os canais, e os follow-ups ativos dela somem. Uma conexão nova tem outro endereço de webhook: atualize-o na Comtele.\n\n## Não funcionou?\n\n- **O cartão SMS mostra \"fora do plano\", ou o botão Nova conexão mostra \"limite atingido\"**\n O canal não está no plano, ou o workspace já usa todas as conexões de SMS liberadas para ele.\n - Se você é o dono da conta: no menu lateral, clique em **Agência** e, na linha do workspace, em **Configurar**. Na aba **Limites e addons**, em **Canais e addons**, encontre **SMS / RCS (Comtele)**, clique em **Liberar +1 addon neste workspace** e em **Salvar alterações**. Veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n - Se você não é o dono da conta: fale com o responsável pela sua agência para liberar.\n- **A mensagem aparece com \"Falha ao enviar\"**\n Passe o mouse sobre o aviso e veja o motivo:\n - \"comtele_credentials_missing\": não há chave da Comtele ativa. O dono ou um admin salva a chave em **Integrações**;\n - \"comtele_auth_failed\", ou uma mensagem da Comtele sobre a chave: a chave está errada ou foi trocada. Cole a chave atual no cartão **Comtele**;\n - \"Tipo de mensagem não suportado neste canal.\": o tipo não sai por SMS, como áudio ou vídeo;\n - outra mensagem da Comtele: confira o remetente da conexão e o número do contato.\n Depois de corrigir, envie de novo.\n- **As respostas dos clientes não chegam**\n Confira no painel da Comtele se a URL que aparece em **Webhook:**, na linha da conexão, está nos campos de retorno de resposta e de status. Se você removeu e criou a conexão de novo, o endereço mudou.\n- **O cliente respondeu, mas o agente de IA não atendeu, ou a automação não rodou**\n As respostas por SMS não são atendidas por agente de IA e não disparam fluxos nem automações. Alguém da equipe responde em **Conversas**.\n- **O contador mostra \"Unicode (70/seg)\" e mais segmentos do que o esperado**\n Letras como *ã*, *õ*, *á*, *ê* e *ç*, e os emojis, mudam o texto para Unicode, com 70 caracteres por segmento em vez de 160. Em mensagens longas, cada parte leva 67 caracteres no Unicode e 153 no GSM-7. Para gastar menos, evite esses caracteres.\n- **O lembrete por SMS não saiu**\n O contato precisa ter uma conversa na conexão de SMS escolhida no lembrete. Abra uma em **Conversas**, pelo ícone de SMS ao lado do contato, e confira os outros pontos em «Criar calendários e cuidar dos agendamentos» (artigo `calendarios-e-agendamentos`).\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Conectar o SMS pela Comtele?\n- O cartão SMS mostra \"fora do plano\", ou o botão Nova conexão mostra \"limite atingido\"\n- A mensagem aparece com \"Falha ao enviar\"\n- As respostas dos clientes não chegam\n- O cliente respondeu, mas o agente de IA não atendeu, ou a automação não rodou\n\nResposta curta: Conecte a sua conta da Comtele para enviar SMS aos contatos em Conversas, receber as respostas e usar o SMS em lembretes e automações. No menu lateral, clique em Integrações e, no cartão Comtele, em Configurar. Pegue a chave no painel da Comtele, como mostra o quadro Como obter sua API Key, e cole em API Key. A chave funciona como uma senha: não a compartilhe. Clique em Salvar integração e aguarde Integração salva. O painel só confere a chave no primeiro envio. No menu lateral, clique em Conexões e depois no cartão SMS.\n\nVeja também: «Criar calendários e cuidar dos agendamentos» (`calendarios-e-agendamentos`); «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (`automacao-basica`)\n" }, { "slug": "calendarios-e-agendamentos", "categoria": "Contatos e vendas", "titulo": "Criar calendários e cuidar dos agendamentos", "resumo": "Crie um calendário para cada tipo de atendimento, ligue o Google Calendar ou o Cal.com e marque, remarque e cancele agendamentos.", "tags": [ "agendamentos", "calendário", "agenda", "google calendar", "cal.com", "marcar horário", "remarcar", "cancelar", "lembrete", "follow ups", "disponibilidade" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Agendamentos" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Cliquei em Excluir e nada aconteceu, ou apareceu \"você não tem permissão para esta ação\"", "causa": "", "solucao": "Excluir pede a permissão Excluir agendamentos, que os agentes não têm por padrão. Cancele o agendamento em vez de excluir ou peça a quem administra a sua equipe." }, { "sintoma": "Ao excluir um calendário, aparece \"Este calendário tem agendamentos vinculados\"", "causa": "", "solucao": "Qualquer agendamento do calendário impede a exclusão, mesmo os cancelados. Desligue a chave no cartão (isso cancela os agendamentos futuros) ou, na Lista, filtre pelo calendário, veja Próximos e Passados e exclua os agendamentos antes." }, { "sintoma": "Ao salvar um agendamento, aparece um aviso para marcar \"Ignorar regras de disponibilidade\"", "causa": "", "solucao": "Já existe outro agendamento no mesmo calendário nesse horário. Escolha outro horário ou, se quiser os dois, marque Ignorar regras de disponibilidade (encaixe forçado) e salve de novo." }, { "sintoma": "O lembrete não foi enviado", "causa": "", "solucao": "Confira:\n- o agendamento está Confirmado e tem um Contato vinculado;\n- o lembrete tem uma conexão escolhida, e o contato já tem conversa nessa conexão;\n- o horário do lembrete ainda estava no futuro quando o agendamento foi confirmado." }, { "sintoma": "Aparece \"Limite de integrações Google Calendar atingido\" ou, ao salvar um calendário com Cal.com, \"sem saldo para esta ação\"", "causa": "", "solucao": "Cada conta Google conectada e cada ligação com o Cal.com (calendário ou Function) ocupam uma vaga do workspace.\n- Se você é o dono da conta (quem vê o menu Agência), libere mais uma vaga do recurso. Veja «Liberar um addon no workspace».\n- Se você não é o dono da conta: fale com o responsável pela sua agência." }, { "sintoma": "Aparece \"Você conectou a conta, mas não autorizou o acesso ao Google Calendar\"", "causa": "", "solucao": "Na tela do Google, a permissão da agenda ficou desmarcada. Clique em Conectar conta de novo e, dessa vez, marque o acesso ao Calendário." }, { "sintoma": "O que o agente de IA marca não aparece na Lista", "causa": "", "solucao": "O agendamento só entra no painel se houver um calendário ativo ligado, em Integração externa, à mesma conta Google ou conexão Cal.com usada pela Function do agente. Sem essa ligação, ele fica só no Google Calendar ou no Cal.com e não recebe os lembretes do painel." } ], "para_ia": { "perguntas": [ "Criar calendários e cuidar dos agendamentos?", "Cliquei em Excluir e nada aconteceu, ou apareceu \"você não tem permissão para esta ação\"", "Ao excluir um calendário, aparece \"Este calendário tem agendamentos vinculados\"", "Ao salvar um agendamento, aparece um aviso para marcar \"Ignorar regras de disponibilidade\"", "O lembrete não foi enviado" ], "resposta": "Crie um calendário para cada tipo de atendimento, ligue o Google Calendar ou o Cal.com e marque, remarque e cancele agendamentos. No menu lateral, clique em Agendamentos e abra a aba Calendários. Clique em Novo calendário. Em Nome, escreva o tipo de atendimento, por exemplo Consulta inicial, e escolha uma Cor, que identifica os agendamentos na Agenda. Em Tipo de local, escolha Online, Telefone ou Presencial e preencha o número ou o endereço, se pedido. Com Online e o calendário ligado a uma conta Google, o Google Calendar cria o link do Meet de cada agendamento.", "escalar": [] }, "relacionados": [ "functions-do-agente", "ferramentas-da-conversa", "conectar-sms" ], "markdown": "---\nslug: calendarios-e-agendamentos\ncategoria: Contatos e vendas\natualizado: 17/10/2026\ntags: agendamentos, calendário, agenda, google calendar, cal.com, marcar horário, remarcar, cancelar, lembrete, follow ups, disponibilidade\nno_painel: Agendamentos\nverificacao: baseado no guia oficial do painel\n---\n\n# Criar calendários e cuidar dos agendamentos\n\nCrie um calendário para cada tipo de atendimento, ligue o Google Calendar ou o Cal.com e marque, remarque e cancele agendamentos.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Você precisa ter acesso ao menu **Agendamentos**. Criar, editar e cancelar dependem das permissões de agendamento e, por padrão, só o dono e os administradores do workspace podem excluir. Se faltar algo, peça a quem administra a sua equipe.\n- Ligar uma conta do Google Calendar ou do Cal.com é tarefa do dono ou de um administrador.\n- Para os lembretes, o WhatsApp ou o SMS precisa estar conectado em **Conexões**.\n\nEm **Agendamentos** ficam todos os horários marcados do workspace: num calendário por mês, semana ou dia, na aba **Agenda**, ou em lista, na aba **Lista**. Cada agendamento pertence a um calendário, que representa um tipo de atendimento, como *Consulta* ou *Visita técnica*, com local e lembretes próprios.\n\nOs agendamentos podem ser criados à mão, pelo agente de IA durante a conversa ou por uma automação. Com o calendário ligado a uma conta Google, eles também vão para o Google Calendar, com link do Meet quando o atendimento é online.\n\n> **Atenção:** Para saber os horários livres, o agente de IA consulta a agenda do Google Calendar ou do Cal.com ligada à Function dele. A **Disponibilidade** e as **Restrições** do calendário no painel ficam registradas, mas não impedem agendamentos. Mantenha em dia a agenda do Google ou do Cal.com.\n\n## Criar um calendário\n\n1. No menu lateral, clique em **Agendamentos** e abra a aba **Calendários**.\n2. Clique em **Novo calendário**.\n3. Em **Nome**, escreva o tipo de atendimento, por exemplo *Consulta inicial*, e escolha uma **Cor**, que identifica os agendamentos na **Agenda**.\n4. Em **Tipo de local**, escolha **Online**, **Telefone** ou **Presencial** e preencha o número ou o endereço, se pedido. Com **Online** e o calendário ligado a uma conta Google, o Google Calendar cria o link do Meet de cada agendamento.\n5. Em **Lembretes**, clique em **Adicionar lembrete** (até 3). Diga quanto tempo **Antes** do horário ele sai, escolha o **Método** e a conexão e, depois, o template aprovado, o fluxo ou a **Mensagem personalizada**, que aceita variáveis como `{{nome}}` e `{{data_hora}}`.\n6. Em **Integração externa**, escolha a conta e o calendário em **Google Calendar** ou uma conexão em **Cal.com**. Se não usa nenhum dos dois, deixe **Não vincular**.\n7. Clique em **Salvar**. O calendário aparece na aba como **Ativo**.\n\nO **Fuso horário** não se edita aqui: ligado ao Google, o calendário segue o fuso da agenda no Google Calendar (mude lá e salve o calendário de novo); sem ligação, vale o fuso mostrado no campo. Para mudar o calendário depois, clique nos três pontos (⋮) do cartão dele e em **Editar**.\n\n> **Atenção:** Desligar a chave de um calendário, no cartão dele, cancela todos os agendamentos futuros desse calendário.\n\n## Ligar o Google Calendar ou o Cal.com\n\n1. Na aba **Integrações**, em **Google Calendar**, clique em **Conectar conta**.\n2. Na janela do Google, entre na conta e autorize o acesso à agenda. Se o navegador bloquear a janela, libere os pop-ups do painel e tente de novo.\n3. Com a conta conectada, edite o calendário e escolha essa conta em **Integração externa**.\n4. Para o Cal.com, clique em **Gerenciar em Integrações** e conecte o **Cal.com** com a chave de API v2 da sua conta. Depois, escolha a conexão em **Integração externa** do calendário.\n\n## Marcar, remarcar e cancelar\n\n1. Clique em **Novo agendamento**, no topo da página, ou num dia vazio da **Agenda**.\n2. Escolha o **Calendário** e preencha **Nome do cliente**, **Início** e **Fim**. Em **Contato vinculado**, busque o contato: sem ele, os lembretes não saem. Confira também o **Local**, que começa em **Online**.\n3. Clique em **Salvar**. Agendamentos feitos à mão entram como **Confirmado**.\n4. Para mudar, clique no agendamento na **Agenda**. Em **Detalhes do agendamento**, use **Editar** para trocar **Início** e **Fim**, **Cancelar** para cancelar ou **Marcar como concluído** depois do atendimento. Na **Lista**, os três pontos (⋮) da linha também têm **Editar** e **Cancelar**, e clicar no status permite marcar **Não compareceu**.\n\n> **Dica:** Se o calendário tem lembretes, para remarcar prefira cancelar e criar um novo agendamento. Ao editar o horário, os lembretes já programados continuam no horário antigo.\n\nPara o agente de IA marcar sozinho, crie uma Function do Google Calendar ou do Cal.com com a mesma conta ligada ao calendário e ative-a no agente. Veja «Dar ações ao agente com Functions» (artigo `functions-do-agente`). O que ele marca entra como **Confirmado**, e ele também remarca e cancela.\n\nNas outras abas, **Follow Ups** lista as sequências de mensagens programadas para contatos, criadas numa conversa (**Mais ações** > **Criar follow up**) ou pelo agente de IA. Veja o **Progresso** e use **Abrir conversa** para editar ou cancelar; a sequência para sozinha quando o contato responde. **Logs** registra os agendamentos criados e cancelados, e as remarcações feitas pelo agente de IA ou por automação, com a origem de cada ação.\n\n## Não funcionou?\n\n- **Cliquei em Excluir e nada aconteceu, ou apareceu \"você não tem permissão para esta ação\"**\n Excluir pede a permissão **Excluir agendamentos**, que os agentes não têm por padrão. Cancele o agendamento em vez de excluir ou peça a quem administra a sua equipe.\n- **Ao excluir um calendário, aparece \"Este calendário tem agendamentos vinculados\"**\n Qualquer agendamento do calendário impede a exclusão, mesmo os cancelados. Desligue a chave no cartão (isso cancela os agendamentos futuros) ou, na **Lista**, filtre pelo calendário, veja **Próximos** e **Passados** e exclua os agendamentos antes.\n- **Ao salvar um agendamento, aparece um aviso para marcar \"Ignorar regras de disponibilidade\"**\n Já existe outro agendamento no mesmo calendário nesse horário. Escolha outro horário ou, se quiser os dois, marque **Ignorar regras de disponibilidade (encaixe forçado)** e salve de novo.\n- **O lembrete não foi enviado**\n Confira:\n - o agendamento está **Confirmado** e tem um **Contato vinculado**;\n - o lembrete tem uma conexão escolhida, e o contato já tem conversa nessa conexão;\n - o horário do lembrete ainda estava no futuro quando o agendamento foi confirmado.\n- **Aparece \"Limite de integrações Google Calendar atingido\" ou, ao salvar um calendário com Cal.com, \"sem saldo para esta ação\"**\n Cada conta Google conectada e cada ligação com o Cal.com (calendário ou Function) ocupam uma vaga do workspace.\n - Se você é o dono da conta (quem vê o menu **Agência**), libere mais uma vaga do recurso. Veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n - Se você não é o dono da conta: fale com o responsável pela sua agência.\n- **Aparece \"Você conectou a conta, mas não autorizou o acesso ao Google Calendar\"**\n Na tela do Google, a permissão da agenda ficou desmarcada. Clique em **Conectar conta** de novo e, dessa vez, marque o acesso ao Calendário.\n- **O que o agente de IA marca não aparece na Lista**\n O agendamento só entra no painel se houver um calendário ativo ligado, em **Integração externa**, à mesma conta Google ou conexão Cal.com usada pela Function do agente. Sem essa ligação, ele fica só no Google Calendar ou no Cal.com e não recebe os lembretes do painel.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Criar calendários e cuidar dos agendamentos?\n- Cliquei em Excluir e nada aconteceu, ou apareceu \"você não tem permissão para esta ação\"\n- Ao excluir um calendário, aparece \"Este calendário tem agendamentos vinculados\"\n- Ao salvar um agendamento, aparece um aviso para marcar \"Ignorar regras de disponibilidade\"\n- O lembrete não foi enviado\n\nResposta curta: Crie um calendário para cada tipo de atendimento, ligue o Google Calendar ou o Cal.com e marque, remarque e cancele agendamentos. No menu lateral, clique em Agendamentos e abra a aba Calendários. Clique em Novo calendário. Em Nome, escreva o tipo de atendimento, por exemplo Consulta inicial, e escolha uma Cor, que identifica os agendamentos na Agenda. Em Tipo de local, escolha Online, Telefone ou Presencial e preencha o número ou o endereço, se pedido. Com Online e o calendário ligado a uma conta Google, o Google Calendar cria o link do Meet de cada agendamento.\n\nVeja também: «Dar ações ao agente com Functions» (`functions-do-agente`); «Ferramentas da conversa: iniciar, anotar, agendar e usar a IA» (`ferramentas-da-conversa`); «Conectar o SMS pela Comtele» (`conectar-sms`)\n" }, { "slug": "prospectar-empresas", "categoria": "Contatos e vendas", "titulo": "Prospectar empresas e importar como contatos", "resumo": "Encontre empresas pelo cadastro de CNPJ ou pelo Google Maps e importe as escolhidas como contatos, já com tags.", "tags": [ "prospecção", "prospectar", "cnpj", "cnae", "google maps", "leads", "empresas", "importar contatos", "outreach" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Automações", "Prospecção Ativa" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Aparece \"Prospecção Ativa não está habilitada neste plano.\"", "causa": "", "solucao": "O recurso não está no plano deste workspace e não se libera em Limites e addons. Se você é o dono da conta, fale com o suporte em Agência → Suporte. Se não é, fale com o responsável pela sua agência." }, { "sintoma": "Aparece \"Configure sua chave CNPJa em Integrações → CNPJa.\" ou \"Configure seu token Apify em Integrações → Apify.\"", "causa": "", "solucao": "Falta a chave do serviço, ou ela está desativada. O dono ou um admin do workspace salva a chave no cartão CNPJA ou Apify (veja *Salvar as chaves em Integrações*)." }, { "sintoma": "Aparece \"Informe ao menos CNAE/nome, UF ou cidade.\", \"Para filtrar por cidade, informe também a UF.\" ou que a cidade não foi encontrada", "causa": "", "solucao": "Preencha pelo menos um filtro. A Cidade sempre precisa da UF, e o nome tem de ser o do município, como *São José dos Campos*; acentos e maiúsculas não importam. Se a busca termina sem lista, nenhuma empresa atende a todos os filtros: tire algum, como Telefone ou as datas." }, { "sintoma": "Aparece \"A CNPJa recusou a busca. Verifique os filtros, créditos ou a chave.\"", "causa": "", "solucao": "Confira se os créditos da sua conta na CNPJA acabaram, se a chave salva é a comercial e continua valendo e se o CNAE foi digitado inteiro, como *8630-5/01*. Depois de muitas buscas seguidas, espere alguns segundos e tente de novo." }, { "sintoma": "Aparece \"A busca no Google Maps falhou. Verifique o token Apify e os créditos.\"", "causa": "", "solucao": "Na sua conta da Apify, confira se o token salvo continua valendo e se ainda há créditos. A busca também falha quando passa de 20 minutos sem terminar." }, { "sintoma": "O botão de importar está desativado, ou aparece \"Nenhum lead selecionado tem o identificador escolhido.\"", "causa": "", "solucao": "O botão precisa de pelo menos uma empresa marcada, da permissão Criar contatos e de que não haja outra importação \"Em andamento\" na janela. A mensagem aparece quando nenhuma empresa marcada tem o dado escolhido em Identificador (deduplicação): do Google Maps não vêm e-mails, então escolha Telefone." }, { "sintoma": "Aparece \"Já existe uma importação em andamento.\"", "causa": "", "solucao": "O workspace roda uma importação de contatos por vez, contando as planilhas importadas em Contatos. Espere a outra terminar e clique em Importar de novo. Importe no máximo 1.000 empresas por vez: acima disso, a importação é recusada." } ], "para_ia": { "perguntas": [ "Prospectar empresas e importar como contatos?", "Aparece \"Prospecção Ativa não está habilitada neste plano.\"", "Aparece \"Configure sua chave CNPJa em Integrações → CNPJa.\" ou \"Configure seu token Apify em Integrações → Apify.\"", "Aparece \"Informe ao menos CNAE/nome, UF ou cidade.\", \"Para filtrar por cidade, informe também a UF.\" ou que a cidade não foi encontrada", "Aparece \"A CNPJa recusou a busca. Verifique os filtros, créditos ou a chave.\"" ], "resposta": "Encontre empresas pelo cadastro de CNPJ ou pelo Google Maps e importe as escolhidas como contatos, já com tags. No menu lateral, clique em Integrações e, no cartão CNPJA, em Configurar. Siga o quadro Como obter sua API Key e cole a chave comercial da CNPJA em API Key. A chave funciona como uma senha: não a compartilhe. Clique em Salvar integração e aguarde Integração salva. Para o Google Maps, faça o mesmo no cartão Apify, colando o token em API Token (veja o quadro Como obter seu token).", "escalar": [] }, "relacionados": [ "contatos", "disparo-em-massa" ], "markdown": "---\nslug: prospectar-empresas\ncategoria: Contatos e vendas\natualizado: 17/10/2026\ntags: prospecção, prospectar, cnpj, cnae, google maps, leads, empresas, importar contatos, outreach\nno_painel: Automações > Prospecção Ativa\nverificacao: baseado no guia oficial do painel\n---\n\n# Prospectar empresas e importar como contatos\n\nEncontre empresas pelo cadastro de CNPJ ou pelo Google Maps e importe as escolhidas como contatos, já com tags.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Você precisa ter acesso ao menu **Automações**. Se ele não aparece para você, peça a quem administra a sua equipe.\n- A Prospecção Ativa precisa estar incluída no plano do workspace.\n- Para buscar pelo CNPJ, tenha uma conta na CNPJA com uma chave comercial; para o Google Maps, uma conta na Apify. As buscas consomem os créditos dessas contas. Só o dono e os admins do workspace salvam as chaves em **Integrações**.\n- Para importar, você precisa da permissão **Criar contatos**; para aplicar tags, também de **Editar contatos**; para criar uma tag nova ali, de **Criar tags**. Por padrão, toda a equipe tem as três.\n\nA **Prospecção Ativa** encontra empresas para você oferecer o seu produto ou serviço. Você busca pelo cadastro de CNPJ, filtrando por atividade, estado, cidade e situação, ou pelo Google Maps, com um tipo de negócio e um local. Depois, importa as escolhidas como contatos, já com tags, para trabalhar a lista em **Contatos**, no pipeline ou num disparo.\n\nAs buscas usam as suas próprias contas na CNPJA (dados do CNPJ) e na Apify (Google Maps).\n\n> **Atenção:** Essas empresas nunca falaram com você. Mandar mensagem em massa para quem não pediu pode levar o WhatsApp a bloquear o número, como avisa a janela de importação. No WhatsApp pela API oficial, a primeira mensagem precisa ser um template aprovado: veja «Por que não consigo responder? A janela de 24 horas do WhatsApp oficial» (artigo `janela-24-horas`).\n\n## Salvar as chaves em Integrações\n\n1. No menu lateral, clique em **Integrações** e, no cartão **CNPJA**, em **Configurar**.\n2. Siga o quadro **Como obter sua API Key** e cole a chave comercial da CNPJA em **API Key**. A chave funciona como uma senha: não a compartilhe.\n3. Clique em **Salvar integração** e aguarde **Integração salva.**\n4. Para o Google Maps, faça o mesmo no cartão **Apify**, colando o token em **API Token** (veja o quadro **Como obter seu token**).\n\n## Buscar empresas pelo CNPJ\n\n1. No menu lateral, clique em **Automações** e depois no cartão **Prospecção Ativa**.\n2. Na aba **CNPJa (CNAE/UF)**, preencha ao menos um destes filtros:\n - **CNAE ou nome**: o código da atividade principal (o CNAE), como *8630-5/01*, ou uma palavra do nome, como *dentista*;\n - **UF**: a sigla do estado, como *SP*;\n - **Cidade**: o nome do município, sempre junto com a **UF**.\n3. Se quiser, ajuste **Situação**, que começa em **ATIVA**, **Telefone** (**Qualquer**, **Tem telefone**, **Celular** ou **Fixo**) e as datas **Aberta a partir de** e **Aberta até**.\n4. Clique em **Buscar**. Vêm até 100 empresas por vez, e ao lado do botão aparece quantas foram carregadas do total aproximado.\n5. Para trazer mais, clique em **Carregar mais**, no fim da lista.\n\n## Buscar no Google Maps\n\n1. Na mesma tela, clique na aba **Google Maps**.\n2. Em **Termo / categoria**, escreva o tipo de negócio, como *restaurante*, e em **Localização**, a cidade e o estado, como *Campinas, SP*.\n3. Em **Máx. resultados**, escolha de 1 a 200 lugares (o padrão é 50) e clique em **Buscar**.\n4. Fique nesta tela enquanto aparece \"Buscando no Google Maps… (pode levar até ~1 min)\". A lista aparece inteira no fim; se você sair antes, precisa buscar de novo.\n\nDo Google Maps vêm o nome, um telefone e o endereço, mas não o CNPJ nem o e-mail.\n\n## Importar como contatos\n\n1. Para conferir uma empresa, clique em **Detalhes**, na linha dela: aparecem todos os telefones, os e-mails e o endereço.\n2. Marque as empresas que quer importar, ou **Selecionar todos** para pegar as que estão carregadas.\n3. Clique no botão de importar, no alto da lista, que mostra quantas estão marcadas, como *Importar 25 contato(s)*.\n4. Em **Identificador (deduplicação)**, escolha **Telefone** ou **E-mail**. Só entram as empresas com esse dado, e de cada uma vão o primeiro telefone e o primeiro e-mail.\n5. Em **Tags**, clique nas tags que os contatos devem receber. Para uma nova, digite o nome em *Criar nova tag…* e clique em **Adicionar**.\n6. Leia o aviso e clique em **Importar**.\n7. Acompanhe na própria janela, que passa de \"Em andamento\" para \"Concluída\". Pode fechá-la e seguir usando o painel: a importação continua, e os contatos aparecem em **Contatos**.\n\nNa contagem, \"Importados\" são contatos novos, com nome, telefone (também como WhatsApp, com o 55 na frente), e-mail e, em **Notas**, CNPJ, CNAE, site, endereço e situação. \"Atualizados\" já eram contatos, pelo mesmo telefone ou e-mail: só ganham as tags, e os dados não mudam. \"Pulados\" não tinham o identificador ou passariam do limite de contatos do workspace. \"Erros\" não foram gravados, por exemplo quando o número bate com mais de um contato.\n\n## Não funcionou?\n\n- **Aparece \"Prospecção Ativa não está habilitada neste plano.\"**\n O recurso não está no plano deste workspace e não se libera em **Limites e addons**. Se você é o dono da conta, fale com o suporte em **Agência** → **Suporte**. Se não é, fale com o responsável pela sua agência.\n- **Aparece \"Configure sua chave CNPJa em Integrações → CNPJa.\" ou \"Configure seu token Apify em Integrações → Apify.\"**\n Falta a chave do serviço, ou ela está desativada. O dono ou um admin do workspace salva a chave no cartão **CNPJA** ou **Apify** (veja *Salvar as chaves em Integrações*).\n- **Aparece \"Informe ao menos CNAE/nome, UF ou cidade.\", \"Para filtrar por cidade, informe também a UF.\" ou que a cidade não foi encontrada**\n Preencha pelo menos um filtro. A **Cidade** sempre precisa da **UF**, e o nome tem de ser o do município, como *São José dos Campos*; acentos e maiúsculas não importam. Se a busca termina sem lista, nenhuma empresa atende a todos os filtros: tire algum, como **Telefone** ou as datas.\n- **Aparece \"A CNPJa recusou a busca. Verifique os filtros, créditos ou a chave.\"**\n Confira se os créditos da sua conta na CNPJA acabaram, se a chave salva é a comercial e continua valendo e se o CNAE foi digitado inteiro, como *8630-5/01*. Depois de muitas buscas seguidas, espere alguns segundos e tente de novo.\n- **Aparece \"A busca no Google Maps falhou. Verifique o token Apify e os créditos.\"**\n Na sua conta da Apify, confira se o token salvo continua valendo e se ainda há créditos. A busca também falha quando passa de 20 minutos sem terminar.\n- **O botão de importar está desativado, ou aparece \"Nenhum lead selecionado tem o identificador escolhido.\"**\n O botão precisa de pelo menos uma empresa marcada, da permissão **Criar contatos** e de que não haja outra importação \"Em andamento\" na janela. A mensagem aparece quando nenhuma empresa marcada tem o dado escolhido em **Identificador (deduplicação)**: do Google Maps não vêm e-mails, então escolha **Telefone**.\n- **Aparece \"Já existe uma importação em andamento.\"**\n O workspace roda uma importação de contatos por vez, contando as planilhas importadas em **Contatos**. Espere a outra terminar e clique em **Importar** de novo. Importe no máximo 1.000 empresas por vez: acima disso, a importação é recusada.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Prospectar empresas e importar como contatos?\n- Aparece \"Prospecção Ativa não está habilitada neste plano.\"\n- Aparece \"Configure sua chave CNPJa em Integrações → CNPJa.\" ou \"Configure seu token Apify em Integrações → Apify.\"\n- Aparece \"Informe ao menos CNAE/nome, UF ou cidade.\", \"Para filtrar por cidade, informe também a UF.\" ou que a cidade não foi encontrada\n- Aparece \"A CNPJa recusou a busca. Verifique os filtros, créditos ou a chave.\"\n\nResposta curta: Encontre empresas pelo cadastro de CNPJ ou pelo Google Maps e importe as escolhidas como contatos, já com tags. No menu lateral, clique em Integrações e, no cartão CNPJA, em Configurar. Siga o quadro Como obter sua API Key e cole a chave comercial da CNPJA em API Key. A chave funciona como uma senha: não a compartilhe. Clique em Salvar integração e aguarde Integração salva. Para o Google Maps, faça o mesmo no cartão Apify, colando o token em API Token (veja o quadro Como obter seu token).\n\nVeja também: «Importar, cadastrar e organizar contatos» (`contatos`); «Criar um disparo em massa e acompanhar o envio» (`disparo-em-massa`)\n" }, { "slug": "cobrar-e-colher-assinaturas", "categoria": "Contatos e vendas", "titulo": "Cobrar e colher assinaturas com InfinitePay e Autentique", "resumo": "Conecte as contas do seu negócio na InfinitePay e na Autentique para o agente de IA mandar links de pagamento e contratos para assinar na conversa.", "tags": [ "cobrança", "pagamento", "link de pagamento", "pix", "infinitepay", "autentique", "contrato", "assinatura digital", "boleto" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Integrações", "InfinitePay / Autentique" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O agente diz que o pagamento ainda está pendente, mas o cliente já pagou", "causa": "", "solucao": "Nos links novos, o painel recebe a notificação e consulta a InfinitePay antes de confirmar. Se continuar pendente, confira no aplicativo da InfinitePay e procure o suporte. Links antigos criados sem confirmação automática precisam de conferência manual; não ganham esse retorno retroativamente." }, { "sintoma": "O agente não consegue gerar o link de pagamento", "causa": "", "solucao": "Confira:\n- se a InfiniteTag (handle) está certa;\n- se o contato tem WhatsApp, telefone ou e-mail: a cobrança precisa de um deles;\n- se a integração não aparece como (desativada) e se a Function está Ativa e ligada ao agente." }, { "sintoma": "O contrato foi assinado, mas a automação não rodou", "causa": "", "solucao": "Na Autentique, confira se os dois endpoints usam a URL de Webhook atual, em JSON, com os eventos certos: Contrato assinado (Autentique) depende do endpoint DOCUMENT; visualização, assinatura recebida e recusa, do SIGNATURE. No painel, confira:\n- se os dois segredos estão em Segredo do webhook (HMAC), separados por vírgula: com um só, os avisos do outro endpoint são recusados;\n- se a integração está ativa;\n- se o contrato foi criado pela Function: contratos criados direto na Autentique não disparam os gatilhos." }, { "sintoma": "O agente não manda o contrato", "causa": "", "solucao": "No teste do agente, a Function de contrato é sempre simulada: para ver de verdade, escreva de um número seu para o canal do agente. Se não sair, confira a API Key, o e-mail em Signatário da empresa (email) e a cota de PDFs: sem cota, nenhum contrato é criado até o mês seguinte. Para aumentá-la, fale com o responsável pela sua agência." }, { "sintoma": "Removi a integração da Autentique e cadastrei de novo", "causa": "", "solucao": "A URL de Webhook muda. Atualize os dois endpoints na Autentique, cole de novo os segredos em Segredo do webhook (HMAC) e, na Function de contrato, escolha outra vez a Conexão Autentique. Até lá, o agente não cria contratos." }, { "sintoma": "Ao salvar, aparece \"workspace sem saldo pra integrações — contrate o addon\"", "causa": "", "solucao": "O plano deste workspace não libera integrações. Fale com o responsável pela sua agência." } ], "para_ia": { "perguntas": [ "Cobrar e colher assinaturas com InfinitePay e Autentique?", "O agente diz que o pagamento ainda está pendente, mas o cliente já pagou", "O agente não consegue gerar o link de pagamento", "O contrato foi assinado, mas a automação não rodou", "O agente não manda o contrato" ], "resposta": "Conecte as contas do seu negócio na InfinitePay e na Autentique para o agente de IA mandar links de pagamento e contratos para assinar na conversa. No menu lateral, clique em Integrações e, no cartão InfinitePay, clique em Configurar (ou em Gerenciar, se já estiver conectada). Em InfiniteTag (handle), cole a sua InfiniteTag, o nome da conta que aparece no fim do seu link de pagamento da InfinitePay, por exemplo minhaloja, com ou sem o $. Em Método preferido, escolha uma opção. Ela só fica anotada na cobrança: a forma de pagamento é escolhida na página da InfinitePay. Em Descrição padrão, escreva o texto da cobrança para quando o agente não disser o que cobra, por exemplo Pagamento referente a consulta.", "escalar": [ "Cobrança que não caiu ou valor contestado pelo cliente final" ] }, "relacionados": [ "functions-do-agente", "integracoes-e-provedores-de-ia" ], "markdown": "---\nslug: cobrar-e-colher-assinaturas\ncategoria: Contatos e vendas\natualizado: 17/10/2026\ntags: cobrança, pagamento, link de pagamento, pix, infinitepay, autentique, contrato, assinatura digital, boleto\nno_painel: Integrações > InfinitePay / Autentique\nverificacao: baseado no guia oficial do painel\n---\n\n# Cobrar e colher assinaturas com InfinitePay e Autentique\n\nConecte as contas do seu negócio na InfinitePay e na Autentique para o agente de IA mandar links de pagamento e contratos para assinar na conversa.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Só o dono e os admins do workspace configuram as integrações e criam as Functions. Para os outros, os campos e os botões ficam desativados.\n- Tenha conta na InfinitePay, na Autentique ou nas duas, em nome do seu negócio. A InfinitePay só atende empresas do Brasil e cobra em reais.\n- Tenha um agente de IA ligado ao canal. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n- Cada contrato gera um PDF e conta na cota mensal de PDFs do workspace, a mesma da Function **Gerar PDF**.\n\nCom a InfinitePay e a Autentique conectadas, o agente de IA manda links de pagamento e contratos para assinatura digital durante a conversa. As integrações usam as contas do seu negócio nesses serviços: o dinheiro cai na sua conta InfinitePay, e os contratos ficam na sua conta Autentique. Quando o contrato é assinado ou recusado, uma automação pode seguir o atendimento sozinha.\n\n> **Atenção:** As cobranças e os contratos são reais. No teste do agente, a Function da InfinitePay cria um link de pagamento de verdade na sua conta. Teste com um contato seu, confira o valor no link antes de usar com clientes e, na Autentique, deixe o **Modo sandbox (testes)** ligado até o contrato ficar certo.\n\n## Conectar a InfinitePay\n\n1. No menu lateral, clique em **Integrações** e, no cartão **InfinitePay**, clique em **Configurar** (ou em **Gerenciar**, se já estiver conectada).\n2. Em **InfiniteTag (handle)**, cole a sua InfiniteTag, o nome da conta que aparece no fim do seu link de pagamento da InfinitePay, por exemplo *minhaloja*, com ou sem o *$*.\n3. Em **Método preferido**, escolha uma opção. Ela só fica anotada na cobrança: a forma de pagamento é escolhida na página da InfinitePay.\n4. Em **Descrição padrão**, escreva o texto da cobrança para quando o agente não disser o que cobra, por exemplo *Pagamento referente a consulta*.\n5. Em **URL de redirect pós-pagamento**, cole o endereço, começando com *https://*, da página que o cliente vê depois de pagar, como a de agradecimento do seu site. Se deixar vazio, o painel não define um redirecionamento após o pagamento.\n6. Clique em **Salvar integração**. Os dados aparecem em **Integração cadastrada**.\n\n## Conectar a Autentique\n\n1. Na Autentique, em Configurações → Integrações/API, gere a sua chave de API. Ela funciona como senha: não a compartilhe.\n2. No painel, em **Integrações**, clique em **Configurar** no cartão **Autentique**. Cole a chave em **API Key** e clique em **Salvar integração**.\n3. Em **Integração cadastrada**, clique em **Copiar**, ao lado de **URL de Webhook**: é o endereço que a Autentique chama para avisar o painel sobre cada contrato.\n4. Na Autentique, em Configurações → Webhooks, crie dois endpoints com esse mesmo endereço, no formato JSON:\n - um do tipo SIGNATURE, com os eventos `signature.accepted`, `signature.rejected` e `signature.viewed`;\n - outro do tipo DOCUMENT, com o evento `document.finished`.\n5. A Autentique gera um segredo para cada endpoint. Volte ao painel, cole os dois em **Segredo do webhook (HMAC)**, separados por vírgula, e clique em **Salvar alterações**. Assim, o painel só aceita avisos da sua conta.\n6. Enquanto testa, marque **Modo sandbox (testes)** e salve: os documentos de teste não gastam os créditos do seu plano na Autentique e somem depois de alguns dias. Desmarque antes de usar com clientes.\n\n## Dar as ações ao agente\n\n1. Crie uma Function do tipo **InfinitePay — Pagamentos** e escolha a **Conta InfinitePay**. Para criar e ligar ao agente, veja «Dar ações ao agente com Functions» (artigo `functions-do-agente`).\n2. Para contratos, crie uma Function do tipo **Contrato p/ assinatura (Autentique)**, escolha a **Conexão Autentique** e escreva em **Corpo do contrato** o texto inteiro. Cada palavra entre chaves duplas, como `{{cpf}}` ou `{{valor}}`, vira um dado que o agente pede ao cliente. Já `{{contato.nome}}`, `{{contato.telefone}}`, `{{contato.email}}` e `{{data}}` são preenchidos sozinhos.\n3. Se quiser, preencha **Nome do documento**, **Nome da marca** e **Cor da marca (hex)**, que vão no PDF. Com um e-mail em **Signatário da empresa (email)**, a empresa também assina e recebe o link pela Autentique.\n4. Ligue as Functions ao agente.\n\nNa conversa, o agente manda ao cliente o link de pagamento. No contrato, ele coleta os dados, cria o documento na sua conta Autentique e manda o link de assinatura. Quando todos assinam, o PDF assinado chega na conversa.\n\n## Reagir ao pagamento confirmado\n\n1. Em **Automações**, crie um fluxo e, no bloco **Início**, escolha **Pagamento confirmado (InfinitePay)**.\n2. Escolha a **Conta InfinitePay** ou mantenha **Todas as contas** do workspace.\n3. Conecte uma mensagem, uma ação de etiqueta ou uma atualização no pipeline. O seletor de variáveis tem o grupo **Pagamento (InfinitePay)**, com valor, descrição, método e link do comprovante.\n4. Para o agente responder, adicione a ação **Injetar contexto na IA**, escolha o modo de responder uma vez ou responder e continuar e escreva, por exemplo: `O pagamento {{event.payload.payment_id}} no valor de {{event.payload.amount_brl}} reais foi confirmado. Agradeça e siga o atendimento.`\n5. Salve e ative o fluxo. Cada pagamento emite um único evento, mesmo que a InfinitePay repita a notificação. Sem fluxo ativo, o status fica disponível para consulta pela Function, mas o agente não envia uma mensagem sozinho.\n\nO retorno automático é anexado aos novos links gerados pela Function. Não é preciso cadastrar um webhook manualmente na conta InfinitePay. Links antigos sem esse retorno e pagamentos feitos fora da Function não acionam o gatilho. No playground, cobranças autorizadas continuam reais, mas contatos/conversas de teste não iniciam automações.\n\n## Reagir ao contrato com uma automação\n\n1. No menu lateral, clique em **Automações** e depois no cartão **Automação Básica**. Crie a automação como em «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (artigo `automacao-basica`).\n2. Em **Quando (gatilho)**, escolha um dos gatilhos da Autentique:\n - **Contrato enviado (Autentique)**: o agente mandou o contrato;\n - **Contrato visualizado (Autentique)**: aberto pela primeira vez;\n - **Assinatura recebida (Autentique)**: uma pessoa assinou, mas pode faltar a outra;\n - **Contrato assinado (Autentique)**: todos assinaram;\n - **Contrato recusado (Autentique)**: alguém recusou.\n3. Em **Então (passos)**, escolha o que fazer, como aplicar uma tag, mover no pipeline ou mandar uma mensagem, e salve.\n\n## Não funcionou?\n\n- **O agente diz que o pagamento ainda está pendente, mas o cliente já pagou**\n Nos links novos, o painel recebe a notificação e consulta a InfinitePay antes de confirmar. Se continuar pendente, confira no aplicativo da InfinitePay e procure o suporte. Links antigos criados sem confirmação automática precisam de conferência manual; não ganham esse retorno retroativamente.\n- **O agente não consegue gerar o link de pagamento**\n Confira:\n - se a **InfiniteTag (handle)** está certa;\n - se o contato tem WhatsApp, telefone ou e-mail: a cobrança precisa de um deles;\n - se a integração não aparece como **(desativada)** e se a Function está **Ativa** e ligada ao agente.\n- **O contrato foi assinado, mas a automação não rodou**\n Na Autentique, confira se os dois endpoints usam a **URL de Webhook** atual, em JSON, com os eventos certos: **Contrato assinado (Autentique)** depende do endpoint DOCUMENT; visualização, assinatura recebida e recusa, do SIGNATURE. No painel, confira:\n - se os dois segredos estão em **Segredo do webhook (HMAC)**, separados por vírgula: com um só, os avisos do outro endpoint são recusados;\n - se a integração está ativa;\n - se o contrato foi criado pela Function: contratos criados direto na Autentique não disparam os gatilhos.\n- **O agente não manda o contrato**\n No teste do agente, a Function de contrato é sempre simulada: para ver de verdade, escreva de um número seu para o canal do agente. Se não sair, confira a **API Key**, o e-mail em **Signatário da empresa (email)** e a cota de PDFs: sem cota, nenhum contrato é criado até o mês seguinte. Para aumentá-la, fale com o responsável pela sua agência.\n- **Removi a integração da Autentique e cadastrei de novo**\n A **URL de Webhook** muda. Atualize os dois endpoints na Autentique, cole de novo os segredos em **Segredo do webhook (HMAC)** e, na Function de contrato, escolha outra vez a **Conexão Autentique**. Até lá, o agente não cria contratos.\n- **Ao salvar, aparece \"workspace sem saldo pra integrações — contrate o addon\"**\n O plano deste workspace não libera integrações. Fale com o responsável pela sua agência.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Cobrar e colher assinaturas com InfinitePay e Autentique?\n- O agente diz que o pagamento ainda está pendente, mas o cliente já pagou\n- O agente não consegue gerar o link de pagamento\n- O contrato foi assinado, mas a automação não rodou\n- O agente não manda o contrato\n\nResposta curta: Conecte as contas do seu negócio na InfinitePay e na Autentique para o agente de IA mandar links de pagamento e contratos para assinar na conversa. No menu lateral, clique em Integrações e, no cartão InfinitePay, clique em Configurar (ou em Gerenciar, se já estiver conectada). Em InfiniteTag (handle), cole a sua InfiniteTag, o nome da conta que aparece no fim do seu link de pagamento da InfinitePay, por exemplo minhaloja, com ou sem o $. Em Método preferido, escolha uma opção. Ela só fica anotada na cobrança: a forma de pagamento é escolhida na página da InfinitePay. Em Descrição padrão, escreva o texto da cobrança para quando o agente não disser o que cobra, por exemplo Pagamento referente a consulta.\n\nEscalar para um humano quando:\n- Cobrança que não caiu ou valor contestado pelo cliente final\n\nVeja também: «Dar ações ao agente com Functions» (`functions-do-agente`); «Conectar um provedor de IA e outras integrações» (`integracoes-e-provedores-de-ia`)\n" }, { "slug": "medir-anuncios-com-a-meta", "categoria": "Contatos e vendas", "titulo": "Enviar à Meta os leads e as vendas dos seus anúncios", "resumo": "Ligue a Meta Conversions API para avisar a Meta quando quem veio de um anúncio do WhatsApp vira lead ou compra, e acompanhe cada envio.", "tags": [ "meta ads", "anúncios", "conversions api", "capi", "pixel", "lead", "compra", "click to whatsapp", "conversão", "gerenciador de anúncios" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Integrações", "Meta Conversions API" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Aparece \"Nenhum evento registrado. Ative a integração e os eventos desejados.\"", "causa": "", "solucao": "Nada que gera aviso aconteceu desde que você ligou a integração. Confira:\n- se o anúncio abre conversa num número da API Oficial Meta;\n- se os avisos estão marcados e salvos, e se a integração não aparece como (desativada);\n- se o ID em Restringir à WABA (ID opcional) é o da conta desse número: com o ID de outra conta, nada é registrado." }, { "sintoma": "Ao salvar, aparece \"Informe um Dataset ID numérico, um Access Token e, se desejar restringir a conta, um ID WABA numérico.\"", "causa": "", "solucao": "Os campos Dataset ID da conta WhatsApp e Restringir à WABA (ID opcional) aceitam só números, e o Access Token é obrigatório." }, { "sintoma": "Um aviso aparece como \"Falhou\"", "causa": "", "solucao": "O código embaixo dele diz o motivo:\n- começa com \"meta_http_\": a Meta recusou. Confira o Dataset ID da conta WhatsApp e o token, que precisa estar válido, ter acesso ao conjunto de dados e a permissão whatsapp_business_manage_events. Corrija, salve e clique em Tentar novamente;\n- \"event_expired_or_attempts_exhausted\": o aviso passou de sete dias ou esgotou as tentativas. Com mais de sete dias, ele não pode mais ser reenviado." }, { "sintoma": "Um aviso aparece como \"Não enviado\"", "causa": "", "solucao": "Com \"integration_or_event_disabled\", a integração foi desativada, ou aquele aviso desmarcado, antes do envio. Com \"integration_destination_changed\", o Dataset ID da conta WhatsApp, o código de teste ou a WABA mudaram depois que o aviso foi registrado. Esses avisos não são reenviados; os próximos seguem a configuração atual." }, { "sintoma": "O negócio foi ganho, mas não saiu Purchase", "causa": "", "solucao": "O aviso de compra só sai quando o negócio:\n- tem Valor, ou recebeu um Valor final (opcional) ao clicar em Marcar ganha;\n- está ligado à conversa do WhatsApp em que a pessoa chegou pelo anúncio. Nos detalhes do negócio, Abrir conversa mostra essa ligação; se aparece Iniciar conversa, não há conversa ligada. Os negócios que o agente de IA cria na conversa já nascem ligados a ela." }, { "sintoma": "Aparece \"Recebido pela Meta\", mas a conversão não aparece nos anúncios", "causa": "", "solucao": "Recebido pela Meta quer dizer só que a Meta aceitou o aviso: como ela atribui a conversão às campanhas é decisão dela. Se o código de teste ainda está preenchido, os avisos vão marcados como teste; apague o código e salve." } ], "para_ia": { "perguntas": [ "Enviar à Meta os leads e as vendas dos seus anúncios?", "Aparece \"Nenhum evento registrado. Ative a integração e os eventos desejados.\"", "Ao salvar, aparece \"Informe um Dataset ID numérico, um Access Token e, se desejar restringir a conta, um ID WABA numérico.\"", "Um aviso aparece como \"Falhou\"", "Um aviso aparece como \"Não enviado\"" ], "resposta": "Ligue a Meta Conversions API para avisar a Meta quando quem veio de um anúncio do WhatsApp vira lead ou compra, e acompanhe cada envio. No menu lateral, clique em Integrações e, no cartão Meta Conversions API, clique em Configurar (ou em Gerenciar, se já estiver conectada). Em Nome da Configuração, escreva um nome, por exemplo Anúncios do WhatsApp. Em Dataset ID da conta WhatsApp, cole o ID do conjunto de dados que o Gerenciador de Eventos mostra, só com números. Em Access Token, cole o token de acesso. Ele funciona como senha: quem o tiver manda eventos em nome da sua empresa. Depois de salvo, o campo volta vazio; para trocar o token, cole um novo.", "escalar": [] }, "relacionados": [ "entender-o-dashboard", "pipeline", "whatsapp-api-oficial" ], "markdown": "---\nslug: medir-anuncios-com-a-meta\ncategoria: Contatos e vendas\natualizado: 17/10/2026\ntags: meta ads, anúncios, conversions api, capi, pixel, lead, compra, click to whatsapp, conversão, gerenciador de anúncios\nno_painel: Integrações > Meta Conversions API\nverificacao: baseado no guia oficial do painel\n---\n\n# Enviar à Meta os leads e as vendas dos seus anúncios\n\nLigue a Meta Conversions API para avisar a Meta quando quem veio de um anúncio do WhatsApp vira lead ou compra, e acompanhe cada envio.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Só o dono e os admins do workspace configuram a integração e reenviam avisos. Para os outros, os campos e os botões ficam desativados.\n- Tenha um número conectado pela **API Oficial Meta** e anúncios que abrem conversa nele. Veja «Conectar o WhatsApp pela API Oficial Meta ou pela coexistência» (artigo `whatsapp-api-oficial`).\n- Na Meta, tenha, no Gerenciador de Eventos, o conjunto de dados (dataset) da sua conta do WhatsApp Business e um token de acesso a ele com a permissão `whatsapp_business_manage_events`.\n- O workspace tem uma configuração só. Para mudar algo, edite a que já existe.\n\nQuando alguém clica num anúncio seu que abre conversa no WhatsApp (Click-to-WhatsApp), a mensagem chega ao painel com a marca daquele clique. Com o cartão **Meta Conversions API**, o painel avisa a Meta quando essa pessoa vira lead e quando compra. Com esses avisos, a Meta mede quais anúncios trazem conversas e vendas e usa isso para otimizar as campanhas.\n\nOs avisos saem sozinhos, normalmente em até um minuto. O resumo também aparece na aba **Anúncios** do **Dashboard**, em **Entrega de eventos à Meta**. Veja «Entender o Dashboard: atendimento, negócios e anúncios» (artigo `entender-o-dashboard`).\n\n> **Atenção:** Os avisos só valem para conversas em que a pessoa chegou por um clique em anúncio, num número da **API Oficial Meta**, inclusive em coexistência. QR Code, Instagram e Messenger ficam de fora.\n\n## Ligar o envio de conversões\n\n1. No menu lateral, clique em **Integrações** e, no cartão **Meta Conversions API**, clique em **Configurar** (ou em **Gerenciar**, se já estiver conectada).\n2. Em **Nome da Configuração**, escreva um nome, por exemplo *Anúncios do WhatsApp*.\n3. Em **Dataset ID da conta WhatsApp**, cole o ID do conjunto de dados que o Gerenciador de Eventos mostra, só com números.\n4. Em **Access Token**, cole o token de acesso. Ele funciona como senha: quem o tiver manda eventos em nome da sua empresa. Depois de salvo, o campo volta vazio; para trocar o token, cole um novo.\n5. Se a empresa tem mais de uma conta do WhatsApp Business e só uma deve gerar avisos, cole o ID dela em **Restringir à WABA (ID opcional)**. Vazio, vale para todos os números da API Oficial do workspace.\n6. Marque os avisos que quer mandar:\n - **LeadSubmitted ao receber uma mensagem de anúncio**: sai quando chega a mensagem que a pessoa manda ao clicar no anúncio;\n - **LeadSubmitted ao responder campanha com origem de anúncio**: sai quando alguém que chegou por anúncio, nessa mesma conversa, responde a um disparo seu;\n - **Purchase ao ganhar negócio da conversa WhatsApp (com valor e moeda)**: sai quando um negócio ligado a essa conversa é marcado como ganho, com o valor e a moeda dele.\n7. Clique em **Salvar integração**.\n\nCada clique em anúncio gera no máximo um aviso de lead, mesmo quando as duas primeiras opções coincidem, e cada negócio gera no máximo um aviso de compra. Assim, o mesmo resultado não é contado duas vezes.\n\n## Testar com o código de teste\n\n1. No Gerenciador de Eventos da Meta, abra o conjunto de dados, vá à área de teste de eventos e copie o código de teste.\n2. No painel, cole o código em **Código de evento de teste (opcional; apague para enviar em produção)** e clique em **Salvar alterações**.\n3. De um celular que não seja o do número conectado, clique num anúncio seu que abre o WhatsApp e mande a mensagem.\n4. Em **Integração cadastrada**, clique em **Últimos envios à Meta** e depois em **Atualizar envios**. O aviso aparece com a marca **Teste** e, quando a Meta aceita, como **Recebido pela Meta**. Confira também na área de teste do Gerenciador de Eventos.\n5. Terminado o teste, apague o código e clique em **Salvar alterações**. Os avisos que ainda estavam na fila com o código ficam como **Não enviado**.\n\n## Acompanhar os envios\n\n1. Em **Últimos envios à Meta**, clique em **Atualizar envios** para ver os dez avisos mais recentes, com o tipo, a situação, a data e o número de tentativas.\n2. Veja a situação de cada um:\n - **Aguardando**, **Enviando** e **Aguardando nova tentativa**: o painel ainda está mandando e tenta de novo sozinho;\n - **Recebido pela Meta**: a Meta aceitou o aviso;\n - **Falhou**: o envio não deu certo, e embaixo aparece o código do erro;\n - **Não enviado**: a integração ou aquele aviso foi desligado, ou a configuração mudou, antes do envio.\n3. Num aviso **Falhou**, corrija a causa e clique em **Tentar novamente**. Só dá para reenviar avisos de até sete dias, com a integração ativa.\n\n## Não funcionou?\n\n- **Aparece \"Nenhum evento registrado. Ative a integração e os eventos desejados.\"**\n Nada que gera aviso aconteceu desde que você ligou a integração. Confira:\n - se o anúncio abre conversa num número da **API Oficial Meta**;\n - se os avisos estão marcados e salvos, e se a integração não aparece como **(desativada)**;\n - se o ID em **Restringir à WABA (ID opcional)** é o da conta desse número: com o ID de outra conta, nada é registrado.\n- **Ao salvar, aparece \"Informe um Dataset ID numérico, um Access Token e, se desejar restringir a conta, um ID WABA numérico.\"**\n Os campos **Dataset ID da conta WhatsApp** e **Restringir à WABA (ID opcional)** aceitam só números, e o **Access Token** é obrigatório.\n- **Um aviso aparece como \"Falhou\"**\n O código embaixo dele diz o motivo:\n - começa com \"meta_http_\": a Meta recusou. Confira o **Dataset ID da conta WhatsApp** e o token, que precisa estar válido, ter acesso ao conjunto de dados e a permissão `whatsapp_business_manage_events`. Corrija, salve e clique em **Tentar novamente**;\n - \"event_expired_or_attempts_exhausted\": o aviso passou de sete dias ou esgotou as tentativas. Com mais de sete dias, ele não pode mais ser reenviado.\n- **Um aviso aparece como \"Não enviado\"**\n Com \"integration_or_event_disabled\", a integração foi desativada, ou aquele aviso desmarcado, antes do envio. Com \"integration_destination_changed\", o **Dataset ID da conta WhatsApp**, o código de teste ou a WABA mudaram depois que o aviso foi registrado. Esses avisos não são reenviados; os próximos seguem a configuração atual.\n- **O negócio foi ganho, mas não saiu Purchase**\n O aviso de compra só sai quando o negócio:\n - tem **Valor**, ou recebeu um **Valor final (opcional)** ao clicar em **Marcar ganha**;\n - está ligado à conversa do WhatsApp em que a pessoa chegou pelo anúncio. Nos detalhes do negócio, **Abrir conversa** mostra essa ligação; se aparece **Iniciar conversa**, não há conversa ligada. Os negócios que o agente de IA cria na conversa já nascem ligados a ela.\n- **Aparece \"Recebido pela Meta\", mas a conversão não aparece nos anúncios**\n **Recebido pela Meta** quer dizer só que a Meta aceitou o aviso: como ela atribui a conversão às campanhas é decisão dela. Se o código de teste ainda está preenchido, os avisos vão marcados como teste; apague o código e salve.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Enviar à Meta os leads e as vendas dos seus anúncios?\n- Aparece \"Nenhum evento registrado. Ative a integração e os eventos desejados.\"\n- Ao salvar, aparece \"Informe um Dataset ID numérico, um Access Token e, se desejar restringir a conta, um ID WABA numérico.\"\n- Um aviso aparece como \"Falhou\"\n- Um aviso aparece como \"Não enviado\"\n\nResposta curta: Ligue a Meta Conversions API para avisar a Meta quando quem veio de um anúncio do WhatsApp vira lead ou compra, e acompanhe cada envio. No menu lateral, clique em Integrações e, no cartão Meta Conversions API, clique em Configurar (ou em Gerenciar, se já estiver conectada). Em Nome da Configuração, escreva um nome, por exemplo Anúncios do WhatsApp. Em Dataset ID da conta WhatsApp, cole o ID do conjunto de dados que o Gerenciador de Eventos mostra, só com números. Em Access Token, cole o token de acesso. Ele funciona como senha: quem o tiver manda eventos em nome da sua empresa. Depois de salvo, o campo volta vazio; para trocar o token, cole um novo.\n\nVeja também: «Entender o Dashboard: atendimento, negócios e anúncios» (`entender-o-dashboard`); «Acompanhar negócios no pipeline» (`pipeline`); «Conectar o WhatsApp pela API Oficial Meta ou pela coexistência» (`whatsapp-api-oficial`)\n" }, { "slug": "catalogo-de-produtos", "categoria": "Contatos e vendas", "titulo": "Montar o catálogo de produtos e deixar o agente consultar", "resumo": "Cadastre produtos com preço e fotos no seu próprio Supabase, organize em pastas e deixe o agente de IA consultar o catálogo e enviar as fotos.", "tags": [ "catálogo", "produtos", "preço", "fotos de produto", "estoque", "supabase", "agente consulta produtos", "vitrine" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Automações", "Catálogo de produtos" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "A tela mostra \"Conecte seu catálogo\"", "causa": "", "solucao": "O catálogo ainda não foi configurado, ou a integração do Supabase usada por ele foi desativada ou removida em Integrações. Se você é dono ou admin, ative a integração ou siga de novo os passos de Configurar o catálogo. Se não é, peça a um deles." }, { "sintoma": "A janela mostra \"Nenhuma conexão Supabase ativa. Cadastre uma em Integrações.\"", "causa": "", "solucao": "O workspace não tem integração do Supabase ativa. Clique em Integrações, na própria janela, cadastre ou ative a conexão e abra Configurar catálogo de novo." }, { "sintoma": "Ao verificar, aparece \"Atualize a estrutura no seu Supabase\"", "causa": "", "solucao": "O SQL não foi rodado nesse projeto, foi rodado em outro projeto ou está desatualizado. Copie o SQL de novo em Configurar catálogo, rode no SQL Editor do projeto certo e clique em Verificar e salvar. Os produtos que já existem ficam." }, { "sintoma": "Aparece \"Confira se a conexão está ativa e usa uma chave secreta válida do seu Supabase.\"", "causa": "", "solucao": "A integração tem uma chave pública do projeto (anon ou publishable), ou a chave secreta foi trocada no Supabase. Em Integrações, edite a integração do Supabase e cole em API Key a chave secreta atual do projeto." }, { "sintoma": "Aparece \"O espaço catalog-images precisa existir e ser privado no seu Supabase.\"", "causa": "", "solucao": "O espaço das imagens está público. No Storage do Supabase, deixe o espaço *catalog-images* privado e clique em Verificar e salvar. Rodar o SQL de novo cria o espaço quando ele não existe, mas não muda um espaço que já existe." }, { "sintoma": "Aparece \"A conexão precisa usar a URL HTTPS do seu projeto Supabase.\"", "causa": "", "solucao": "A URL do Projeto precisa ser só o endereço do projeto, no formato *https://abcdef.supabase.co*, sem nada depois. Corrija na integração do Supabase, em Integrações." }, { "sintoma": "Aparece \"Algumas imagens não puderam ser carregadas.\"", "causa": "", "solucao": "Clique em Atualizar. Se continuar, confira se os arquivos ainda estão no espaço *catalog-images* do seu Supabase: uma imagem apagada direto lá não volta. Remova a imagem do produto e adicione de novo." }, { "sintoma": "Depois de excluir, aparece \"Produto atualizado, mas alguns arquivos não puderam ser removidos do Storage.\"", "causa": "", "solucao": "O produto ou a imagem saiu do catálogo, mas o arquivo continuou no seu Supabase. Peça a quem administra o projeto Supabase para apagar, no Storage, os arquivos que sobraram no espaço *catalog-images*. Nada precisa ser refeito no painel." }, { "sintoma": "Aparece \"A pasta contém produtos ou não está mais disponível.\"", "causa": "", "solucao": "Só uma pasta vazia pode ser excluída, e isso inclui os produtos inativos. Escolha a pasta na lista, deixe Disponibilidade em Todos, use Mover para pasta em cada produto, clique em Atualizar e exclua a pasta." }, { "sintoma": "Ao criar ou renomear uma pasta, aparece \"Já existe um registro com esse identificador.\"", "causa": "", "solucao": "Já existe uma pasta com esse nome, mesmo que escrita com maiúsculas e minúsculas diferentes. Escolha outro nome." }, { "sintoma": "Aparece \"O produto foi alterado ou excluído por outra pessoa.\"", "causa": "", "solucao": "Alguém mudou o produto depois que você abriu a ficha, pelo painel ou direto no Supabase. Feche a ficha, clique em Atualizar e refaça a sua mudança." }, { "sintoma": "O agente diz que não encontrou um produto que existe", "causa": "", "solucao": "Confira se:\n- o produto está com Ativo marcado: o agente não vê produtos inativos;\n- o produto está na pasta escolhida em Pasta do catálogo, na Function. Se o campo mostra Pasta indisponível, a pasta foi excluída ou o catálogo está sem conexão: confira o catálogo, escolha a pasta de novo e salve;\n- o cliente citou o nome, o código ou a categoria: palavras que só estão na descrição não entram na busca;\n- a Function está Ativa em Suas functions e com a chave ligada em Functions habilitadas, na seção Ferramentas do agente." } ], "para_ia": { "perguntas": [ "Montar o catálogo de produtos e deixar o agente consultar?", "A tela mostra \"Conecte seu catálogo\"", "A janela mostra \"Nenhuma conexão Supabase ativa. Cadastre uma em Integrações.\"", "Ao verificar, aparece \"Atualize a estrutura no seu Supabase\"", "Aparece \"Confira se a conexão está ativa e usa uma chave secreta válida do seu Supabase.\"" ], "resposta": "Cadastre produtos com preço e fotos no seu próprio Supabase, organize em pastas e deixe o agente de IA consultar o catálogo e enviar as fotos. No menu lateral, clique em Automações e depois no cartão Catálogo de produtos. Clique em Configurar catálogo, no alto da tela. Na primeira vez, você também pode clicar em Configurar conexão, no meio da tela. Clique em Preparar meu Supabase (SQL) para abrir o SQL e depois em Copiar SQL. O botão muda para Copiado. No Supabase, abra o seu projeto, entre no SQL Editor, cole o SQL e rode. Ele cria no seu projeto as tabelas de produtos e de pastas e um espaço privado para as imagens, chamado catalog-images, e fecha esses dados para as chaves públicas do projeto. Pode rodar de novo quando precisar: os produtos que já existem ficam.", "escalar": [] }, "relacionados": [ "functions-do-agente", "consultar-a-base-de-dados", "ligar-seus-dados-ao-agente" ], "markdown": "---\nslug: catalogo-de-produtos\ncategoria: Contatos e vendas\natualizado: 17/10/2026\ntags: catálogo, produtos, preço, fotos de produto, estoque, supabase, agente consulta produtos, vitrine\nno_painel: Automações > Catálogo de produtos\nverificacao: baseado no guia oficial do painel\n---\n\n# Montar o catálogo de produtos e deixar o agente consultar\n\nCadastre produtos com preço e fotos no seu próprio Supabase, organize em pastas e deixe o agente de IA consultar o catálogo e enviar as fotos.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- O projeto Supabase precisa estar conectado em **Integrações**, no cartão **Supabase**, com a **URL do Projeto** e, em **API Key**, a chave secreta do projeto (a que começa com *sb_secret_* ou a antiga *service_role*). Veja «Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp» (artigo `ligar-seus-dados-ao-agente`).\n- Só o dono e os admins do workspace configuram a conexão do catálogo e criam a Function do agente.\n- As outras pessoas precisam das permissões do grupo **Catálogo de produtos**, nas permissões do membro, em **Equipe**: **Ver produtos** abre a tela; **Criar produtos** libera **Novo produto** e **Nova pasta**; **Editar produtos** libera editar, mover, renomear pastas e adicionar ou remover imagens; **Excluir produtos** libera excluir produtos e pastas. Donos e admins já têm todas; quem tem o papel Agente começa sem nenhuma. Veja «Convidar pessoas para a equipe e definir o que cada uma acessa» (artigo `convidar-equipe`).\n- Quem tem **Ver produtos**, mas não as outras automações, vê o menu **Automações** só com o cartão do catálogo.\n- Para o agente consultar o catálogo, tenha um agente de IA criado. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\nO **Catálogo de produtos** guarda nome, código, preço, descrição e fotos dos seus produtos no projeto Supabase da sua empresa. Os produtos e as imagens ficam só no seu projeto: o painel guarda apenas qual conexão usar. A equipe cadastra e organiza os produtos em pastas, e o agente de IA consulta o catálogo para responder sobre produtos e preços e enviar as fotos na conversa.\n\n> **Atenção:** O que você salva ou exclui no catálogo grava na hora no seu projeto Supabase. Excluir um produto apaga também as imagens dele no Supabase, e não tem desfazer.\n\n> **Atenção:** A chave secreta funciona como senha e dá acesso a todo o seu projeto Supabase, não só ao catálogo. Não a compartilhe nem a cole fora do campo **API Key**.\n\n## Configurar o catálogo (dono ou admin)\n\n1. No menu lateral, clique em **Automações** e depois no cartão **Catálogo de produtos**.\n2. Clique em **Configurar catálogo**, no alto da tela. Na primeira vez, você também pode clicar em **Configurar conexão**, no meio da tela.\n3. Clique em **Preparar meu Supabase (SQL)** para abrir o SQL e depois em **Copiar SQL**. O botão muda para **Copiado**.\n4. No Supabase, abra o seu projeto, entre no SQL Editor, cole o SQL e rode. Ele cria no seu projeto as tabelas de produtos e de pastas e um espaço privado para as imagens, chamado *catalog-images*, e fecha esses dados para as chaves públicas do projeto. Pode rodar de novo quando precisar: os produtos que já existem ficam.\n5. De volta ao painel, em **Conexão Supabase**, escolha a conexão.\n6. Clique em **Verificar e salvar**. O painel confere se a estrutura está no projeto e se o espaço das imagens é privado. Deu certo quando a janela fecha e a tela mostra \"Conectado a\" com o nome da conexão.\n\nPara trocar o projeto do catálogo, rode o SQL no projeto novo, abra **Configurar catálogo**, escolha a outra conexão em **Conexão Supabase**, clique em **Verificar e salvar** e confirme em **Continuar**. Os produtos e as imagens ficam no projeto anterior: a troca não leva nada junto. Se em vez disso você mudar a **URL do Projeto** da integração, em **Integrações**, o catálogo passa a usar o novo projeto sem esse aviso.\n\n## Cadastrar um produto\n\n1. Clique em **Novo produto**.\n2. Em **Pasta**, escolha a pasta ou deixe **Sem pasta**. Se a lista estava mostrando uma pasta, ela já vem escolhida.\n3. Preencha **Nome**, que é obrigatório, e, se quiser, **Código / SKU**, **Categoria** e **Descrição**.\n4. Em **Preço**, digite o valor e escolha a **Moeda**: real, euro ou dólar americano. Deixe o preço vazio para o produto aparecer como **Preço sob consulta**.\n5. Deixe **Ativo** marcado para o produto aparecer como disponível e entrar nas consultas do agente. Desmarque para tirar o produto de linha sem apagar.\n6. Clique em **Salvar produto**. A ficha continua aberta, agora com as imagens liberadas.\n\n## Adicionar imagens\n\n1. Na ficha do produto, em **Imagens**, clique em **Adicionar imagem** e escolha o arquivo. Cada produto aceita até 8 imagens, em JPEG, PNG ou WebP, com até 5 MB cada.\n2. Repita para as outras imagens. A primeira é a capa, que aparece no cartão do produto.\n3. Para tirar uma imagem, clique em **Remover imagem**, embaixo dela, e confirme em **Excluir**. Ela sai do produto e do seu Supabase.\n\nPara o agente enviar as fotos na conversa, prefira imagens JPEG ou PNG.\n\n## Buscar e filtrar\n\n1. Em **Buscar por nome, código ou categoria**, digite parte do texto e clique em **Buscar**. A busca não olha a descrição.\n2. Em **Disponibilidade**, escolha **Todos**, **Ativo** ou **Inativo**.\n3. Na lista de pastas, acima da busca, escolha **Todas as pastas**, **Sem pasta** ou uma pasta.\n4. Use **Anterior** e **Próxima** para trocar de página. Cada página mostra até 24 produtos, dos mais novos para os mais antigos.\n5. Para ver mudanças feitas por outra pessoa ou direto no Supabase, clique em **Atualizar**.\n\n## Editar e organizar em pastas\n\n1. Para criar uma pasta, clique em **Nova pasta**, escreva o **Nome da pasta** e clique em **Salvar pasta**. A lista passa a mostrar essa pasta. Duas pastas não podem ter o mesmo nome.\n2. Para renomear ou excluir uma pasta, escolha a pasta na lista e clique em **Renomear pasta** ou **Excluir pasta**. Para excluir, confirme em **Excluir**: só uma pasta vazia pode ser excluída.\n3. Para mudar um produto de pasta, clique em **Mover para pasta**, no cartão dele, escolha a **Pasta de destino** e clique em **Mover produto**. Aparece **Produto movido.**\n4. Para alterar um produto, clique em **Editar**, no cartão, mude os campos e clique em **Salvar produto**. A pasta também pode ser trocada aqui. Quem não tem **Editar produtos** vê **Visualizar** e só consulta.\n\n## Excluir um produto\n\n1. No cartão do produto, clique em **Excluir**.\n2. Confirme em **Excluir**. O produto e as imagens dele saem do seu Supabase, sem volta.\n\n## Deixar o agente consultar o catálogo (dono ou admin)\n\n1. No menu lateral, clique em **Agentes IA** e depois em **Functions**.\n2. Clique em **Nova function** e preencha **Nome da function**, **Nome amigável** e **Descrição (quando a IA deve usar)**, como em «Dar ações ao agente com Functions» (artigo `functions-do-agente`). Na descrição, escreva por exemplo *Use quando o cliente perguntar por produtos, preços ou fotos*.\n3. Em **Tipo de function**, escolha **Consultar catálogo**. Ela usa sozinha a conexão configurada no catálogo: não há conexão para escolher.\n4. Em **Pasta do catálogo**, deixe **Todas as pastas** ou escolha uma pasta para o agente ver só os produtos dela.\n5. Clique em **Criar function**.\n6. Abra o agente em **Agentes IA**, clique na seção **Ferramentas** e, em **Functions habilitadas**, ligue a chave da Function. A mudança vale na hora, sem precisar salvar.\n\nA Function só lê o catálogo: o agente não cria, não altera nem exclui produtos. Ele vê apenas os produtos marcados como **Ativo** e busca por nome, código ou categoria. Quando apresenta um produto ou o cliente pede fotos, o agente envia as imagens do produto na conversa como fotos, e não como link. No teste do agente, a consulta roda de verdade mesmo com **Permitir uso de Functions** desligado, porque só lê.\n\nPara agentes diferentes verem pastas diferentes, crie uma Function para cada pasta e ligue cada uma ao agente certo.\n\n## Não funcionou?\n\n- **A tela mostra \"Conecte seu catálogo\"**\n O catálogo ainda não foi configurado, ou a integração do Supabase usada por ele foi desativada ou removida em **Integrações**. Se você é dono ou admin, ative a integração ou siga de novo os passos de Configurar o catálogo. Se não é, peça a um deles.\n- **A janela mostra \"Nenhuma conexão Supabase ativa. Cadastre uma em Integrações.\"**\n O workspace não tem integração do Supabase ativa. Clique em **Integrações**, na própria janela, cadastre ou ative a conexão e abra **Configurar catálogo** de novo.\n- **Ao verificar, aparece \"Atualize a estrutura no seu Supabase\"**\n O SQL não foi rodado nesse projeto, foi rodado em outro projeto ou está desatualizado. Copie o SQL de novo em **Configurar catálogo**, rode no SQL Editor do projeto certo e clique em **Verificar e salvar**. Os produtos que já existem ficam.\n- **Aparece \"Confira se a conexão está ativa e usa uma chave secreta válida do seu Supabase.\"**\n A integração tem uma chave pública do projeto (anon ou publishable), ou a chave secreta foi trocada no Supabase. Em **Integrações**, edite a integração do Supabase e cole em **API Key** a chave secreta atual do projeto.\n- **Aparece \"O espaço catalog-images precisa existir e ser privado no seu Supabase.\"**\n O espaço das imagens está público. No Storage do Supabase, deixe o espaço *catalog-images* privado e clique em **Verificar e salvar**. Rodar o SQL de novo cria o espaço quando ele não existe, mas não muda um espaço que já existe.\n- **Aparece \"A conexão precisa usar a URL HTTPS do seu projeto Supabase.\"**\n A **URL do Projeto** precisa ser só o endereço do projeto, no formato *https://abcdef.supabase.co*, sem nada depois. Corrija na integração do Supabase, em **Integrações**.\n- **Aparece \"Algumas imagens não puderam ser carregadas.\"**\n Clique em **Atualizar**. Se continuar, confira se os arquivos ainda estão no espaço *catalog-images* do seu Supabase: uma imagem apagada direto lá não volta. Remova a imagem do produto e adicione de novo.\n- **Depois de excluir, aparece \"Produto atualizado, mas alguns arquivos não puderam ser removidos do Storage.\"**\n O produto ou a imagem saiu do catálogo, mas o arquivo continuou no seu Supabase. Peça a quem administra o projeto Supabase para apagar, no Storage, os arquivos que sobraram no espaço *catalog-images*. Nada precisa ser refeito no painel.\n- **Aparece \"A pasta contém produtos ou não está mais disponível.\"**\n Só uma pasta vazia pode ser excluída, e isso inclui os produtos inativos. Escolha a pasta na lista, deixe **Disponibilidade** em **Todos**, use **Mover para pasta** em cada produto, clique em **Atualizar** e exclua a pasta.\n- **Ao criar ou renomear uma pasta, aparece \"Já existe um registro com esse identificador.\"**\n Já existe uma pasta com esse nome, mesmo que escrita com maiúsculas e minúsculas diferentes. Escolha outro nome.\n- **Aparece \"O produto foi alterado ou excluído por outra pessoa.\"**\n Alguém mudou o produto depois que você abriu a ficha, pelo painel ou direto no Supabase. Feche a ficha, clique em **Atualizar** e refaça a sua mudança.\n- **O agente diz que não encontrou um produto que existe**\n Confira se:\n - o produto está com **Ativo** marcado: o agente não vê produtos inativos;\n - o produto está na pasta escolhida em **Pasta do catálogo**, na Function. Se o campo mostra **Pasta indisponível**, a pasta foi excluída ou o catálogo está sem conexão: confira o catálogo, escolha a pasta de novo e salve;\n - o cliente citou o nome, o código ou a categoria: palavras que só estão na descrição não entram na busca;\n - a Function está **Ativa** em **Suas functions** e com a chave ligada em **Functions habilitadas**, na seção **Ferramentas** do agente.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Montar o catálogo de produtos e deixar o agente consultar?\n- A tela mostra \"Conecte seu catálogo\"\n- A janela mostra \"Nenhuma conexão Supabase ativa. Cadastre uma em Integrações.\"\n- Ao verificar, aparece \"Atualize a estrutura no seu Supabase\"\n- Aparece \"Confira se a conexão está ativa e usa uma chave secreta válida do seu Supabase.\"\n\nResposta curta: Cadastre produtos com preço e fotos no seu próprio Supabase, organize em pastas e deixe o agente de IA consultar o catálogo e enviar as fotos. No menu lateral, clique em Automações e depois no cartão Catálogo de produtos. Clique em Configurar catálogo, no alto da tela. Na primeira vez, você também pode clicar em Configurar conexão, no meio da tela. Clique em Preparar meu Supabase (SQL) para abrir o SQL e depois em Copiar SQL. O botão muda para Copiado. No Supabase, abra o seu projeto, entre no SQL Editor, cole o SQL e rode. Ele cria no seu projeto as tabelas de produtos e de pastas e um espaço privado para as imagens, chamado catalog-images, e fecha esses dados para as chaves públicas do projeto. Pode rodar de novo quando precisar: os produtos que já existem ficam.\n\nVeja também: «Dar ações ao agente com Functions» (`functions-do-agente`); «Consultar e editar as tabelas do seu Supabase no painel» (`consultar-a-base-de-dados`); «Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp» (`ligar-seus-dados-ao-agente`)\n" }, { "slug": "agentes-de-voz-e-ligacoes", "categoria": "Agentes de IA", "titulo": "Agentes de voz: atender e fazer ligações com IA", "resumo": "Crie um agente de voz que atende ligações com IA no site, no WhatsApp ou num número Twilio, teste a voz no painel e faça a IA ligar para clientes.", "tags": [ "voz", "ligação", "telefone", "agente de voz", "twilio", "chamada", "ligar para cliente", "voip", "elevenlabs" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Agentes IA", "Agentes de voz" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O teste mostra um aviso em vermelho e não começa", "causa": "", "solucao": "Leia o aviso:\n- Falha ao iniciar a chamada: em geral, o navegador bloqueou o microfone. Libere-o no ícone ao lado do endereço e tente de novo.\n- Se ele pede um agente de IA ou a chave em Integrações, veja *Antes de começar* e o próximo item.\n- Muitas tentativas em sequência. Aguarde alguns segundos e tente de novo.: espere um minuto.\n- Outro aviso, quase sempre em inglês, vem do provedor: confira a chave e o saldo no site dele." }, { "sintoma": "O agente de voz não atende", "causa": "", "solucao": "Veja o cartão do agente:\n- Se aparece \"Selecione um agente de IA em Editar para habilitar as respostas nas chamadas.\", clique em Editar, escolha o Agente de IA e salve.\n- Se aparece Desativado, ligue a chave Ativo. Desativado, o agente não atende nem liga, e as ligações do WhatsApp vão para a equipe." }, { "sintoma": "O botão de ligação não aparece no meu site", "causa": "", "solucao": "Confira se o endereço do site, como aparece no navegador, está em Domínios permitidos, e se o código colado é o atual: depois de Regenerar chave, ele muda." }, { "sintoma": "A ligação para o número Twilio não chega ao agente", "causa": "", "solucao": "Confira:\n- se o Número Twilio (E.164) está igual ao da Twilio, com + e sem espaços nem traços;\n- se, em A call comes in, está o endereço completo, começando com *https://*, com HTTP POST;\n- se Account SID e Auth Token são da conta Twilio dona do número;\n- se o número não está em outro agente de voz: ele só pode ficar em um." }, { "sintoma": "O botão Novo agente de voz está desativado", "causa": "", "solucao": "Agentes de IA e de voz dividem as vagas do workspace, e elas acabaram: ao passar o mouse, o botão mostra Limite compartilhado de agentes do plano atingido. Remova um agente sem uso ou peça mais vagas. O dono da conta libera um addon de Agentes IA, como em «Liberar um addon no workspace»; quem não é o dono fala com o responsável pela sua agência." } ], "para_ia": { "perguntas": [ "Agentes de voz?", "O teste mostra um aviso em vermelho e não começa", "O agente de voz não atende", "O botão de ligação não aparece no meu site", "A ligação para o número Twilio não chega ao agente" ], "resposta": "Crie um agente de voz que atende ligações com IA no site, no WhatsApp ou num número Twilio, teste a voz no painel e faça a IA ligar para clientes. No menu lateral, clique em Conexões e depois no cartão Voz. Clique em Novo agente de voz (ou em Criar primeiro agente, se a lista estiver vazia). Em Nome do agente, escreva um nome interno, por exemplo Atendimento por telefone. Em Agente de IA, escolha o agente que vai atender.", "escalar": [ "Problema com número de telefone ou operadora" ] }, "relacionados": [ "criar-agente", "functions-do-agente" ], "markdown": "---\nslug: agentes-de-voz-e-ligacoes\ncategoria: Agentes de IA\natualizado: 17/10/2026\ntags: voz, ligação, telefone, agente de voz, twilio, chamada, ligar para cliente, voip, elevenlabs\nno_painel: Agentes IA > Agentes de voz\nverificacao: baseado no guia oficial do painel\n---\n\n# Agentes de voz: atender e fazer ligações com IA\n\nCrie um agente de voz que atende ligações com IA no site, no WhatsApp ou num número Twilio, teste a voz no painel e faça a IA ligar para clientes.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Você precisa ter acesso ao menu **Conexões**. Se ele não aparece para você, peça a quem administra a sua equipe.\n- Tenha um agente de IA de **Atendimento a clientes** pronto: veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`). O **Modelo** dele não vale nas ligações: a voz usa o modelo escolhido aqui.\n- Tenha em **Integrações** a chave do provedor da voz: **OpenAI**, **Google Gemini** (para o **Gemini Live**) ou **xAI Grok** (para o **Grok Voice**). As ligações, inclusive os testes, são cobradas na conta desse provedor. Veja «Conectar um provedor de IA e outras integrações» (artigo `integracoes-e-provedores-de-ia`).\n\nUm agente de voz conversa com os seus clientes por ligação, seguindo as instruções, as functions e a base de conhecimento de um agente de IA. Ele atende no seu site, no WhatsApp ou num número da Twilio, e também liga para os clientes. As ligações atendidas ficam em **Conversas**, com a transcrição.\n\n## Criar o agente de voz\n\n1. No menu lateral, clique em **Conexões** e depois no cartão **Voz**.\n2. Clique em **Novo agente de voz** (ou em **Criar primeiro agente**, se a lista estiver vazia).\n3. Em **Nome do agente**, escreva um nome interno, por exemplo *Atendimento por telefone*.\n4. Em **Agente de IA**, escolha o agente que vai atender.\n5. Em **Motor de voz**, escolha o motor. Depois confira o **Idioma** e escolha o **Modelo** e a **Voz**.\n6. Na aba **Conversa**, ajuste a **Primeira mensagem (saudação)**, que o agente fala ao atender, e a **Duração máxima da chamada (segundos)**. O padrão é 600 (10 minutos); no limite, o agente se despede e desliga.\n7. Clique em **Criar agente**.\n\n## Testar a voz no painel\n\n1. No cartão do agente, clique em **Testar voz**. O teste abre no topo da página, com uma tela de celular.\n2. Clique em **Iniciar chamada de teste** e permita o microfone, se o navegador pedir.\n3. Quando aparecer **Em chamada**, fale como um cliente. O que vocês dizem aparece em **Transcrição**.\n4. Clique em **Desligar** para encerrar e em **Fechar** para sair do teste.\n\n> **Dica:** O teste usa o que está salvo, não cria contato nem conversa, só simula as ações das functions e funciona até com o agente desativado.\n\n## Colocar o botão de ligação no seu site\n\n1. No cartão do agente, clique em **Editar** e abra a aba **Widget no site**.\n2. Ajuste **Texto do botão**, **Texto auxiliar**, **Cor** e **Posição**.\n3. Em **Domínios permitidos**, escreva o domínio do seu site, um por linha. Se ele abre com e sem *www*, escreva os dois, por exemplo *meusite.com* e *www.meusite.com*.\n4. Clique em **Salvar alterações**.\n5. No cartão do agente, clique em **Instalar no site** e em **Copiar código**. Cole o código nas páginas do site, antes de ``, ou peça isso a quem cuida do site.\n\n> **Atenção:** Com **Domínios permitidos** vazio, o botão não aparece em nenhum site: só funciona no link **Abrir página de teste**, no rodapé do cartão. E, depois de **Regenerar chave**, o código antigo para de funcionar.\n\n## Atender e ligar por um número Twilio\n\n1. No menu lateral, clique em **Integrações** e, no cartão **Twilio**, em **Configurar**. Preencha **Account SID** e **Auth Token**, do console da Twilio, e clique em **Salvar integração**.\n2. Em **Conexões** → **Voz**, clique em **Editar** no agente e abra a aba **Canais**.\n3. Em **Canal de ligação**, escolha **Twilio (telefonia)**.\n4. Em **Número Twilio (E.164)**, digite o número com + e o código do país, sem espaços, por exemplo *+5511999999999*. Clique em **Salvar alterações**.\n5. Monte o endereço do webhook, para onde a Twilio avisa das ligações: copie o endereço desta página, no navegador, e troque o final `/app/connections/voice` pelo caminho que a tela mostra embaixo do número, `/webhooks/voice/twilio/incoming`.\n6. No console da Twilio, abra o número e, em **A call comes in**, cole esse endereço e escolha **HTTP POST**. Salve.\n7. Ligue para o número para testar. A ligação aparece em **Conversas**.\n\n## Atender pelo WhatsApp e ligar para clientes\n\nPara atender pelo WhatsApp, escolha em **Canal de ligação** a opção **WhatsApp (ligações WABA)**, da API oficial, ou **WhatsApp (QR)**, e depois a conexão. Na conexão, ative também as ligações: **Habilitar ligações (Calling)** na API oficial, que depende de a Meta liberar, ou **Habilitar ligações**, na seção **Ligações** da conexão QR Code. Isso pode depender de um addon: o dono da conta libera como em «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`), e quem não é o dono fala com o responsável pela sua agência.\n\nPara a IA ligar para um cliente, use a ação **Ligar com IA** numa automação ou, nas conversas da API oficial com ligações ativas, o botão **Ligar com IA**, no topo da conversa.\n\n## Não funcionou?\n\n- **O teste mostra um aviso em vermelho e não começa**\n Leia o aviso:\n - **Falha ao iniciar a chamada**: em geral, o navegador bloqueou o microfone. Libere-o no ícone ao lado do endereço e tente de novo.\n - Se ele pede um agente de IA ou a chave em **Integrações**, veja *Antes de começar* e o próximo item.\n - **Muitas tentativas em sequência. Aguarde alguns segundos e tente de novo.**: espere um minuto.\n - Outro aviso, quase sempre em inglês, vem do provedor: confira a chave e o saldo no site dele.\n- **O agente de voz não atende**\n Veja o cartão do agente:\n - Se aparece \"Selecione um agente de IA em Editar para habilitar as respostas nas chamadas.\", clique em **Editar**, escolha o **Agente de IA** e salve.\n - Se aparece **Desativado**, ligue a chave **Ativo**. Desativado, o agente não atende nem liga, e as ligações do WhatsApp vão para a equipe.\n- **O botão de ligação não aparece no meu site**\n Confira se o endereço do site, como aparece no navegador, está em **Domínios permitidos**, e se o código colado é o atual: depois de **Regenerar chave**, ele muda.\n- **A ligação para o número Twilio não chega ao agente**\n Confira:\n - se o **Número Twilio (E.164)** está igual ao da Twilio, com + e sem espaços nem traços;\n - se, em **A call comes in**, está o endereço completo, começando com *https://*, com **HTTP POST**;\n - se **Account SID** e **Auth Token** são da conta Twilio dona do número;\n - se o número não está em outro agente de voz: ele só pode ficar em um.\n- **O botão Novo agente de voz está desativado**\n Agentes de IA e de voz dividem as vagas do workspace, e elas acabaram: ao passar o mouse, o botão mostra **Limite compartilhado de agentes do plano atingido**. Remova um agente sem uso ou peça mais vagas. O dono da conta libera um addon de **Agentes IA**, como em «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`); quem não é o dono fala com o responsável pela sua agência.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Agentes de voz?\n- O teste mostra um aviso em vermelho e não começa\n- O agente de voz não atende\n- O botão de ligação não aparece no meu site\n- A ligação para o número Twilio não chega ao agente\n\nResposta curta: Crie um agente de voz que atende ligações com IA no site, no WhatsApp ou num número Twilio, teste a voz no painel e faça a IA ligar para clientes. No menu lateral, clique em Conexões e depois no cartão Voz. Clique em Novo agente de voz (ou em Criar primeiro agente, se a lista estiver vazia). Em Nome do agente, escreva um nome interno, por exemplo Atendimento por telefone. Em Agente de IA, escolha o agente que vai atender.\n\nEscalar para um humano quando:\n- Problema com número de telefone ou operadora\n\nVeja também: «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Dar ações ao agente com Functions» (`functions-do-agente`)\n" }, { "slug": "ligar-seus-dados-ao-agente", "categoria": "Agentes de IA", "titulo": "Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp", "resumo": "Conecte Google Workspace, Notion, Baserow, Supabase, n8n ou ClickUp e crie a Function para o agente de IA consultar e alterar esses dados.", "tags": [ "google workspace", "drive", "planilha", "sheets", "docs", "notion", "baserow", "supabase", "n8n", "clickup", "dados do agente", "mcp" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Integrações", "Agentes IA", "Functions" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Quero outra conexão do mesmo serviço, mas a tela mostra \"Uma credencial ativa por workspace.\"", "causa": "", "solucao": "O workspace guarda uma conexão de cada serviço, e a tela já abre em Editar integração. Para trocar a chave, o token ou a URL, cole o novo valor e clique em Salvar alterações; campos vazios mantêm o valor atual. Desativar não libera a vaga. Remover libera, mas as Functions param até você escolher a nova conexão nelas." }, { "sintoma": "O botão Adicionar conta Google fica desativado, com \"Limite de contas atingido.\" ou \"Seu plano não permite adicionar contas Google Workspace.\"", "causa": "", "solucao": "O workspace já usa todas as contas Google liberadas para ele.\n- Se você é o dono da conta: no menu lateral, clique em Agência. Na linha do workspace, clique em Configurar e abra a aba Limites e addons. Em Canais e addons, encontre Contas Google Workspace MCP, clique em Liberar +1 addon neste workspace e em Salvar alterações. Veja «Liberar um addon no workspace».\n- Se você não é o dono da conta: fale com o responsável pela sua agência." }, { "sintoma": "No teste aparece \"Function indisponível:\" com \"servidor MCP não autorizou/respondeu\"", "causa": "", "solucao": "O serviço recusou a conexão ou não respondeu. Confira:\n- no n8n, se o workflow está publicado, se a URL é a Production URL e se o token Bearer é o do nó;\n- no Baserow, se o endpoint ainda existe. Se criou outro, troque a URL em Editar integração;\n- no SQL do Supabase, se o Personal Access Token está salvo na conexão;\n- no ClickUp, se o token ainda vale e tem acesso ao workspace escolhido. Para trocar o token, clique em Reconectar na tela do ClickUp." }, { "sintoma": "No teste aparece \"Function indisponível:\" com \"integração não conectada\"", "causa": "", "solucao": "A conexão está desativada ou foi removida. Na tela do serviço, em Integrações, clique em Ativar (no Google Workspace e no ClickUp, em Reconectar). Se você removeu a conexão e criou outra, clique no lápis da Function, escolha a conexão de novo e clique em Salvar. No ClickUp, marque de novo as Ferramentas permitidas antes de salvar." }, { "sintoma": "O agente não encontra a base do Notion", "causa": "", "solucao": "Adicione a integração na base original, em ••• → Conexões. Depois, na Function, clique em Atualizar bases. Se ela não aparecer, use Adicionar pelo link, cole o link da base e clique em Verificar base. Páginas avulsas não aparecem na lista." }, { "sintoma": "Aparece \"Não foi possível identificar o projeto pela conexão Supabase.\"", "causa": "", "solucao": "A URL do Projeto precisa estar no formato *https://abcdef.supabase.co*, com o código do seu projeto no lugar de *abcdef*. Corrija em Editar integração." }, { "sintoma": "O agente não acha um arquivo do Google, ou aparece \"Reconecte a conta Google em Integrações.\"", "causa": "", "solucao": "O agente só acessa os arquivos marcados na Function. Para incluir um arquivo novo, edite a Function e clique em Selecionar no Google. Pastas não entram, só os arquivos de dentro delas. Se a mensagem pede reconexão, clique em Reconectar na tela do Google Workspace, com a mesma conta." }, { "sintoma": "Ao validar o token do ClickUp, aparece uma mensagem de erro", "causa": "", "solucao": "Depende da mensagem:\n- \"Os dados da conexão são inválidos. Confira o nome, o token e o workspace selecionado.\": copie o token inteiro de novo. Ele começa com *pk_*.\n- \"Token inválido, expirado ou sem acesso. Confira o token no ClickUp e tente novamente.\": o ClickUp recusou o token. Crie um token novo no ClickUp e cole em API token.\n- \"Este token não tem acesso a nenhum workspace do ClickUp.\": a conta dona do token não participa de nenhum workspace. Use o token de uma conta que participa.\n- \"O ClickUp limitou temporariamente as solicitações. Aguarde um pouco e tente novamente.\": espere alguns minutos e clique em Validar token de novo." }, { "sintoma": "Aparece \"O limite de conexões ClickUp deste workspace foi atingido ou não está disponível no plano.\"", "causa": "", "solucao": "O workspace já usa todas as conexões do ClickUp liberadas para ele, ou o plano não inclui essa integração. Para trocar o token ou a conta, clique em Reconectar na conexão que já existe. Para liberar a vaga, clique em Desconectar numa conexão que não usa mais. Se precisa de mais conexões, fale com o responsável pela sua agência." }, { "sintoma": "A lista de Ferramentas permitidas do ClickUp não carrega", "causa": "", "solucao": "Aparece \"Não foi possível consultar as ferramentas. Verifique a conexão ClickUp e seus limites de uso.\" Clique em Tentar novamente. Se continuar, abra a tela do ClickUp em Integrações, clique em Reconectar na conexão e valide um token que ainda vale." } ], "para_ia": { "perguntas": [ "Ligar seus dados ao agente?", "Quero outra conexão do mesmo serviço, mas a tela mostra \"Uma credencial ativa por workspace.\"", "O botão Adicionar conta Google fica desativado, com \"Limite de contas atingido.\" ou \"Seu plano não permite adicionar contas Google Workspace.\"", "No teste aparece \"Function indisponível:\" com \"servidor MCP não autorizou/respondeu\"", "No teste aparece \"Function indisponível:\" com \"integração não conectada\"" ], "resposta": "Conecte Google Workspace, Notion, Baserow, Supabase, n8n ou ClickUp e crie a Function para o agente de IA consultar e alterar esses dados. No menu lateral, clique em Integrações e, no cartão Google Workspace, clique em Configurar. Clique em Adicionar conta Google. Na tela do Google, escolha a conta e permita o acesso. De volta ao painel, aguarde a mensagem Conta Google conectada com sucesso. A conta aparece em Contas conectadas.", "escalar": [] }, "relacionados": [ "functions-do-agente", "integracoes-e-provedores-de-ia", "catalogo-de-produtos" ], "markdown": "---\nslug: ligar-seus-dados-ao-agente\ncategoria: Agentes de IA\natualizado: 17/10/2026\ntags: google workspace, drive, planilha, sheets, docs, notion, baserow, supabase, n8n, clickup, dados do agente, mcp\nno_painel: Integrações > Agentes IA > Functions\nverificacao: baseado no guia oficial do painel\n---\n\n# Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp\n\nConecte Google Workspace, Notion, Baserow, Supabase, n8n ou ClickUp e crie a Function para o agente de IA consultar e alterar esses dados.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Só o dono e os admins do workspace conectam contas em **Integrações** e criam Functions. Para as outras pessoas, essas telas ficam só para consulta.\n- O workspace guarda uma só conexão do Notion, do Baserow, do Supabase e do n8n. No Google Workspace e no ClickUp, o número de contas depende do que está liberado para o workspace.\n- Tenha um agente de IA criado. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\nO agente de IA pode consultar e alterar dados que você já guarda em outros serviços: arquivos do Google (Drive, Sheets, Docs e Forms), bases do Notion, tabelas do Baserow e do Supabase, workflows do n8n e tarefas e documentos do ClickUp. Ele também pode mandar ao contato, na conversa, imagens, vídeos e documentos do Google Drive. Você conecta a sua própria conta em **Integrações** e cria uma Function que usa essa conexão. O agente passa a usar esses dados na conversa, com o acesso que a sua conta deu.\n\n> **Atenção:** O que o agente grava ou apaga no seu serviço é de verdade, inclusive em alguns testes. Libere só as ações e os dados de que ele precisa e teste com dados fictícios. Chaves, tokens e URLs de conexão funcionam como senha.\n\n## Conectar o Google Workspace\n\n1. No menu lateral, clique em **Integrações** e, no cartão **Google Workspace**, clique em **Configurar**.\n2. Clique em **Adicionar conta Google**.\n3. Na tela do Google, escolha a conta e permita o acesso.\n4. De volta ao painel, aguarde a mensagem **Conta Google conectada com sucesso.** A conta aparece em **Contas conectadas**.\n\n## Conectar o Notion\n\n1. Nas configurações do Notion, crie uma integração interna (Internal Integration), com permissão para ler, inserir e atualizar conteúdo. Copie o segredo dela, que começa com *ntn_* ou *secret_*.\n2. No painel, em **Integrações**, clique em **Configurar** no cartão **Notion**.\n3. Cole o segredo em **Token de integração** e clique em **Salvar integração**.\n4. No Notion, abra a base que o agente vai usar e adicione a integração em **••• → Conexões**. Ela só enxerga o que for compartilhado.\n\n## Conectar o Baserow\n\n1. No Baserow, abra **My Settings** pelo menu do workspace, entre na aba **MCP Server**, clique em **Create Endpoint** e copie a URL MCP gerada.\n2. No painel, em **Integrações**, clique em **Configurar** no cartão **Baserow**.\n3. Em **Nome da Conexão**, escreva um nome, como *CRM Baserow*. Cole a URL em **URL MCP do Baserow** e clique em **Salvar integração**.\n\n## Conectar o Supabase\n\n1. No Supabase, abra as configurações do projeto e copie a URL do projeto e uma chave de API. Para consultas em SQL, gere também um token pessoal em Account → Access Tokens.\n2. No painel, em **Integrações**, clique em **Configurar** no cartão **Supabase**.\n3. Preencha **Nome da Conexão**, **URL do Projeto** (no formato *https://abcdef.supabase.co*), **API Key** e, se tiver, **Personal Access Token**. Clique em **Salvar integração**.\n\nCada tipo de Function usa uma parte da conexão:\n\n- **Supabase — Dados (CRUD)** usa a **API Key** para listar, consultar, criar, alterar e apagar linhas. A chave secreta (service_role) abre todas as tabelas; a pública (anon) segue as regras de acesso do projeto.\n- **Supabase — Banco via SQL (MCP oficial)** exige o **Personal Access Token**, que dá acesso à sua conta do Supabase.\n\n## Conectar o n8n\n\n1. No n8n, adicione ao workflow o nó **MCP Server Trigger** e ligue a ele as ferramentas que o agente poderá usar.\n2. Publique (ative) o workflow. Em rascunho, o agente fica sem ferramentas.\n3. No nó, troque para **Production URL** e copie a URL MCP. A de teste só responde com o editor aberto.\n4. No painel, em **Integrações**, clique em **Configurar** no cartão **n8n**. Preencha **Nome da Conexão** e cole a URL em **URL MCP do n8n**.\n5. Se o nó usa autenticação Bearer, cole o token em **Token Bearer (opcional)**; com \"None\", deixe vazio. Clique em **Salvar integração**.\n\n## Conectar o ClickUp\n\n1. No ClickUp, abra Configurações → ClickUp API → API tokens, crie um token pessoal e copie. Ele começa com *pk_*.\n2. No painel, em **Integrações**, clique em **Configurar** no cartão **ClickUp**.\n3. Em **Nome da conexão**, escreva um nome, como *ClickUp da equipe*. Cole o token em **API token** e clique em **Validar token**.\n4. Em **Workspace do ClickUp**, escolha o workspace que o agente vai usar. Se o token só tem acesso a um, ele já vem escolhido.\n5. Clique em **Conectar ClickUp** e aguarde a mensagem **ClickUp conectado. Selecione a conexão nas Functions do agente.** A conexão aparece em **Contas conectadas**.\n\nO agente age com as permissões da conta dona do token, dentro do workspace do ClickUp escolhido. O painel não separa o acesso por contato nem por lista: num agente de atendimento, use uma conta do ClickUp que só enxergue o que os clientes podem ver. Para trocar o token, clique em **Reconectar** na conexão e repita os passos 3 a 5. **Desconectar** apaga a conexão, e as Functions que a usam perdem o acesso ao ClickUp.\n\n## Criar a Function e ligar ao agente\n\n1. No menu lateral, clique em **Agentes IA**, depois em **Functions** e em **Nova function**. Preencha o nome e a descrição como em «Dar ações ao agente com Functions» (artigo `functions-do-agente`).\n2. Em **Tipo de function**, escolha:\n - Google Workspace: **MCP Google Workspace**;\n - Notion: **MCP AI MEMORY**, com **Onde guardar as memórias** em **Notion (conexão existente)**. O agente guarda e consulta anotações de cada contato numa base escolhida em **Base de memórias no Notion**;\n - Baserow: **Baserow MCP**;\n - Supabase: **Supabase — Dados (CRUD)** ou **Supabase — Banco via SQL (MCP oficial)**;\n - n8n: **n8n MCP**;\n - ClickUp: **ClickUp MCP**, que serve para agentes internos e de atendimento.\n3. Escolha a conexão no campo que aparece, como **Conexão Baserow**, **Conexão ClickUp** ou **Conta Google Workspace**.\n4. No Google Workspace, marque as ferramentas em Drive, Sheets, Docs e Forms. Clique em **Selecionar no Google**, escolha os arquivos na janela do Google e confira se ficaram marcados. Se o navegador bloquear a janela, permita pop-ups.\n5. Para o agente mandar arquivos do Drive ao contato, marque **Enviar imagem, vídeo ou documento na conversa** e também **Listar arquivos permitidos**, que o agente usa para achar o arquivo pelo nome.\n6. No ClickUp, marque em **Ferramentas permitidas** só as ações que o agente pode usar. A lista vem do próprio ClickUp e aparece depois que você escolhe a conexão. Trocar a conexão limpa as ferramentas marcadas.\n7. No SQL do Supabase, mantenha **Permissão no banco** em **Somente leitura (padrão)**, a não ser que o agente precise gravar.\n8. Clique em **Criar function**. Na página do agente, clique na seção **Ferramentas** e ligue a chave da Function em **Functions habilitadas**.\n\nO envio do Drive aceita imagens JPG e PNG de até 5 MB e vídeos MP4 e documentos PDF e DOCX de até 16 MB. Um documento do Google Docs vai como PDF, de até 10 MB. Planilhas, apresentações e formulários do Google não vão como arquivo. O Drive precisa permitir o download do arquivo. O contato recebe uma cópia, e o compartilhamento no Drive não muda. Agentes internos não enviam arquivos do Drive.\n\nSó leem: as ferramentas do Google que listam, leem, consultam ou obtêm link, e o SQL em **Somente leitura (padrão)**. Gravam no seu serviço: as ferramentas do Google que editam, atualizam, adicionam ou substituem, o Baserow, o **Supabase — Dados (CRUD)**, o SQL com **Leitura e escrita**, a memória no Notion, o n8n, que faz o que o workflow fizer, e as ferramentas do ClickUp que criam ou alteram tarefas e documentos. Age de verdade na conversa: **Enviar imagem, vídeo ou documento na conversa** manda o arquivo ao contato.\n\nNo teste do agente, as leituras do Google e o **Supabase — Dados (CRUD)** rodam de verdade mesmo com **Permitir uso de Functions** desligado, até quando o CRUD apaga linhas. Baserow, n8n, ClickUp, o SQL e as edições no Google só rodam de verdade com a opção ligada. A memória no Notion e o envio de arquivos do Drive aparecem sempre como **Simulado**.\n\n## Não funcionou?\n\n- **Quero outra conexão do mesmo serviço, mas a tela mostra \"Uma credencial ativa por workspace.\"**\n O workspace guarda uma conexão de cada serviço, e a tela já abre em **Editar integração**. Para trocar a chave, o token ou a URL, cole o novo valor e clique em **Salvar alterações**; campos vazios mantêm o valor atual. Desativar não libera a vaga. **Remover** libera, mas as Functions param até você escolher a nova conexão nelas.\n- **O botão Adicionar conta Google fica desativado, com \"Limite de contas atingido.\" ou \"Seu plano não permite adicionar contas Google Workspace.\"**\n O workspace já usa todas as contas Google liberadas para ele.\n - Se você é o dono da conta: no menu lateral, clique em **Agência**. Na linha do workspace, clique em **Configurar** e abra a aba **Limites e addons**. Em **Canais e addons**, encontre **Contas Google Workspace MCP**, clique em **Liberar +1 addon neste workspace** e em **Salvar alterações**. Veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n - Se você não é o dono da conta: fale com o responsável pela sua agência.\n- **No teste aparece \"Function indisponível:\" com \"servidor MCP não autorizou/respondeu\"**\n O serviço recusou a conexão ou não respondeu. Confira:\n - no n8n, se o workflow está publicado, se a URL é a **Production URL** e se o token Bearer é o do nó;\n - no Baserow, se o endpoint ainda existe. Se criou outro, troque a URL em **Editar integração**;\n - no SQL do Supabase, se o **Personal Access Token** está salvo na conexão;\n - no ClickUp, se o token ainda vale e tem acesso ao workspace escolhido. Para trocar o token, clique em **Reconectar** na tela do ClickUp.\n- **No teste aparece \"Function indisponível:\" com \"integração não conectada\"**\n A conexão está desativada ou foi removida. Na tela do serviço, em **Integrações**, clique em **Ativar** (no Google Workspace e no ClickUp, em **Reconectar**). Se você removeu a conexão e criou outra, clique no lápis da Function, escolha a conexão de novo e clique em **Salvar**. No ClickUp, marque de novo as **Ferramentas permitidas** antes de salvar.\n- **O agente não encontra a base do Notion**\n Adicione a integração na base original, em **••• → Conexões**. Depois, na Function, clique em **Atualizar bases**. Se ela não aparecer, use **Adicionar pelo link**, cole o link da base e clique em **Verificar base**. Páginas avulsas não aparecem na lista.\n- **Aparece \"Não foi possível identificar o projeto pela conexão Supabase.\"**\n A **URL do Projeto** precisa estar no formato *https://abcdef.supabase.co*, com o código do seu projeto no lugar de *abcdef*. Corrija em **Editar integração**.\n- **O agente não acha um arquivo do Google, ou aparece \"Reconecte a conta Google em Integrações.\"**\n O agente só acessa os arquivos marcados na Function. Para incluir um arquivo novo, edite a Function e clique em **Selecionar no Google**. Pastas não entram, só os arquivos de dentro delas. Se a mensagem pede reconexão, clique em **Reconectar** na tela do Google Workspace, com a mesma conta.\n- **Ao validar o token do ClickUp, aparece uma mensagem de erro**\n Depende da mensagem:\n - \"Os dados da conexão são inválidos. Confira o nome, o token e o workspace selecionado.\": copie o token inteiro de novo. Ele começa com *pk_*.\n - \"Token inválido, expirado ou sem acesso. Confira o token no ClickUp e tente novamente.\": o ClickUp recusou o token. Crie um token novo no ClickUp e cole em **API token**.\n - \"Este token não tem acesso a nenhum workspace do ClickUp.\": a conta dona do token não participa de nenhum workspace. Use o token de uma conta que participa.\n - \"O ClickUp limitou temporariamente as solicitações. Aguarde um pouco e tente novamente.\": espere alguns minutos e clique em **Validar token** de novo.\n- **Aparece \"O limite de conexões ClickUp deste workspace foi atingido ou não está disponível no plano.\"**\n O workspace já usa todas as conexões do ClickUp liberadas para ele, ou o plano não inclui essa integração. Para trocar o token ou a conta, clique em **Reconectar** na conexão que já existe. Para liberar a vaga, clique em **Desconectar** numa conexão que não usa mais. Se precisa de mais conexões, fale com o responsável pela sua agência.\n- **A lista de Ferramentas permitidas do ClickUp não carrega**\n Aparece \"Não foi possível consultar as ferramentas. Verifique a conexão ClickUp e seus limites de uso.\" Clique em **Tentar novamente**. Se continuar, abra a tela do ClickUp em **Integrações**, clique em **Reconectar** na conexão e valide um token que ainda vale.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Ligar seus dados ao agente?\n- Quero outra conexão do mesmo serviço, mas a tela mostra \"Uma credencial ativa por workspace.\"\n- O botão Adicionar conta Google fica desativado, com \"Limite de contas atingido.\" ou \"Seu plano não permite adicionar contas Google Workspace.\"\n- No teste aparece \"Function indisponível:\" com \"servidor MCP não autorizou/respondeu\"\n- No teste aparece \"Function indisponível:\" com \"integração não conectada\"\n\nResposta curta: Conecte Google Workspace, Notion, Baserow, Supabase, n8n ou ClickUp e crie a Function para o agente de IA consultar e alterar esses dados. No menu lateral, clique em Integrações e, no cartão Google Workspace, clique em Configurar. Clique em Adicionar conta Google. Na tela do Google, escolha a conta e permita o acesso. De volta ao painel, aguarde a mensagem Conta Google conectada com sucesso. A conta aparece em Contas conectadas.\n\nVeja também: «Dar ações ao agente com Functions» (`functions-do-agente`); «Conectar um provedor de IA e outras integrações» (`integracoes-e-provedores-de-ia`); «Montar o catálogo de produtos e deixar o agente consultar» (`catalogo-de-produtos`)\n" }, { "slug": "corrigir-as-respostas-do-agente", "categoria": "Agentes de IA", "titulo": "Corrigir uma resposta errada do agente de IA", "resumo": "Mostre ao agente de IA a resposta certa numa conversa, transforme as correções em aprendizados e veja o que fazer quando o erro continua.", "tags": [ "corrigir", "resposta errada", "ensinar o agente", "aprendizados", "correções", "regras sugeridas", "treinar", "ia errou" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Conversas", "Ensinar o agente" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O menu da mensagem não mostra Ensinar o agente", "causa": "", "solucao": "A opção só aparece em mensagens enviadas pela IA. Mensagens da equipe, de automações e de disparos não têm essa opção." }, { "sintoma": "O botão Gerar regras sugeridas não aparece ou está desativado", "causa": "", "solucao": "Ele só aparece para o dono e os administradores. Desativado, significa que não há correções pendentes neste agente: confira se a correção foi feita numa resposta dele, e não de outro agente." }, { "sintoma": "Aparece \"Nenhum provedor de IA configurado neste workspace. Configure uma integração de IA primeiro.\"", "causa": "", "solucao": "As sugestões usam o modelo do agente, e o provedor desse modelo não está conectado. Conecte-o em Integrações ou peça a quem administra o workspace. Veja «Conectar um provedor de IA e outras integrações»." }, { "sintoma": "Ao salvar, aparece \"Já existe uma regra muito parecida com essa.\"", "causa": "", "solucao": "Já há um aprendizado ativo quase igual, que a mensagem mostra. Nenhuma das regras marcadas é salva. Desmarque a sugestão repetida ou mude o texto dela e clique em Salvar selecionadas de novo." }, { "sintoma": "Quero mudar o texto de uma regra já salva", "causa": "", "solucao": "O texto de uma regra salva não se edita. Clique em Remover e registre uma nova correção numa resposta do agente, ou escreva a regra nas instruções do agente." }, { "sintoma": "O agente continua respondendo errado", "causa": "", "solucao": "Confira:\n- se a regra está como Injetada. Se está Cortada, desative regras menos importantes;\n- se a resposta errada é igual, palavra por palavra, a uma resposta do FAQ Inteligente. Ela saiu pronta do FAQ, sem passar pelos aprendizados: corrija a pergunta no FAQ;\n- se faltou informação: nos Logs, veja os trechos da Base de conhecimento usados e corrija ou envie o documento na base;\n- se o erro vale para qualquer conversa, como o tom ou o que nunca prometer: escreva nas instruções do agente (no modo Guiado, em Regras e limites). Veja «Criar um agente de IA e ligá-lo a um canal»;\n- se o agente devia agir, como transferir ou agendar: ele precisa de uma Function. Veja «Dar ações ao agente com Functions»." } ], "para_ia": { "perguntas": [ "Corrigir uma resposta errada do agente de IA?", "O menu da mensagem não mostra Ensinar o agente", "O botão Gerar regras sugeridas não aparece ou está desativado", "Aparece \"Nenhum provedor de IA configurado neste workspace. Configure uma integração de IA primeiro.\"", "Ao salvar, aparece \"Já existe uma regra muito parecida com essa.\"" ], "resposta": "Mostre ao agente de IA a resposta certa numa conversa, transforme as correções em aprendizados e veja o que fazer quando o erro continua. No menu lateral, clique em Conversas e abra a conversa com a resposta errada. Passe o mouse sobre a mensagem da IA e clique no botão redondo com uma seta que aparece ao lado dela (Ações da mensagem). Clique em Ensinar o agente. Confira a Resposta original da IA. Se ela saiu dividida em várias mensagens, aparece inteira.", "escalar": [ "Erro que continua depois das correções" ] }, "relacionados": [ "ensinar-agente", "criar-agente", "quando-o-agente-responde" ], "markdown": "---\nslug: corrigir-as-respostas-do-agente\ncategoria: Agentes de IA\natualizado: 17/10/2026\ntags: corrigir, resposta errada, ensinar o agente, aprendizados, correções, regras sugeridas, treinar, ia errou\nno_painel: Conversas > Ensinar o agente\nverificacao: baseado no guia oficial do painel\n---\n\n# Corrigir uma resposta errada do agente de IA\n\nMostre ao agente de IA a resposta certa numa conversa, transforme as correções em aprendizados e veja o que fazer quando o erro continua.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Quem vê a conversa em **Conversas** pode usar **Ensinar o agente** nas mensagens da IA.\n- Só o dono e os administradores do workspace geram, salvam, desativam e removem aprendizados. As outras pessoas com acesso a **Agentes IA** só veem a lista.\n- As regras sugeridas são escritas pelo modelo do próprio agente, com o provedor de IA conectado em **Integrações**.\n- Agentes de uso **Interno** não têm a aba **Aprendizados**.\n\nQuando o agente de IA responde errado, quem atende a conversa pode mostrar a resposta certa com **Ensinar o agente**. As correções se juntam na aba **Aprendizados** do agente, onde o dono ou um administrador as transforma em regras curtas. As regras entram nas próximas respostas do agente, sem mudar as instruções que você escreveu.\n\nAs correções não vão para o FAQ Inteligente nem para a Base de conhecimento, e o cliente não recebe nada quando você registra uma.\n\n## Registrar a correção na conversa\n\n1. No menu lateral, clique em **Conversas** e abra a conversa com a resposta errada.\n2. Passe o mouse sobre a mensagem da IA e clique no botão redondo com uma seta que aparece ao lado dela (**Ações da mensagem**).\n3. Clique em **Ensinar o agente**.\n4. Confira a **Resposta original da IA**. Se ela saiu dividida em várias mensagens, aparece inteira.\n5. Em **Resposta correta**, escreva como o agente deveria ter respondido.\n6. Em **Por que errou? (opcional)**, explique em poucas palavras, por exemplo *usou a política de troca antiga*. Isso ajuda a gerar uma regra melhor.\n7. Clique em **Registrar correção**. A janela fecha, e a correção fica pendente no agente que escreveu a resposta. Numa equipe de IA, é o especialista que respondeu.\n\n## Transformar as correções em aprendizados\n\n1. No menu lateral, clique em **Agentes IA**, abra o agente e clique na aba **Aprendizados**.\n2. Em **Correções pendentes**, o número entre parênteses mostra quantas correções esperam revisão. Clique em **Gerar regras sugeridas**.\n3. Revise as sugestões: ajuste o texto na caixa de cada uma e desmarque as que não quer. Boas regras são gerais, como *Informe que trocas são aceitas em até 30 dias após a compra*.\n4. Clique em **Salvar selecionadas**. As regras marcadas vão para **Aprendizados ativos**, e as correções usadas saem da contagem. Se você desmarcar todas e salvar, as correções pendentes são descartadas.\n\n> **Dica:** Sugestões com a marca **fato** trazem um dado pontual, como preço, prazo ou link. Elas funcionam, mas ocupam o espaço limitado dos aprendizados. Esses dados ficam melhor no FAQ Inteligente ou na Base de conhecimento: veja «Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados» (artigo `ensinar-agente`).\n\n## Revisar os aprendizados ativos\n\n1. Em **Aprendizados ativos**, confira a marca de cada regra: **Injetada** entra nas respostas do agente; **Cortada** ficou de fora pelo limite.\n2. Para pausar uma regra sem apagá-la, desmarque a caixa ao lado dela. Para voltar a usar, marque de novo. Vale na hora, sem salvar.\n3. Para apagar, clique em **Remover**. A regra some na hora, sem pedir confirmação.\n\nO agente recebe até 40 regras ativas, somando cerca de 2.000 caracteres. Quando passa disso, as que ficam de fora aparecem como **Cortada**, e um aviso no topo da seção diz quantas: desative as menos importantes. Se o aviso falar em seleção dinâmica, em cada conversa entram primeiro as regras mais ligadas ao assunto.\n\n## Conferir se o agente aprendeu\n\n1. De um número seu, mande para o canal do agente a mesma pergunta que deu errado.\n2. Em **Conversas**, veja a resposta. Para detalhes, vá em **Agentes IA** e clique no ícone **Logs** do agente. Cada atendimento mostra a **Entrada**, a **Resposta do agente**, as funções chamadas e os trechos da Base de conhecimento usados. Os logs ficam disponíveis por 48 horas.\n\n> **Atenção:** O botão **Testar**, na página do agente, não usa os aprendizados. Para conferir uma correção, use uma conversa de verdade.\n\n## Não funcionou?\n\n- **O menu da mensagem não mostra Ensinar o agente**\n A opção só aparece em mensagens enviadas pela IA. Mensagens da equipe, de automações e de disparos não têm essa opção.\n- **O botão Gerar regras sugeridas não aparece ou está desativado**\n Ele só aparece para o dono e os administradores. Desativado, significa que não há correções pendentes neste agente: confira se a correção foi feita numa resposta dele, e não de outro agente.\n- **Aparece \"Nenhum provedor de IA configurado neste workspace. Configure uma integração de IA primeiro.\"**\n As sugestões usam o modelo do agente, e o provedor desse modelo não está conectado. Conecte-o em **Integrações** ou peça a quem administra o workspace. Veja «Conectar um provedor de IA e outras integrações» (artigo `integracoes-e-provedores-de-ia`).\n- **Ao salvar, aparece \"Já existe uma regra muito parecida com essa.\"**\n Já há um aprendizado ativo quase igual, que a mensagem mostra. Nenhuma das regras marcadas é salva. Desmarque a sugestão repetida ou mude o texto dela e clique em **Salvar selecionadas** de novo.\n- **Quero mudar o texto de uma regra já salva**\n O texto de uma regra salva não se edita. Clique em **Remover** e registre uma nova correção numa resposta do agente, ou escreva a regra nas instruções do agente.\n- **O agente continua respondendo errado**\n Confira:\n - se a regra está como **Injetada**. Se está **Cortada**, desative regras menos importantes;\n - se a resposta errada é igual, palavra por palavra, a uma resposta do FAQ Inteligente. Ela saiu pronta do FAQ, sem passar pelos aprendizados: corrija a pergunta no FAQ;\n - se faltou informação: nos **Logs**, veja os trechos da Base de conhecimento usados e corrija ou envie o documento na base;\n - se o erro vale para qualquer conversa, como o tom ou o que nunca prometer: escreva nas instruções do agente (no modo **Guiado**, em **Regras e limites**). Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`);\n - se o agente devia agir, como transferir ou agendar: ele precisa de uma Function. Veja «Dar ações ao agente com Functions» (artigo `functions-do-agente`).\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Corrigir uma resposta errada do agente de IA?\n- O menu da mensagem não mostra Ensinar o agente\n- O botão Gerar regras sugeridas não aparece ou está desativado\n- Aparece \"Nenhum provedor de IA configurado neste workspace. Configure uma integração de IA primeiro.\"\n- Ao salvar, aparece \"Já existe uma regra muito parecida com essa.\"\n\nResposta curta: Mostre ao agente de IA a resposta certa numa conversa, transforme as correções em aprendizados e veja o que fazer quando o erro continua. No menu lateral, clique em Conversas e abra a conversa com a resposta errada. Passe o mouse sobre a mensagem da IA e clique no botão redondo com uma seta que aparece ao lado dela (Ações da mensagem). Clique em Ensinar o agente. Confira a Resposta original da IA. Se ela saiu dividida em várias mensagens, aparece inteira.\n\nEscalar para um humano quando:\n- Erro que continua depois das correções\n\nVeja também: «Ensinar o agente: Base de conhecimento, FAQ Inteligente e Aprendizados» (`ensinar-agente`); «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`); «Quando e como o agente responde: gatilho, buffer, horários e encerramento» (`quando-o-agente-responde`)\n" }, { "slug": "montar-um-fluxo-no-flow-builder", "categoria": "Automações e disparos", "titulo": "Montar o primeiro fluxo no Flow Builder", "resumo": "Monte uma conversa automática em blocos, com gatilho, mensagem com botões e transferência para a equipe, teste com o seu número e ative.", "tags": [ "flow builder", "fluxo", "chatbot", "botões", "menu de opções", "gatilho", "blocos", "observador", "testar fluxo" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Automações", "Flow Builder" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Aparece \"● não salvo\" e uma faixa vermelha como \"Há nós com configuração incompleta — corrija para salvar.\"", "causa": "", "solucao": "Procure o bloco com uma bolinha vermelha no canto e preencha o que falta, como o texto, os botões, a ação ou a palavra-chave. Quando voltar a ● salvo, clique na faixa para fechá-la." }, { "sintoma": "A faixa vermelha mostra \"orphan_node\"", "causa": "", "solucao": "Algum bloco não recebe ligação. Todo bloco, menos o Início e a Nota, precisa estar ligado à saída de outro. Ligue o bloco solto ou exclua-o na lixeira (Excluir bloco), que aparece ao passar o mouse." }, { "sintoma": "Testei uma vez e, na segunda, o fluxo não começou", "causa": "", "solucao": "Se o teste anterior ainda espera um toque nos botões, a nova mensagem conta como resposta. Toque num botão ou tire o seu contato do fluxo, como em *Pausar ou desativar*. Veja também a Frequência: com 1x a cada 24h, o contato só entra de novo depois de 24 horas, e com Apenas 1x, só uma vez." }, { "sintoma": "O contato escreveu em vez de tocar num botão", "causa": "", "solucao": "O fluxo segue na hora pela saída sem resposta. Ligue essa saída a um bloco útil, como uma Ação que transfere a conversa. Saída sem ligação encerra o fluxo." }, { "sintoma": "A conversa não foi transferida para ninguém", "causa": "", "solucao": "Transferir conversa só entrega para quem está disponível e no horário de atendimento. Se ninguém da lista estiver, a transferência é pulada e o fluxo continua. Veja «Ficar disponível ou ausente para receber conversas»." }, { "sintoma": "O fluxo não começa quando chega uma mensagem", "causa": "", "solucao": "Confira se ele aparece como ativo na lista do Flow Builder. No Início, veja se o gatilho e o Canal combinam com a mensagem e se a saída do Início está ligada a outro bloco." }, { "sintoma": "Em Execuções aparece \"Aguardando cota\"", "causa": "", "solucao": "O workspace atingiu o limite de execuções de automação do plano no mês ou o limite por minuto. A execução fica parada, sem enviar nada, e roda sozinha quando a cota libera, com os passos rodando nessa hora. Para que ela não rode, tire o contato do fluxo, como em *Pausar ou desativar*. Veja «Acompanhar a assinatura»." }, { "sintoma": "Ao criar um fluxo, aparece \"O limite de automações do workspace foi atingido. Exclua uma automação ou amplie o plano para criar outra.\"", "causa": "", "solucao": "O plano limita quantas automações o workspace pode ter, somando fluxos e Automações Básicas, ativos ou não. Exclua um fluxo que não usa mais ou peça ao dono da conta um plano maior." } ], "para_ia": { "perguntas": [ "Montar o primeiro fluxo no Flow Builder?", "Aparece \"● não salvo\" e uma faixa vermelha como \"Há nós com configuração incompleta — corrija para salvar.\"", "A faixa vermelha mostra \"orphan_node\"", "Testei uma vez e, na segunda, o fluxo não começou", "O contato escreveu em vez de tocar num botão" ], "resposta": "Monte uma conversa automática em blocos, com gatilho, mensagem com botões e transferência para a equipe, teste com o seu número e ative. No menu lateral, clique em Automações e depois no cartão Flow Builder. Clique em Novo flow, escreva um nome em Nome do flow, como Boas-vindas, e clique em Criar. O editor abre com os blocos Início e Fim já ligados. À esquerda fica a coluna BLOCOS. Clique no bloco Início para abrir as propriedades dele, à direita.", "escalar": [ "Fluxo que contradiz a configuração" ] }, "relacionados": [ "escolher-automacao", "automacao-basica", "ia-nao-responde" ], "markdown": "---\nslug: montar-um-fluxo-no-flow-builder\ncategoria: Automações e disparos\natualizado: 17/10/2026\ntags: flow builder, fluxo, chatbot, botões, menu de opções, gatilho, blocos, observador, testar fluxo\nno_painel: Automações > Flow Builder\nverificacao: baseado no guia oficial do painel\n---\n\n# Montar o primeiro fluxo no Flow Builder\n\nMonte uma conversa automática em blocos, com gatilho, mensagem com botões e transferência para a equipe, teste com o seu número e ative.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Só o dono do workspace e quem tem o papel **Admin** criam, editam, ativam e acompanham fluxos. Você também precisa ter acesso ao menu **Automações**.\n- Tenha pelo menos um canal conectado, como um número de WhatsApp.\n- Quem vai receber as conversas precisa estar disponível para atendimento.\n\nO Flow Builder monta conversas automáticas com blocos ligados: um gatilho dá a partida, o fluxo manda mensagens, espera o contato escolher uma opção e segue um caminho para cada resposta. Use-o quando precisar de ramificações, esperas ou várias mensagens em sequência. Para uma regra simples, como \"quando acontecer isso, faça aquilo\", a «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (artigo `automacao-basica`) basta.\n\nO exemplo abaixo dá boas-vindas com os botões *Comprar* e *Suporte* e entrega cada conversa para a equipe certa.\n\n> **Atenção:** Todo fluxo novo vem com o gatilho **Mensagem recebida**, valendo para todos os canais. Se você ativar sem mudar nada, ele começa com qualquer mensagem que chegar e recomeça a cada nova mensagem depois de terminar.\n\n## Criar o fluxo\n\n1. No menu lateral, clique em **Automações** e depois no cartão **Flow Builder**.\n2. Clique em **Novo flow**, escreva um nome em **Nome do flow**, como *Boas-vindas*, e clique em **Criar**.\n3. O editor abre com os blocos **Início** e **Fim** já ligados. À esquerda fica a coluna **BLOCOS**.\n\n> **Dica:** Não há botão de salvar: cada mudança é salva sozinha, e o status ao lado do nome mostra **● salvo**. Com algum bloco solto ou incompleto, aparece **● não salvo**, às vezes com uma faixa vermelha: é normal durante a montagem. O fluxo nasce desativado.\n\n## Escolher o gatilho\n\n1. Clique no bloco **Início** para abrir as propriedades dele, à direita.\n2. Em **Gatilhos**, escolha o que faz o fluxo começar, como **Mensagem recebida**, **Tag aplicada** ou **Etapa alterada**. Enquanto monta e testa, use **Palavra-chave**: assim só você dispara o fluxo.\n3. Clique em **+ Adicionar palavra-chave** e escreva uma palavra que só você vai mandar, como *teste123*.\n4. Em **Canal**, marque o número em que o fluxo vai rodar. Sem nenhum marcado, vale para todos.\n\n## Montar o exemplo\n\n1. Arraste da coluna **BLOCOS** para o canvas o canal em que você atende, como **WhatsApp QR Code** ou **WhatsApp Business** (API oficial). As propriedades do bloco abrem à direita.\n2. Arraste a bolinha do lado direito do **Início** até a bolinha do lado esquerdo do novo bloco. Essa ligação substitui a que ia para o **Fim**.\n3. Em **Texto**, escreva a mensagem, como *Olá! Sobre o que é o seu contato?*\n4. Clique em **+ Botões**, escolha **Resposta rápida** e escreva *Comprar* em **Texto do botão**. Repita para *Suporte*. Cada botão vira uma saída do bloco, além de **sem resposta** e **continuar**, que pode ficar sem ligação.\n5. Confira **Sem resposta após**, que já vem com 24 horas: é quanto o fluxo espera um toque, de 5 minutos a 24 horas. Depois disso, ele segue pela saída **sem resposta**.\n6. Arraste um bloco **Ação** para o canvas e ligue a saída *Comprar* a ele. Clique em **+ Adicionar ação**, escolha **Transferir conversa** e, em **Tipo de transferência**, **Rodízio entre atendentes**. Em **Agentes no rodízio**, marque quem atende vendas.\n7. Repita o passo anterior para a saída *Suporte*, com quem atende suporte.\n8. Ligue a saída de cada **Ação** ao **Fim** e espere o status mostrar **● salvo**.\n\nOutros blocos muito usados: **Delay** espera um tempo; **Condição** separa o caminho por regras, como uma tag do contato, o horário ou a **Origem do contato** (**Manual**, **Importação**, **API** ou o canal pelo qual ele chegou); e **Resposta do Contato**, em **+ Adicionar conteúdo** de um bloco de canal, guarda a resposta de uma pergunta aberta num campo do contato. Há outros, como **Divisor** e **Nota**.\n\nNo bloco **Ação**, **+ Adicionar ação** traz também **Criar tarefa**, explicada em «Organizar tarefas da equipe» (artigo `organizar-tarefas`), e **Ligar e tocar áudio**, que faz uma ligação de verdade pelo WhatsApp QR Pro e toca um áudio depois que o contato atende. Os campos da ligação são os mesmos da Automação Básica: veja «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (artigo `automacao-basica`).\n\n## Testar sem enviar nada\n\n1. Clique em **Testar** para abrir o celular simulado **Testar fluxo**.\n2. Envie *teste123* como se fosse o contato e toque nos botões. Os blocos percorridos ficam destacados, e as ações aparecem só como aviso: nada é enviado nem transferido.\n3. Clique em **Reiniciar** para simular de novo.\n\n## Ativar e testar com o seu número\n\n1. Clique em **Ativar**, no topo do editor.\n2. Clique em **Observar**, digite o seu número com DDI e DDD e clique em **Iniciar observação**. Deixe a página aberta.\n3. Do seu celular, mande *teste123* para o número conectado e toque num botão. Cada bloco pisca no canvas quando roda, e os erros aparecem em vermelho. Agora é real: a sua conversa de teste vai ser transferida.\n4. Clique em **Execuções** para ver cada vez que o fluxo rodou e a situação, como **concluída** ou **falhou**. Clique numa delas para ver os passos.\n5. Deu certo? No **Início**, troque o gatilho para **Mensagem recebida** e, em **Frequência**, escolha **1x a cada 24h**, para cada contato receber as boas-vindas no máximo uma vez por dia.\n\n## Pausar ou desativar\n\nPara pausar, clique em **Desativar** no editor ou na lista do **Flow Builder**. O fluxo para de começar em novas conversas, mas quem já está nele continua até o fim.\n\nPara tirar alguém do fluxo, abra a conversa, clique em **Mais ações** (⋮) e em **Informações do contato**. Em **Fluxos ativos**, clique na lixeira (**Remover do fluxo**) e confirme.\n\n## Não funcionou?\n\n- **Aparece \"● não salvo\" e uma faixa vermelha como \"Há nós com configuração incompleta — corrija para salvar.\"**\n Procure o bloco com uma bolinha vermelha no canto e preencha o que falta, como o texto, os botões, a ação ou a palavra-chave. Quando voltar a **● salvo**, clique na faixa para fechá-la.\n- **A faixa vermelha mostra \"orphan_node\"**\n Algum bloco não recebe ligação. Todo bloco, menos o **Início** e a **Nota**, precisa estar ligado à saída de outro. Ligue o bloco solto ou exclua-o na lixeira (**Excluir bloco**), que aparece ao passar o mouse.\n- **Testei uma vez e, na segunda, o fluxo não começou**\n Se o teste anterior ainda espera um toque nos botões, a nova mensagem conta como resposta. Toque num botão ou tire o seu contato do fluxo, como em *Pausar ou desativar*. Veja também a **Frequência**: com **1x a cada 24h**, o contato só entra de novo depois de 24 horas, e com **Apenas 1x**, só uma vez.\n- **O contato escreveu em vez de tocar num botão**\n O fluxo segue na hora pela saída **sem resposta**. Ligue essa saída a um bloco útil, como uma **Ação** que transfere a conversa. Saída sem ligação encerra o fluxo.\n- **A conversa não foi transferida para ninguém**\n **Transferir conversa** só entrega para quem está disponível e no horário de atendimento. Se ninguém da lista estiver, a transferência é pulada e o fluxo continua. Veja «Ficar disponível ou ausente para receber conversas» (artigo `disponivel-ou-ausente`).\n- **O fluxo não começa quando chega uma mensagem**\n Confira se ele aparece como **ativo** na lista do **Flow Builder**. No **Início**, veja se o gatilho e o **Canal** combinam com a mensagem e se a saída do **Início** está ligada a outro bloco.\n- **Em Execuções aparece \"Aguardando cota\"**\n O workspace atingiu o limite de execuções de automação do plano no mês ou o limite por minuto. A execução fica parada, sem enviar nada, e roda sozinha quando a cota libera, com os passos rodando nessa hora. Para que ela não rode, tire o contato do fluxo, como em *Pausar ou desativar*. Veja «Acompanhar a assinatura» (artigo `assinatura-e-cobranca`).\n- **Ao criar um fluxo, aparece \"O limite de automações do workspace foi atingido. Exclua uma automação ou amplie o plano para criar outra.\"**\n O plano limita quantas automações o workspace pode ter, somando fluxos e Automações Básicas, ativos ou não. Exclua um fluxo que não usa mais ou peça ao dono da conta um plano maior.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Montar o primeiro fluxo no Flow Builder?\n- Aparece \"● não salvo\" e uma faixa vermelha como \"Há nós com configuração incompleta — corrija para salvar.\"\n- A faixa vermelha mostra \"orphan_node\"\n- Testei uma vez e, na segunda, o fluxo não começou\n- O contato escreveu em vez de tocar num botão\n\nResposta curta: Monte uma conversa automática em blocos, com gatilho, mensagem com botões e transferência para a equipe, teste com o seu número e ative. No menu lateral, clique em Automações e depois no cartão Flow Builder. Clique em Novo flow, escreva um nome em Nome do flow, como Boas-vindas, e clique em Criar. O editor abre com os blocos Início e Fim já ligados. À esquerda fica a coluna BLOCOS. Clique no bloco Início para abrir as propriedades dele, à direita.\n\nEscalar para um humano quando:\n- Fluxo que contradiz a configuração\n\nVeja também: «Automações: qual usar em cada situação» (`escolher-automacao`); «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (`automacao-basica`); «A IA não responde: diagnóstico passo a passo» (`ia-nao-responde`)\n" }, { "slug": "respostas-automaticas-instagram-e-facebook", "categoria": "Automações e disparos", "titulo": "Responder comentários e stories do Instagram automaticamente", "resumo": "Crie regras que respondem sozinhas a quem comenta nos seus posts do Instagram ou interage com seus stories, no Direct e em público.", "tags": [ "instagram", "comentários", "stories", "resposta automática", "direct", "palavra-chave", "facebook", "comentou ganhou" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Automações", "Comentários / Histórias Instagram" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "A tela mostra \"Conecte uma conta Instagram\" e o botão Nova Regra está desativado", "causa": "", "solucao": "Não há conta do Instagram conectada. Clique em Ir pra Conexões e conecte uma." }, { "sintoma": "O botão Criar Regra continua desativado", "causa": "", "solucao": "Procure a mensagem em vermelho, como Obrigatório, Adicione pelo menos 1 palavra-chave, Selecione um agente ou Habilite ao menos uma resposta (privada ou pública), e complete o campo." }, { "sintoma": "A regra está ligada, mas um comentário ficou sem resposta", "causa": "", "solucao": "Confira se:\n- o comentário é de antes da regra ou chegou com ela pausada;\n- ele está num post que a regra acompanha e bate com a palavra: em Comentários iguais a, *Eu quero!* não é igual a *eu quero*;\n- ele tem palavra excluída, é resposta a outro comentário ou a pessoa já recebeu resposta nesse post;\n- o agente de IA falhou sem texto de reserva. Se a mensagem privada falha, a pública também não sai.\nO plano do workspace também pode limitar as respostas automáticas do Instagram por minuto e por 24 horas; o que passa do limite não sai depois. Se isso se repetir, fale com o responsável pela sua agência." }, { "sintoma": "A regra respondeu, mas a mensagem não aparece em Conversas", "causa": "", "solucao": "O que as regras enviam não aparece em Conversas: confira no app do Instagram. Quem comentou vira contato e conversa ao responder no Direct. Nos stories, a interação da pessoa já aparece." }, { "sintoma": "A regra mostra \"Conexão indisponível\"", "causa": "", "solucao": "A conta dessa regra foi apagada em Conexões. Clique em Editar, escolha a conta em Conta Instagram e salve, mesmo que seja a mesma conta reconectada." }, { "sintoma": "Criei uma regra em Comentários Facebook e ela não responde", "causa": "", "solucao": "Os comentários da Página do Facebook não chegam ao painel, então essas regras não disparam. Responda pelo próprio Facebook." } ], "para_ia": { "perguntas": [ "Responder comentários e stories do Instagram automaticamente?", "A tela mostra \"Conecte uma conta Instagram\" e o botão Nova Regra está desativado", "O botão Criar Regra continua desativado", "A regra está ligada, mas um comentário ficou sem resposta", "A regra respondeu, mas a mensagem não aparece em Conversas" ], "resposta": "Crie regras que respondem sozinhas a quem comenta nos seus posts do Instagram ou interage com seus stories, no Direct e em público. No menu lateral, clique em Automações, no cartão Comentários Instagram e em Nova Regra. Preencha o Nome da Regra e escolha a Conta Instagram. Em Acompanhar comentários em, escolha Todas as publicações, que inclui os posts futuros, ou Postagem específica e clique nos posts desejados. Em Envie mensagem privada com, escolha o que vai para o Direct de quem comentou:", "escalar": [] }, "relacionados": [ "instagram-e-messenger", "escolher-automacao" ], "markdown": "---\nslug: respostas-automaticas-instagram-e-facebook\ncategoria: Automações e disparos\natualizado: 17/10/2026\ntags: instagram, comentários, stories, resposta automática, direct, palavra-chave, facebook, comentou ganhou\nno_painel: Automações > Comentários / Histórias Instagram\nverificacao: baseado no guia oficial do painel\n---\n\n# Responder comentários e stories do Instagram automaticamente\n\nCrie regras que respondem sozinhas a quem comenta nos seus posts do Instagram ou interage com seus stories, no Direct e em público.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Conecte a conta do Instagram. Veja «Conectar o Instagram e o Messenger do Facebook» (artigo `instagram-e-messenger`).\n- Você precisa ter acesso ao menu **Automações**. Só o dono e os admins do workspace criam, editam, ligam, pausam e excluem as regras.\n- Para responder com **Agente IA**, crie o agente antes. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\nAs regras de resposta automática respondem sozinhas a quem comenta nos seus posts do Instagram, com uma mensagem privada no Direct, uma resposta pública embaixo do comentário ou as duas. Também respondem no Direct quem menciona a sua conta num story ou responde aos seus stories. É assim que funciona a campanha \"comente EU QUERO que eu te mando no direct\".\n\n> **Bom saber:** O painel não responde comentários do Facebook automaticamente. Da Página do Facebook, só as mensagens do Messenger chegam ao painel.\n\n## Criar uma regra para comentários\n\n1. No menu lateral, clique em **Automações**, no cartão **Comentários Instagram** e em **Nova Regra**.\n2. Preencha o **Nome da Regra** e escolha a **Conta Instagram**.\n3. Em **Acompanhar comentários em**, escolha **Todas as publicações**, que inclui os posts futuros, ou **Postagem específica** e clique nos posts desejados.\n4. Em **Envie mensagem privada com**, escolha o que vai para o Direct de quem comentou:\n - **Texto**: escreva a mensagem. Em **+ Adicionar variação**, crie até 5 versões; a cada envio, o painel sorteia uma.\n - **Agente IA**: escolha o agente em **Selecione um agente**. Ele escreve cada resposta só com as instruções dele, sem a base de conhecimento. Se ele falhar, vale o **Texto fallback (último recurso, se os agentes falharem)**.\n - **Nenhum**: sem mensagem privada.\n5. Em **Responder ao comentário com um comentário público**, escolha do mesmo jeito. Pelo menos uma das duas respostas precisa estar ligada.\n6. Em **Responder a**, escolha **Todos os comentários**, **Comentários iguais a** (o comentário inteiro) ou **Comentários que contêm** (em qualquer parte) e digite as palavras, com Enter após cada uma. Maiúsculas não contam, mas acentos sim: *promoção* e *promocao* são diferentes.\n7. Em **Mais opções**, use **Palavras excluídas** para ignorar comentários com essas palavras. As chaves **Não responder a respostas de comentários** e **Responder apenas 1 vez por usuário por post** já vêm ligadas.\n8. Clique em **Criar Regra**. Ela vale na hora, para os comentários novos.\n\n## Exemplo: comente EU QUERO que eu te mando no direct\n\n1. Publique o post com a chamada, por exemplo *Comente EU QUERO que eu te mando o link no direct*.\n2. Crie uma regra de comentários com **Postagem específica** e marque esse post.\n3. Em **Envie mensagem privada com**, escolha **Texto** e escreva *Oi! Aqui está o link que você pediu:*, seguido do endereço da oferta.\n4. Em **Responder ao comentário com um comentário público**, escolha **Texto**, escreva *Te mandei no direct!* e crie variações, como *Já está no seu direct 😉*.\n5. Em **Responder a**, escolha **Comentários que contêm** e adicione *eu quero*, que pega também *Eu quero!!* e *EU QUERO 😍*. Deixe as chaves de **Mais opções** ligadas e clique em **Criar Regra**.\n\n## Responder menções e respostas aos stories\n\n1. No menu lateral, clique em **Automações**, no cartão **Histórias Instagram** e em **Nova Regra**. Preencha o **Nome da Regra** e escolha a **Conta Instagram**.\n2. Em **Disparar em**, marque **Menções em story (alguém te @menciona)**, **Respostas ao seu story** ou os dois.\n3. Em **Responder a**, escolha **Todas as interações**, **Texto igual a** ou **Texto que contém**. Menção sem texto não passa em filtro de palavra.\n4. Em **Limite de resposta por usuário**, escolha **Sempre (responder toda vez)**, **1x a cada 24 horas** ou **Apenas 1x (nunca repetir)**.\n5. Em **Resposta por DM**, escolha **Texto** ou **Agente IA**. Em **Botões de resposta rápida (opcional)**, você pode adicionar até 3 botões, que mandam um texto pronto ou chamam o agente de IA da conversa. Clique em **Criar Regra**.\n\n> **Atenção:** Com uma regra de stories ligada, o agente de IA e os fluxos deixam de responder às menções e respostas aos stories da conta. O que não passa nos filtros da regra fica sem resposta automática, mas aparece em **Conversas**.\n\n## Ligar, pausar, editar e excluir\n\n1. Nas telas **Comentários Instagram** e **Histórias Instagram**, use a chave à esquerda de cada regra para ligar ou pausar. O que chega com a regra pausada fica sem resposta.\n2. Para mudar, clique nos três pontinhos (⋮) da regra, em **Editar** e em **Salvar Alterações**. Salvar religa a regra: se ela deve continuar pausada, desligue a chave.\n3. Para preparar outra versão sem mexer na que está no ar, use **Duplicar**: a cópia nasce pausada.\n4. Para apagar, clique em **Excluir** e confirme.\n\n## Testar com segurança\n\n1. Crie a regra com **Postagem específica** em um post só e com **Comentários iguais a** uma palavra que ninguém usaria, como *teste123*.\n2. De outro perfil do Instagram, comente *teste123* no post e confira nesse perfil o Direct e a resposta pública. Cada perfil recebe uma resposta por post: para repetir, use outro perfil ou post.\n3. Deu certo? Edite a regra com a palavra e os posts da campanha.\n\n## Não funcionou?\n\n- **A tela mostra \"Conecte uma conta Instagram\" e o botão Nova Regra está desativado**\n Não há conta do Instagram conectada. Clique em **Ir pra Conexões** e conecte uma.\n- **O botão Criar Regra continua desativado**\n Procure a mensagem em vermelho, como **Obrigatório**, **Adicione pelo menos 1 palavra-chave**, **Selecione um agente** ou **Habilite ao menos uma resposta (privada ou pública)**, e complete o campo.\n- **A regra está ligada, mas um comentário ficou sem resposta**\n Confira se:\n - o comentário é de antes da regra ou chegou com ela pausada;\n - ele está num post que a regra acompanha e bate com a palavra: em **Comentários iguais a**, *Eu quero!* não é igual a *eu quero*;\n - ele tem palavra excluída, é resposta a outro comentário ou a pessoa já recebeu resposta nesse post;\n - o agente de IA falhou sem texto de reserva. Se a mensagem privada falha, a pública também não sai.\n O plano do workspace também pode limitar as respostas automáticas do Instagram por minuto e por 24 horas; o que passa do limite não sai depois. Se isso se repetir, fale com o responsável pela sua agência.\n- **A regra respondeu, mas a mensagem não aparece em Conversas**\n O que as regras enviam não aparece em **Conversas**: confira no app do Instagram. Quem comentou vira contato e conversa ao responder no Direct. Nos stories, a interação da pessoa já aparece.\n- **A regra mostra \"Conexão indisponível\"**\n A conta dessa regra foi apagada em **Conexões**. Clique em **Editar**, escolha a conta em **Conta Instagram** e salve, mesmo que seja a mesma conta reconectada.\n- **Criei uma regra em Comentários Facebook e ela não responde**\n Os comentários da Página do Facebook não chegam ao painel, então essas regras não disparam. Responda pelo próprio Facebook.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Responder comentários e stories do Instagram automaticamente?\n- A tela mostra \"Conecte uma conta Instagram\" e o botão Nova Regra está desativado\n- O botão Criar Regra continua desativado\n- A regra está ligada, mas um comentário ficou sem resposta\n- A regra respondeu, mas a mensagem não aparece em Conversas\n\nResposta curta: Crie regras que respondem sozinhas a quem comenta nos seus posts do Instagram ou interage com seus stories, no Direct e em público. No menu lateral, clique em Automações, no cartão Comentários Instagram e em Nova Regra. Preencha o Nome da Regra e escolha a Conta Instagram. Em Acompanhar comentários em, escolha Todas as publicações, que inclui os posts futuros, ou Postagem específica e clique nos posts desejados. Em Envie mensagem privada com, escolha o que vai para o Direct de quem comentou:\n\nVeja também: «Conectar o Instagram e o Messenger do Facebook» (`instagram-e-messenger`); «Automações: qual usar em cada situação» (`escolher-automacao`)\n" }, { "slug": "receber-dados-com-webhooks", "categoria": "Automações e disparos", "titulo": "Receber dados de outros sistemas com webhooks", "resumo": "Crie um endereço que formulários, CRMs e ferramentas como Zapier e n8n usam para criar contatos, preencher campos, aplicar tags e disparar automações.", "tags": [ "webhook", "integração", "formulário", "zapier", "n8n", "make", "crm", "receber dados", "payload", "url do webhook" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Automações", "Webhooks" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "A aba Logs (48h) mostra \"Nenhum log nas últimas 48h.\", mas o outro sistema diz que enviou", "causa": "", "solucao": "O envio foi recusado antes de virar registro. Confira:\n- se a URL no outro sistema está completa e é a atual: depois de Regenerar token, só a nova funciona;\n- se Webhook ativo está ligado e salvo, e se o modo teste está desligado;\n- se o envio é do tipo POST;\n- se o outro sistema recebeu um aviso de limite: o plano do workspace limita os envios por minuto e por dia. Espace os envios ou fale com o responsável pela sua agência." }, { "sintoma": "O envio aparece como Erro, com \"phone_extraction_failed\", \"whatsapp_extraction_failed\", \"email_extraction_failed\" ou \"contact_not_found_no_create\"", "causa": "", "solucao": "Nos três primeiros, o dado escolhido em Buscar contato por (campo do sistema) não veio no envio, ou o caminho da linha BUSCA está errado: compare com o Body do log. No último, o contato não existe e Criar contato se não existir está desligado. Corrija, salve e clique em Reprocessar." }, { "sintoma": "Ao salvar, aparece \"Mapeie o campo\" ou o aviso de que \"toda chamada vai falhar\"", "causa": "", "solucao": "Falta o Caminho no payload da linha BUSCA, a primeira do Mapeamento de campos. Preencha com o nome do dado que identifica a pessoa; o modo teste mostra esse nome." }, { "sintoma": "O envio aparece como Rejeitado", "causa": "", "solucao": "Abra o log e veja o Erro:\n- \"invalid_signature\": o envio não veio assinado com o segredo de Secret HMAC (opcional). Configure a assinatura no outro sistema ou, se ele não assina, clique em Remover, ao lado do segredo;\n- \"ip_not_allowed\": o envio veio de fora de IPs permitidos (vírgula-separados). Inclua o endereço ou deixe o campo vazio;\n- \"unsupported_media_type\" ou \"invalid_json\": o formato não foi reconhecido. Envie em JSON, como formulário ou com os dados na URL." }, { "sintoma": "O contato recebeu a tag, mas a automação não rodou", "causa": "", "solucao": "A tag só dispara a automação quando entra no contato: se ele já a tinha, o envio atualiza os dados, mas não dispara de novo. Para rodar a cada envio, termine a automação com o passo Remover tag, com a mesma tag, e confira se ela está ativa." }, { "sintoma": "Um campo do contato não foi preenchido", "causa": "", "solucao": "Veja no log os Campos atualizados e o Body. O campo não muda quando o dado não vem no envio, com Não alterar os dados existentes, ou com Só preencher campos que estiverem vazios se ele já tinha valor." } ], "para_ia": { "perguntas": [ "Receber dados de outros sistemas com webhooks?", "A aba Logs (48h) mostra \"Nenhum log nas últimas 48h.\", mas o outro sistema diz que enviou", "O envio aparece como Erro, com \"phone_extraction_failed\", \"whatsapp_extraction_failed\", \"email_extraction_failed\" ou \"contact_not_found_no_create\"", "Ao salvar, aparece \"Mapeie o campo\" ou o aviso de que \"toda chamada vai falhar\"", "O envio aparece como Rejeitado" ], "resposta": "Crie um endereço que formulários, CRMs e ferramentas como Zapier e n8n usam para criar contatos, preencher campos, aplicar tags e disparar automações. No menu lateral, clique em Automações e depois no cartão Webhooks. Clique em Novo webhook. Em Nome, escreva de onde vêm os dados, por exemplo Formulário do site, e clique em Criar e configurar. No topo da tela, clique em Copiar e cole a URL no outro sistema, como endereço de destino. No Zapier, no n8n e no Make, use a ação de requisição HTTP do tipo POST.", "escalar": [ "Integração por webhook com erro persistente" ] }, "relacionados": [ "usar-a-api-e-o-mcp", "automacao-basica", "contatos" ], "markdown": "---\nslug: receber-dados-com-webhooks\ncategoria: Automações e disparos\natualizado: 17/10/2026\ntags: webhook, integração, formulário, zapier, n8n, make, crm, receber dados, payload, url do webhook\nno_painel: Automações > Webhooks\nverificacao: baseado no guia oficial do painel\n---\n\n# Receber dados de outros sistemas com webhooks\n\nCrie um endereço que formulários, CRMs e ferramentas como Zapier e n8n usam para criar contatos, preencher campos, aplicar tags e disparar automações.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Só o dono e os admins do workspace criam, configuram e acompanham webhooks.\n- O outro sistema precisa enviar dados para uma URL (a opção costuma se chamar webhook, POST ou requisição HTTP), em JSON, como formulário ou na própria URL.\n- Crie antes, em **Personalização**, as tags e os campos personalizados que o webhook vai usar.\n\nUm webhook é um endereço na internet que outro sistema chama para mandar dados ao painel sozinho. Assim, o formulário do seu site, o seu CRM ou ferramentas como Zapier, n8n e Make criam e atualizam contatos na hora, preenchem campos, aplicam tags e, com elas, disparam automações.\n\n> **Atenção:** A URL do webhook funciona como uma senha: quem a tiver cria e altera contatos no seu workspace. Não a publique. Se ela vazar, clique em **Regenerar token**: a URL antiga para na hora, e o outro sistema precisa receber a nova.\n\n## Criar o webhook\n\n1. No menu lateral, clique em **Automações** e depois no cartão **Webhooks**.\n2. Clique em **Novo webhook**.\n3. Em **Nome**, escreva de onde vêm os dados, por exemplo *Formulário do site*, e clique em **Criar e configurar**.\n4. No topo da tela, clique em **Copiar** e cole a URL no outro sistema, como endereço de destino. No Zapier, no n8n e no Make, use a ação de requisição HTTP do tipo POST.\n\n## Descobrir os dados com o modo teste\n\n1. Na aba **Configuração**, clique em **Ativar modo teste**.\n2. No outro sistema, faça um envio de teste, como preencher o formulário. O aviso passa a mostrar \"Payload recebido em\" e a hora.\n3. Em **Campos detectados**, clique em **Usar como…** ao lado de cada dado e escolha o campo do contato, por exemplo *telefone* como **Telefone**. O envio inteiro aparece em **Payload recebido**.\n4. Ou clique em **Sugerir mapeamento**, que liga os dados de nomes conhecidos, como *nome*, *email* e *telefone*. Revise antes de salvar.\n\nO modo teste desliga sozinho alguns minutos depois de receber os dados, ou uns 15 minutos depois de ligado, se nada chegar.\n\n## Dizer como encontrar e preencher o contato\n\n1. Em **Como encontrar o contato**, escolha em **Buscar contato por (campo do sistema)** o dado que identifica a pessoa: **Telefone**, **WhatsApp** ou **E-mail**. Ele vira a primeira linha do **Mapeamento de campos**, com a marca **BUSCA**.\n2. Deixe **Criar contato se não existir** ligado para cadastrar quem ainda não é contato.\n3. Em **Se o contato já existir**, escolha **Atualizar campos com os novos dados**, **Só preencher campos que estiverem vazios** ou **Não alterar os dados existentes**. Dados que não vierem no envio nunca são apagados.\n4. Em **Mapeamento de campos**, confira as linhas: à esquerda fica o **Campo do contato** e, à direita, o **Caminho no payload**, que é o nome do dado no envio. Um dado dentro de outro leva ponto, como *data.telefone*. Para incluir outro campo, clique em **Adicionar mapeamento**.\n5. Em **Tags automáticas**, clique nas tags que o contato deve receber a cada envio.\n6. Confira se **Webhook ativo** está ligado e clique em **Salvar alterações**. Depois, clique em **Desligar**, no aviso do modo teste: enquanto ele está ligado, os envios só aparecem na tela e nenhum contato é criado.\n\n> **Atenção:** **ID externo do contato** é o código do contato aqui no painel, não o do cliente no seu CRM. Se **Sugerir mapeamento** ligar a ele um dado como *customer_id*, apague essa linha na lixeira: com o código de outro sistema, o envio dá **Erro**.\n\n## Disparar uma automação\n\n1. Em **Tags automáticas**, marque uma tag só deste webhook, por exemplo *Lead do site*, e salve.\n2. Crie uma automação com o gatilho **Tag aplicada** e essa tag, e escolha o que ela faz, como criar uma oportunidade no pipeline. Veja «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (artigo `automacao-basica`).\n3. Faça um envio real, com o modo teste desligado, e confira em **Execuções** se a automação rodou. Ela já encontra no contato os campos que o mesmo envio preencheu.\n\n## Acompanhar os envios\n\n1. Abra a aba **Logs (48h)** e clique num envio para ver o status, o **Body** com os dados que chegaram, os **Campos atualizados** e o **Erro**, quando houver.\n2. Depois de corrigir a configuração, abra um envio com **Erro** e clique em **Reprocessar**, que processa os mesmos dados de novo.\n\nPara apagar um webhook, clique em **Excluir** na lista e confirme: a URL para de funcionar, e os logs dele somem.\n\n## Não funcionou?\n\n- **A aba Logs (48h) mostra \"Nenhum log nas últimas 48h.\", mas o outro sistema diz que enviou**\n O envio foi recusado antes de virar registro. Confira:\n - se a URL no outro sistema está completa e é a atual: depois de **Regenerar token**, só a nova funciona;\n - se **Webhook ativo** está ligado e salvo, e se o modo teste está desligado;\n - se o envio é do tipo POST;\n - se o outro sistema recebeu um aviso de limite: o plano do workspace limita os envios por minuto e por dia. Espace os envios ou fale com o responsável pela sua agência.\n- **O envio aparece como Erro, com \"phone_extraction_failed\", \"whatsapp_extraction_failed\", \"email_extraction_failed\" ou \"contact_not_found_no_create\"**\n Nos três primeiros, o dado escolhido em **Buscar contato por (campo do sistema)** não veio no envio, ou o caminho da linha **BUSCA** está errado: compare com o **Body** do log. No último, o contato não existe e **Criar contato se não existir** está desligado. Corrija, salve e clique em **Reprocessar**.\n- **Ao salvar, aparece \"Mapeie o campo\" ou o aviso de que \"toda chamada vai falhar\"**\n Falta o **Caminho no payload** da linha **BUSCA**, a primeira do **Mapeamento de campos**. Preencha com o nome do dado que identifica a pessoa; o modo teste mostra esse nome.\n- **O envio aparece como Rejeitado**\n Abra o log e veja o **Erro**:\n - \"invalid_signature\": o envio não veio assinado com o segredo de **Secret HMAC (opcional)**. Configure a assinatura no outro sistema ou, se ele não assina, clique em **Remover**, ao lado do segredo;\n - \"ip_not_allowed\": o envio veio de fora de **IPs permitidos (vírgula-separados)**. Inclua o endereço ou deixe o campo vazio;\n - \"unsupported_media_type\" ou \"invalid_json\": o formato não foi reconhecido. Envie em JSON, como formulário ou com os dados na URL.\n- **O contato recebeu a tag, mas a automação não rodou**\n A tag só dispara a automação quando entra no contato: se ele já a tinha, o envio atualiza os dados, mas não dispara de novo. Para rodar a cada envio, termine a automação com o passo **Remover tag**, com a mesma tag, e confira se ela está ativa.\n- **Um campo do contato não foi preenchido**\n Veja no log os **Campos atualizados** e o **Body**. O campo não muda quando o dado não vem no envio, com **Não alterar os dados existentes**, ou com **Só preencher campos que estiverem vazios** se ele já tinha valor.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Receber dados de outros sistemas com webhooks?\n- A aba Logs (48h) mostra \"Nenhum log nas últimas 48h.\", mas o outro sistema diz que enviou\n- O envio aparece como Erro, com \"phone_extraction_failed\", \"whatsapp_extraction_failed\", \"email_extraction_failed\" ou \"contact_not_found_no_create\"\n- Ao salvar, aparece \"Mapeie o campo\" ou o aviso de que \"toda chamada vai falhar\"\n- O envio aparece como Rejeitado\n\nResposta curta: Crie um endereço que formulários, CRMs e ferramentas como Zapier e n8n usam para criar contatos, preencher campos, aplicar tags e disparar automações. No menu lateral, clique em Automações e depois no cartão Webhooks. Clique em Novo webhook. Em Nome, escreva de onde vêm os dados, por exemplo Formulário do site, e clique em Criar e configurar. No topo da tela, clique em Copiar e cole a URL no outro sistema, como endereço de destino. No Zapier, no n8n e no Make, use a ação de requisição HTTP do tipo POST.\n\nEscalar para um humano quando:\n- Integração por webhook com erro persistente\n\nVeja também: «Integrar outros sistemas pela API e pelo MCP» (`usar-a-api-e-o-mcp`); «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (`automacao-basica`); «Importar, cadastrar e organizar contatos» (`contatos`)\n" }, { "slug": "usar-a-api-e-o-mcp", "categoria": "Automações e disparos", "titulo": "Integrar outros sistemas pela API e pelo MCP", "resumo": "Crie a chave de API para ligar n8n, Make ou os seus sistemas ao workspace e conecte assistentes de IA, como o Claude e o ChatGPT, pelo MCP.", "tags": [ "api", "chave de api", "token", "mcp", "integração", "n8n", "make", "claude", "chatgpt", "desenvolvedor" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "API" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "A tela mostra \"API não incluída no seu plano\", ou a chave aparece como \"inativa no plano\"", "causa": "", "solucao": "A API e a conexão de assistentes não fazem parte do plano deste workspace. A chave que já existia continua guardada, mas todo pedido feito com ela é recusado. Se aparece o botão Ver planos, clique nele para ver as opções. Se não aparece, fale com o responsável pela sua agência." }, { "sintoma": "Perdi a chave ou não copiei a tempo", "causa": "", "solucao": "A chave só aparece uma vez e não dá para vê-la de novo. Revogue a chave atual, crie outra e troque em todas as integrações que usavam a antiga." }, { "sintoma": "Uma integração parou de funcionar", "causa": "", "solucao": "Abra a aba Sua chave. Se aparece Nenhuma chave criada, a chave foi revogada: crie outra e troque na integração. Se a chave está lá, confira a data do último uso e veja, na aba Documentação, em Limites, se a integração passou do limite de pedidos." }, { "sintoma": "Na autorização aparece \"Você não é dono ou administrador do workspace deste endereço\"", "causa": "", "solucao": "Só o dono e os administradores do workspace autorizam assistentes. Peça a um deles para fazer a conexão e confira se o endereço copiado é o do workspace certo." }, { "sintoma": "Aparece \"Pedido de autorização expirado ou inválido\"", "causa": "", "solucao": "O pedido de autorização venceu antes de ser concluído. Volte ao Claude ou ao ChatGPT e comece a conexão de novo." }, { "sintoma": "O assistente avisa que a franquia do Copiloto acabou", "causa": "", "solucao": "Na aba Copilotos, o quadro Uso do Copiloto mostra Franquia esgotada e quando ela renova. Todos os assistentes conectados ao workspace dividem a mesma franquia, e cada ação que eles executam conta uma vez. Aguarde a renovação para continuar." }, { "sintoma": "Aparece em Copilotos um assistente que não reconheço", "causa": "", "solucao": "O nome mostrado é o que o próprio aplicativo informou ao se conectar. Se você não reconhece a conexão, clique em Desconectar e confirme: ela perde o acesso na hora." } ], "para_ia": { "perguntas": [ "Integrar outros sistemas pela API e pelo MCP?", "A tela mostra \"API não incluída no seu plano\", ou a chave aparece como \"inativa no plano\"", "Perdi a chave ou não copiei a tempo", "Uma integração parou de funcionar", "Na autorização aparece \"Você não é dono ou administrador do workspace deste endereço\"" ], "resposta": "Crie a chave de API para ligar n8n, Make ou os seus sistemas ao workspace e conecte assistentes de IA, como o Claude e o ChatGPT, pelo MCP. No menu lateral, clique em API. Na aba Sua chave, clique em Criar chave. Em Nome, escreva onde a chave vai ser usada, por exemplo n8n produção, e clique em Criar. Na janela Sua chave foi criada, clique em Copiar, ao lado da Chave secreta, e guarde a chave num lugar seguro, como um gerenciador de senhas. Ela só aparece esta vez.", "escalar": [ "Chave de API vazada (gerar outra)" ] }, "relacionados": [ "receber-dados-com-webhooks", "ligar-seus-dados-ao-agente" ], "markdown": "---\nslug: usar-a-api-e-o-mcp\ncategoria: Automações e disparos\natualizado: 17/10/2026\ntags: api, chave de api, token, mcp, integração, n8n, make, claude, chatgpt, desenvolvedor\nno_painel: API\nverificacao: baseado no guia oficial do painel\n---\n\n# Integrar outros sistemas pela API e pelo MCP\n\nCrie a chave de API para ligar n8n, Make ou os seus sistemas ao workspace e conecte assistentes de IA, como o Claude e o ChatGPT, pelo MCP.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Só o dono e os administradores do workspace veem o menu **API** e autorizam assistentes de IA.\n- A API e a conexão de assistentes precisam fazer parte do plano do workspace. Se a tela mostrar **API não incluída no seu plano**, veja *Se algo der errado*.\n- O workspace tem uma chave por vez, e não dá para limitar o que ela acessa.\n- A chave costuma ser usada por quem monta integrações e automações. Para conectar o Claude ou o ChatGPT, você não precisa dela: basta copiar um endereço.\n\nA tela **API** liga o workspace a outros sistemas. A API é o jeito de um sistema conversar com o painel sem ninguém precisar clicar em nada. Com a chave de API, ferramentas como n8n, Make e Zapier, ou um sistema da sua empresa, leem e alteram contatos, tags, campos personalizados, pipelines e oportunidades do workspace.\n\nA mesma tela conecta assistentes de IA, como o Claude e o ChatGPT, pelo MCP, o padrão que esses assistentes usam para acessar outros sistemas. Com o assistente conectado, você pede em conversa o que quer montar, e ele cria agentes de IA, automações, tags e pipelines no workspace.\n\n> **Atenção:** A chave de API funciona como a senha do workspace: quem tem a chave lê e altera os dados dele. Não mande a chave por mensagem nem a deixe onde outras pessoas possam ver. Se ela vazar, revogue na hora e crie outra.\n\n## Criar a chave de API\n\n1. No menu lateral, clique em **API**.\n2. Na aba **Sua chave**, clique em **Criar chave**.\n3. Em **Nome**, escreva onde a chave vai ser usada, por exemplo *n8n produção*, e clique em **Criar**.\n4. Na janela **Sua chave foi criada**, clique em **Copiar**, ao lado da **Chave secreta**, e guarde a chave num lugar seguro, como um gerenciador de senhas. Ela só aparece esta vez.\n5. Clique em **Salvei a chave**. A janela só fecha por esse botão. Daí em diante, a aba **Sua chave** mostra só o começo e o fim da chave e a data do último uso.\n6. Cole a chave na ferramenta que vai usar a API. Na aba **Documentação**, a parte **API REST** mostra o endereço da API, como enviar a chave e tudo o que dá para fazer. Para o n8n, siga **Usando no n8n**.\n\n## Revogar a chave\n\nRevogue quando a chave vazar, quando alguém que a conhecia deixar a equipe ou quando quiser trocar por uma nova.\n\n1. Na aba **Sua chave**, clique em **Revogar**.\n2. Na janela **Revogar chave**, clique em **Revogar chave**. A chave para de funcionar na hora, e as integrações que a usam param junto.\n3. Clique em **Criar chave** para gerar outra e troque a chave em cada integração.\n\n## Conectar o Claude ou o ChatGPT\n\n1. Na aba **Copilotos**, clique em **Copiar endereço**. Cada workspace tem o seu endereço.\n2. No Claude ou no ChatGPT, adicione um conector e cole o endereço que a tela mostra. Os passos de cada assistente estão na aba **Documentação**, em **Conectar pelo navegador**.\n3. Na janela que abrir, entre com o seu login do painel. Confira o workspace e o que o aplicativo poderá fazer, e clique em **Autorizar**.\n4. Volte à aba **Copilotos**. O assistente aparece na lista, com o que ele pode fazer, como **Ler configuração** e **Criar e editar**.\n5. No assistente, peça o que você quer montar, por exemplo *monte o atendimento da minha clínica*.\n\n> **Dica:** Os agentes de IA e as automações que o assistente cria nascem desativados. Revise em **Agentes IA** e em **Automações** e ative quando estiver tudo certo.\n\nPara tirar o acesso de um assistente, clique em **Desconectar** no cartão dele e confirme em **Desconectar**. Assistentes ligados pelo terminal, como o Claude Code, usam a chave de API e não aparecem nessa lista. Os comandos para eles estão em **Conectar pelo terminal**, na aba **Documentação**, e para cortar o acesso deles você revoga a chave.\n\n## Não funcionou?\n\n- **A tela mostra \"API não incluída no seu plano\", ou a chave aparece como \"inativa no plano\"**\n A API e a conexão de assistentes não fazem parte do plano deste workspace. A chave que já existia continua guardada, mas todo pedido feito com ela é recusado. Se aparece o botão **Ver planos**, clique nele para ver as opções. Se não aparece, fale com o responsável pela sua agência.\n- **Perdi a chave ou não copiei a tempo**\n A chave só aparece uma vez e não dá para vê-la de novo. Revogue a chave atual, crie outra e troque em todas as integrações que usavam a antiga.\n- **Uma integração parou de funcionar**\n Abra a aba **Sua chave**. Se aparece **Nenhuma chave criada**, a chave foi revogada: crie outra e troque na integração. Se a chave está lá, confira a data do último uso e veja, na aba **Documentação**, em **Limites**, se a integração passou do limite de pedidos.\n- **Na autorização aparece \"Você não é dono ou administrador do workspace deste endereço\"**\n Só o dono e os administradores do workspace autorizam assistentes. Peça a um deles para fazer a conexão e confira se o endereço copiado é o do workspace certo.\n- **Aparece \"Pedido de autorização expirado ou inválido\"**\n O pedido de autorização venceu antes de ser concluído. Volte ao Claude ou ao ChatGPT e comece a conexão de novo.\n- **O assistente avisa que a franquia do Copiloto acabou**\n Na aba **Copilotos**, o quadro **Uso do Copiloto** mostra **Franquia esgotada** e quando ela renova. Todos os assistentes conectados ao workspace dividem a mesma franquia, e cada ação que eles executam conta uma vez. Aguarde a renovação para continuar.\n- **Aparece em Copilotos um assistente que não reconheço**\n O nome mostrado é o que o próprio aplicativo informou ao se conectar. Se você não reconhece a conexão, clique em **Desconectar** e confirme: ela perde o acesso na hora.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Integrar outros sistemas pela API e pelo MCP?\n- A tela mostra \"API não incluída no seu plano\", ou a chave aparece como \"inativa no plano\"\n- Perdi a chave ou não copiei a tempo\n- Uma integração parou de funcionar\n- Na autorização aparece \"Você não é dono ou administrador do workspace deste endereço\"\n\nResposta curta: Crie a chave de API para ligar n8n, Make ou os seus sistemas ao workspace e conecte assistentes de IA, como o Claude e o ChatGPT, pelo MCP. No menu lateral, clique em API. Na aba Sua chave, clique em Criar chave. Em Nome, escreva onde a chave vai ser usada, por exemplo n8n produção, e clique em Criar. Na janela Sua chave foi criada, clique em Copiar, ao lado da Chave secreta, e guarde a chave num lugar seguro, como um gerenciador de senhas. Ela só aparece esta vez.\n\nEscalar para um humano quando:\n- Chave de API vazada (gerar outra)\n\nVeja também: «Receber dados de outros sistemas com webhooks» (`receber-dados-com-webhooks`); «Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp» (`ligar-seus-dados-ao-agente`)\n" }, { "slug": "relatorios-de-ia", "categoria": "Automações e disparos", "titulo": "Criar relatórios de IA sobre o atendimento", "resumo": "Monte relatórios do atendimento escritos por um agente de IA, gere na hora ou agende, e receba no painel, por e-mail ou pelo WhatsApp.", "tags": [ "relatórios", "relatório de ia", "análise", "agendar relatório", "resumo do atendimento", "métricas", "insights" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Automações", "Relatórios de IA" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Aparece \"Relatórios de IA não está habilitado neste plano.\" ou \"Limite de relatórios ativos do plano esgotado.\" ao salvar", "causa": "", "solucao": "No primeiro caso, o plano do workspace não inclui a ferramenta. No segundo, o workspace já tem todos os relatórios ativos que o plano permite: desligue Ativo num relatório que não usa mais. Para mudar o plano, fale com o responsável pela sua agência." }, { "sintoma": "Ao clicar em Gerar agora, aparece \"Falha na ação (429: ai_reports_daily_limit_exceeded)\"", "causa": "", "solucao": "O workspace atingiu o limite diário de gerações do plano, somando manuais e agendadas, e os agendados do dia também deixam de sair. Tente no dia seguinte ou fale com o responsável pela sua agência." }, { "sintoma": "A geração aparece como Falhou, com \"missing_provider_credentials\", \"no_brain\" ou \"agent_not_found\"", "causa": "", "solucao": "No primeiro, falta a chave do provedor de IA que o agente usa: salve-a em Integrações. Nos outros, o agente foi excluído: escolha outro em Agente IA (cérebro) e salve. Outros textos costumam vir do provedor de IA, como falta de crédito. Depois, clique em Gerar agora de novo." }, { "sintoma": "Aparece \"Configuração de distribuição inválida — verifique os destinatários de e-mail.\" ao salvar", "causa": "", "solucao": "Apesar do texto, o aviso vale também para o WhatsApp. Confira:\n- no e-mail, se Toda a equipe está marcada ou se há ao menos um endereço válido;\n- no WhatsApp, se a Conexão WhatsApp está escolhida e se há ao menos um número;\n- na API Oficial, se há um template em Template aprovado (WABA)." }, { "sintoma": "O relatório ficou Concluído, mas o e-mail ou a mensagem de WhatsApp não chegou", "causa": "", "solucao": "O painel não mostra o resultado de cada envio. Confira se a integração Resend tem o e-mail remetente, se a conexão de WhatsApp está conectada, se os números têm DDI e DDD e, na API Oficial, se o template tem {{report_link}}. Se usa PDF, teste com Link “ver no navegador”." }, { "sintoma": "O relatório sumiu do Histórico ou o link recebido não abre mais", "causa": "", "solucao": "Cada geração fica guardada por 48 horas. Depois disso, ela sai do Histórico e o link deixa de abrir. Para guardar por mais tempo, prefira Arquivo PDF (anexo no e-mail, documento no WhatsApp)." }, { "sintoma": "A lista mostra \"Nenhum relatório disponível para suas permissões.\" ou o botão Gerar agora aparece apagado", "causa": "", "solucao": "Só o dono e os admins criam e geram relatórios; as outras pessoas só abrem os prontos. Quem tem canais limitados em Canais visíveis não vê nenhum, e os relatórios com contatos ou funis pedem as permissões Ver contatos e Ver todas as oportunidades. Peça a um admin ou fale com o responsável pela sua agência." } ], "para_ia": { "perguntas": [ "Criar relatórios de IA sobre o atendimento?", "Aparece \"Relatórios de IA não está habilitado neste plano.\" ou \"Limite de relatórios ativos do plano esgotado.\" ao salvar", "Ao clicar em Gerar agora, aparece \"Falha na ação (429: ai_reports_daily_limit_exceeded)\"", "A geração aparece como Falhou, com \"missing_provider_credentials\", \"no_brain\" ou \"agent_not_found\"", "Aparece \"Configuração de distribuição inválida — verifique os destinatários de e-mail.\" ao salvar" ], "resposta": "Monte relatórios do atendimento escritos por um agente de IA, gere na hora ou agende, e receba no painel, por e-mail ou pelo WhatsApp. No menu lateral, clique em Automações e depois no cartão Relatórios de IA. Clique em Novo relatório. Em Nome, escreva o objetivo, por exemplo Resumo semanal do atendimento. Em Agente IA (cérebro), escolha o agente que vai escrever a análise.", "escalar": [] }, "relacionados": [ "entender-o-dashboard", "integracoes-e-provedores-de-ia" ], "markdown": "---\nslug: relatorios-de-ia\ncategoria: Automações e disparos\natualizado: 17/10/2026\ntags: relatórios, relatório de ia, análise, agendar relatório, resumo do atendimento, métricas, insights\nno_painel: Automações > Relatórios de IA\nverificacao: baseado no guia oficial do painel\n---\n\n# Criar relatórios de IA sobre o atendimento\n\nMonte relatórios do atendimento escritos por um agente de IA, gere na hora ou agende, e receba no painel, por e-mail ou pelo WhatsApp.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Só o dono e os admins do workspace criam, editam, geram e excluem relatórios, e só se não tiverem os canais limitados em **Canais visíveis**. Quem tem acesso ao menu **Automações** e não tem canais limitados vê a lista e abre os relatórios prontos.\n- Tenha um agente de IA com o provedor de IA dele conectado em **Integrações**. O relatório usa o modelo desse agente e a chave do provedor dele, mas não as instruções de atendimento. Veja «Conectar um provedor de IA e outras integrações» (artigo `integracoes-e-provedores-de-ia`).\n- Para o e-mail, o workspace precisa da integração Resend com o e-mail remetente. Para o WhatsApp, de uma conexão em **Conexões** e, se ela for da API Oficial, de um template aprovado: veja «Criar e aprovar templates do WhatsApp oficial» (artigo `templates-whatsapp`).\n\nOs **Relatórios de IA** juntam os números do atendimento de um período, como volume de conversas, canais, horários e tempos de resposta, e um agente de IA escreve uma análise curta, com recomendações. Você gera na hora ou agenda, lê no painel e, se quiser, recebe por e-mail ou pelo WhatsApp.\n\n> **Atenção:** Os envios por e-mail e pelo WhatsApp saem de verdade, com os números de todo o workspace. A opção **Toda a equipe** manda para o e-mail de todos os membros, inclusive de quem só vê alguns canais. Confira os destinatários antes de salvar.\n\n## Criar o relatório\n\n1. No menu lateral, clique em **Automações** e depois no cartão **Relatórios de IA**.\n2. Clique em **Novo relatório**.\n3. Em **Nome**, escreva o objetivo, por exemplo *Resumo semanal do atendimento*.\n4. Em **Agente IA (cérebro)**, escolha o agente que vai escrever a análise.\n5. Em **Métricas**, marque o que entra, como **Resumo (volumes)**, **IA vs. humano**, **Tempo de atendimento (1ª resposta / resolução)** e **Desempenho por atendente**. Com **Funis (pipeline)**, marque ao menos um funil em **Funis incluídos**.\n6. Em **Período**, escolha, por exemplo, **Ontem**, **Últimos 7 dias** ou **Mês passado**. Em **Período personalizado**, preencha **De** e **Até**: os dois dias entram inteiros.\n7. Em **Agenda**, deixe **Manual (só quando eu clicar em Gerar agora)** ou escolha **Diário**, **Semanal** ou **Mensal**, com o **Horário**, o **Fuso** e, conforme o caso, o **Dia da semana** ou o **Dia do mês**. Se o mês não tiver o dia escolhido, como 31, o relatório sai no último dia. Para o resumo do dia anterior toda manhã, combine **Diário** com **Ontem**.\n8. Para receber o relatório fora do painel, siga a próxima parte antes de salvar. Depois, confira se **Ativo** está ligado e clique em **Salvar**.\n\n## Enviar por e-mail ou pelo WhatsApp\n\nEm **Distribuição**, o relatório fica sempre disponível no painel; os envios são opcionais.\n\n1. Para o e-mail, ligue **Enviar por e-mail**. Marque **Toda a equipe** ou, em **E-mails avulsos**, clique em **Adicionar e-mail** para cada endereço.\n2. Para o WhatsApp, ligue **Enviar por WhatsApp**, escolha a **Conexão WhatsApp** e, em **Telefones**, clique em **Adicionar telefone** para cada número, com DDI e DDD, só números (ex.: 5511999999999). Cada número vira um contato, ou usa o que já existe, e a mensagem aparece na conversa com ele, em **Conversas**.\n3. Se a conexão for da API Oficial, com *(WABA)* no fim do nome, escolha o template em **Template aprovado (WABA)** e digite `{{report_link}}` na variável onde o link deve entrar, por exemplo em **Variáveis do corpo**.\n4. Em **Formato de envio**, escolha **Link “ver no navegador”** ou **Arquivo PDF (anexo no e-mail, documento no WhatsApp)**. Pela API Oficial, vai sempre o link.\n5. Clique em **Salvar**.\n\n## Gerar e ver o resultado\n\n1. Na lista, clique em **Gerar agora**, na linha do relatório. O **Histórico** abre logo abaixo, com a geração **Na fila** e depois **Gerando…**.\n2. Quando aparecer **Concluído**, clique em **Visualizar**. O relatório abre em outra aba, com a análise e os números.\n3. Para rever gerações, clique em **Histórico**. Os agendados entram ali sozinhos, alguns minutos depois do horário marcado. O **Histórico** guarda só as últimas 48 horas.\n\n## Editar, pausar ou excluir\n\n1. Para mudar um relatório, clique no nome dele na lista, altere e clique em **Salvar**.\n2. Para pausar a agenda, abra o relatório, desligue **Ativo** e salve. Ele passa a aparecer como **Inativo** e deixa de sair no horário, mas **Gerar agora** continua funcionando.\n3. Para excluir, clique no ícone da lixeira, na linha do relatório, e em **Excluir**. O relatório e todo o histórico dele são apagados.\n\n## Não funcionou?\n\n- **Aparece \"Relatórios de IA não está habilitado neste plano.\" ou \"Limite de relatórios ativos do plano esgotado.\" ao salvar**\n No primeiro caso, o plano do workspace não inclui a ferramenta. No segundo, o workspace já tem todos os relatórios ativos que o plano permite: desligue **Ativo** num relatório que não usa mais. Para mudar o plano, fale com o responsável pela sua agência.\n- **Ao clicar em Gerar agora, aparece \"Falha na ação (429: ai_reports_daily_limit_exceeded)\"**\n O workspace atingiu o limite diário de gerações do plano, somando manuais e agendadas, e os agendados do dia também deixam de sair. Tente no dia seguinte ou fale com o responsável pela sua agência.\n- **A geração aparece como Falhou, com \"missing_provider_credentials\", \"no_brain\" ou \"agent_not_found\"**\n No primeiro, falta a chave do provedor de IA que o agente usa: salve-a em **Integrações**. Nos outros, o agente foi excluído: escolha outro em **Agente IA (cérebro)** e salve. Outros textos costumam vir do provedor de IA, como falta de crédito. Depois, clique em **Gerar agora** de novo.\n- **Aparece \"Configuração de distribuição inválida — verifique os destinatários de e-mail.\" ao salvar**\n Apesar do texto, o aviso vale também para o WhatsApp. Confira:\n - no e-mail, se **Toda a equipe** está marcada ou se há ao menos um endereço válido;\n - no WhatsApp, se a **Conexão WhatsApp** está escolhida e se há ao menos um número;\n - na API Oficial, se há um template em **Template aprovado (WABA)**.\n- **O relatório ficou Concluído, mas o e-mail ou a mensagem de WhatsApp não chegou**\n O painel não mostra o resultado de cada envio. Confira se a integração Resend tem o e-mail remetente, se a conexão de WhatsApp está conectada, se os números têm DDI e DDD e, na API Oficial, se o template tem `{{report_link}}`. Se usa PDF, teste com **Link “ver no navegador”**.\n- **O relatório sumiu do Histórico ou o link recebido não abre mais**\n Cada geração fica guardada por 48 horas. Depois disso, ela sai do **Histórico** e o link deixa de abrir. Para guardar por mais tempo, prefira **Arquivo PDF (anexo no e-mail, documento no WhatsApp)**.\n- **A lista mostra \"Nenhum relatório disponível para suas permissões.\" ou o botão Gerar agora aparece apagado**\n Só o dono e os admins criam e geram relatórios; as outras pessoas só abrem os prontos. Quem tem canais limitados em **Canais visíveis** não vê nenhum, e os relatórios com contatos ou funis pedem as permissões **Ver contatos** e **Ver todas as oportunidades**. Peça a um admin ou fale com o responsável pela sua agência.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Criar relatórios de IA sobre o atendimento?\n- Aparece \"Relatórios de IA não está habilitado neste plano.\" ou \"Limite de relatórios ativos do plano esgotado.\" ao salvar\n- Ao clicar em Gerar agora, aparece \"Falha na ação (429: ai_reports_daily_limit_exceeded)\"\n- A geração aparece como Falhou, com \"missing_provider_credentials\", \"no_brain\" ou \"agent_not_found\"\n- Aparece \"Configuração de distribuição inválida — verifique os destinatários de e-mail.\" ao salvar\n\nResposta curta: Monte relatórios do atendimento escritos por um agente de IA, gere na hora ou agende, e receba no painel, por e-mail ou pelo WhatsApp. No menu lateral, clique em Automações e depois no cartão Relatórios de IA. Clique em Novo relatório. Em Nome, escreva o objetivo, por exemplo Resumo semanal do atendimento. Em Agente IA (cérebro), escolha o agente que vai escrever a análise.\n\nVeja também: «Entender o Dashboard: atendimento, negócios e anúncios» (`entender-o-dashboard`); «Conectar um provedor de IA e outras integrações» (`integracoes-e-provedores-de-ia`)\n" }, { "slug": "consultar-a-base-de-dados", "categoria": "Automações e disparos", "titulo": "Consultar e editar as tabelas do seu Supabase no painel", "resumo": "Veja, busque e corrija sem sair do painel os registros das tabelas do projeto Supabase da sua empresa, conectado em Integrações.", "tags": [ "supabase", "banco de dados", "tabelas", "registros", "base de dados", "editar dados" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Automações", "Base de dados Supabase" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Aparece \"Conecte um projeto Supabase em Integrações para usar esta ferramenta.\"", "causa": "", "solucao": "O workspace ainda não tem o projeto Supabase conectado. Clique em Ir para Integrações e conecte, ou peça a quem cuida das integrações do workspace." }, { "sintoma": "Aparece \"Nenhuma tabela foi liberada para consulta nesta conexão ainda.\" ou falta uma tabela na lista", "causa": "", "solucao": "O dono ou um admin precisa liberar a tabela em Configurações. Se a tela diz que há tabelas do projeto que \"ainda não foram liberadas\", elas existem, mas estão fora da lista. Se a tabela aparece com \"(não existe mais no projeto)\", ela foi renomeada ou apagada no Supabase: em Configurações, marque-a como Removida e salve." }, { "sintoma": "Aparece \"Erro ao carregar conexões: você não tem permissão para esta ação.\"", "causa": "", "solucao": "Falta a permissão Ver base de dados. Peça ao dono ou a um admin que a ligue nas suas permissões, em Equipe." }, { "sintoma": "Aparece \"esta tabela não está liberada para você\" ou \"esta conexão não foi encontrada\"", "causa": "", "solucao": "No primeiro caso, a tabela foi desligada ou removida em Configurações enquanto você a usava: escolha outra ou peça ao dono ou a um admin para revisar. No segundo, a integração do Supabase foi removida ou desativada, ou a URL salva não vale: confira o cartão Supabase, em Integrações. Se ela foi cadastrada de novo, libere as tabelas outra vez: a configuração antiga não passa para a nova conexão." }, { "sintoma": "Aparece \"A chave cadastrada em Integrações para esta conexão não permite ler o schema do projeto Supabase.\"", "causa": "", "solucao": "A chave salva é a publicável, e a ferramenta precisa da secreta. Em Integrações, edite a integração do Supabase e cole em API Key a chave secreta (service_role) do projeto." }, { "sintoma": "Aparece \"O projeto Supabase do cliente não respondeu a tempo\" ou \"muitas tentativas em sequência\"", "causa": "", "solucao": "No primeiro caso, o projeto pode estar pausado: o Supabase pausa projetos gratuitos parados há um tempo. Reative o projeto no Supabase e tente de novo. No segundo, a conexão recebeu muitos pedidos em pouco tempo: aguarde um minuto." }, { "sintoma": "Ao salvar, aparece \"Este registro mudou enquanto você editava — provavelmente pelo Agente IA.\"", "causa": "", "solucao": "Alguém, quase sempre o agente de IA, mudou o registro depois que você abriu a ficha. A tela mostra, campo a campo, o que você viu e o valor atual. Clique em Recarregar para trazer os valores novos e refazer a sua mudança, ou em Salvar mesmo assim para gravar por cima." } ], "para_ia": { "perguntas": [ "Consultar e editar as tabelas do seu Supabase no painel?", "Aparece \"Conecte um projeto Supabase em Integrações para usar esta ferramenta.\"", "Aparece \"Nenhuma tabela foi liberada para consulta nesta conexão ainda.\" ou falta uma tabela na lista", "Aparece \"Erro ao carregar conexões: você não tem permissão para esta ação.\"", "Aparece \"esta tabela não está liberada para você\" ou \"esta conexão não foi encontrada\"" ], "resposta": "Veja, busque e corrija sem sair do painel os registros das tabelas do projeto Supabase da sua empresa, conectado em Integrações. No menu lateral, clique em Automações e depois no cartão Base de dados Supabase. Clique em Configurações, no alto da tela. Confira a Conexão. A lista mostra as tabelas do projeto; para achar uma, digite o nome em Filtrar tabelas. Se a tabela foi criada há pouco no Supabase, clique em Recarregar schema. Em Acesso, escolha para cada tabela: Liberada, para a equipe ver e usar; Desligada, para esconder a tabela guardando a configuração; ou Removida, que tira a tabela da lista e apaga a configuração. Tabelas novas começam como Removida.", "escalar": [] }, "relacionados": [ "catalogo-de-produtos", "ligar-seus-dados-ao-agente" ], "markdown": "---\nslug: consultar-a-base-de-dados\ncategoria: Automações e disparos\natualizado: 17/10/2026\ntags: supabase, banco de dados, tabelas, registros, base de dados, editar dados\nno_painel: Automações > Base de dados Supabase\nverificacao: baseado no guia oficial do painel\n---\n\n# Consultar e editar as tabelas do seu Supabase no painel\n\nVeja, busque e corrija sem sair do painel os registros das tabelas do projeto Supabase da sua empresa, conectado em Integrações.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- O projeto Supabase da empresa precisa estar conectado em **Integrações**, no cartão **Supabase**, com a **URL do Projeto** e, em **API Key**, a chave secreta (service_role) do projeto. Essa chave dá acesso total ao seu banco, como uma senha: não a compartilhe. Veja «Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp» (artigo `ligar-seus-dados-ao-agente`).\n- Só o dono e os admins do workspace escolhem, em **Configurações**, quais tabelas aparecem e o nível de acesso de cada uma.\n- As outras pessoas precisam do menu **Automações** e da permissão **Ver base de dados**, no grupo **Agentes IA** das permissões do membro, em **Equipe**. Donos e admins já têm por padrão. Veja «Convidar pessoas para a equipe e definir o que cada uma acessa» (artigo `convidar-equipe`).\n\nA **Base de dados** mostra, dentro do painel, as tabelas do projeto Supabase da sua empresa: o mesmo projeto conectado em **Integrações**, que o agente de IA pode usar nas conversas. A equipe busca um cliente, confere um pedido ou corrige um dado sem abrir o Supabase. O dono ou um admin escolhe quais tabelas aparecem e quais podem ser editadas.\n\n> **Atenção:** O que você salva ou exclui aqui grava na hora no seu projeto Supabase, e excluir não tem desfazer. A lista de tabelas liberadas vale só para as pessoas: o agente de IA continua alcançando todas as tabelas do projeto.\n\n## Liberar as tabelas (dono ou admin)\n\n1. No menu lateral, clique em **Automações** e depois no cartão **Base de dados Supabase**.\n2. Clique em **Configurações**, no alto da tela.\n3. Confira a **Conexão**. A lista mostra as tabelas do projeto; para achar uma, digite o nome em **Filtrar tabelas**. Se a tabela foi criada há pouco no Supabase, clique em **Recarregar schema**.\n4. Em **Acesso**, escolha para cada tabela: **Liberada**, para a equipe ver e usar; **Desligada**, para esconder a tabela guardando a configuração; ou **Removida**, que tira a tabela da lista e apaga a configuração. Tabelas novas começam como **Removida**.\n5. Em **Nível de acesso**, escolha **Ler**, só para consulta, ou **Ler e editar**. O nível vale para todos, inclusive para o dono.\n6. Clique em **Salvar** e aguarde a mensagem **Allowlist salva.**\n\n## Consultar um registro\n\n1. Na tela **Base de dados**, escolha a **Conexão** e, em **Tabela**, a tabela. Se ela for só de consulta, aparece ao lado a marca **somente leitura**.\n2. Em **Buscar…**, digite parte de um texto, como um nome ou um e-mail. A busca procura nas colunas de texto da tabela, e não em números ou datas.\n3. Use **Anterior** e **Próxima** para trocar de página: cada uma traz até 50 registros. Abaixo da lista aparece o total ou, se houver mais páginas, uma estimativa com \"≈\".\n4. Clique numa linha para abrir a ficha do registro, com todos os campos.\n\n## Editar, criar ou excluir um registro\n\nIsso só vale para tabelas com **Ler e editar**. Tabelas sem uma chave primária única, o código que identifica cada linha, só podem ser consultadas, e a tela avisa.\n\n1. Na ficha, altere os campos e clique em **Salvar**. Só o que você mudou é gravado. O campo com a marca **PK** não muda, e os campos com * são obrigatórios.\n2. Campos com listas ou dados agrupados aparecem como texto em JSON, um formato padrão de escrever dados. Se o texto ficar incompleto, aparece **JSON inválido** e nada é salvo. Datas com hora aparecem como texto, do jeito que estão no banco.\n3. Para criar, clique em **Novo registro**, ao lado da busca, preencha os campos e clique em **Criar registro**. Os campos que você não tocar ficam com o valor padrão da tabela, se houver.\n4. Para excluir, abra o registro, clique em **Excluir** e confirme em **Excluir**. Se estiver aprendendo, teste antes com um registro de teste criado por você.\n\n## Não funcionou?\n\n- **Aparece \"Conecte um projeto Supabase em Integrações para usar esta ferramenta.\"**\n O workspace ainda não tem o projeto Supabase conectado. Clique em **Ir para Integrações** e conecte, ou peça a quem cuida das integrações do workspace.\n- **Aparece \"Nenhuma tabela foi liberada para consulta nesta conexão ainda.\" ou falta uma tabela na lista**\n O dono ou um admin precisa liberar a tabela em **Configurações**. Se a tela diz que há tabelas do projeto que \"ainda não foram liberadas\", elas existem, mas estão fora da lista. Se a tabela aparece com \"(não existe mais no projeto)\", ela foi renomeada ou apagada no Supabase: em **Configurações**, marque-a como **Removida** e salve.\n- **Aparece \"Erro ao carregar conexões: você não tem permissão para esta ação.\"**\n Falta a permissão **Ver base de dados**. Peça ao dono ou a um admin que a ligue nas suas permissões, em **Equipe**.\n- **Aparece \"esta tabela não está liberada para você\" ou \"esta conexão não foi encontrada\"**\n No primeiro caso, a tabela foi desligada ou removida em **Configurações** enquanto você a usava: escolha outra ou peça ao dono ou a um admin para revisar. No segundo, a integração do Supabase foi removida ou desativada, ou a URL salva não vale: confira o cartão **Supabase**, em **Integrações**. Se ela foi cadastrada de novo, libere as tabelas outra vez: a configuração antiga não passa para a nova conexão.\n- **Aparece \"A chave cadastrada em Integrações para esta conexão não permite ler o schema do projeto Supabase.\"**\n A chave salva é a publicável, e a ferramenta precisa da secreta. Em **Integrações**, edite a integração do Supabase e cole em **API Key** a chave secreta (service_role) do projeto.\n- **Aparece \"O projeto Supabase do cliente não respondeu a tempo\" ou \"muitas tentativas em sequência\"**\n No primeiro caso, o projeto pode estar pausado: o Supabase pausa projetos gratuitos parados há um tempo. Reative o projeto no Supabase e tente de novo. No segundo, a conexão recebeu muitos pedidos em pouco tempo: aguarde um minuto.\n- **Ao salvar, aparece \"Este registro mudou enquanto você editava — provavelmente pelo Agente IA.\"**\n Alguém, quase sempre o agente de IA, mudou o registro depois que você abriu a ficha. A tela mostra, campo a campo, o que você viu e o valor atual. Clique em **Recarregar** para trazer os valores novos e refazer a sua mudança, ou em **Salvar mesmo assim** para gravar por cima.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Consultar e editar as tabelas do seu Supabase no painel?\n- Aparece \"Conecte um projeto Supabase em Integrações para usar esta ferramenta.\"\n- Aparece \"Nenhuma tabela foi liberada para consulta nesta conexão ainda.\" ou falta uma tabela na lista\n- Aparece \"Erro ao carregar conexões: você não tem permissão para esta ação.\"\n- Aparece \"esta tabela não está liberada para você\" ou \"esta conexão não foi encontrada\"\n\nResposta curta: Veja, busque e corrija sem sair do painel os registros das tabelas do projeto Supabase da sua empresa, conectado em Integrações. No menu lateral, clique em Automações e depois no cartão Base de dados Supabase. Clique em Configurações, no alto da tela. Confira a Conexão. A lista mostra as tabelas do projeto; para achar uma, digite o nome em Filtrar tabelas. Se a tabela foi criada há pouco no Supabase, clique em Recarregar schema. Em Acesso, escolha para cada tabela: Liberada, para a equipe ver e usar; Desligada, para esconder a tabela guardando a configuração; ou Removida, que tira a tabela da lista e apaga a configuração. Tabelas novas começam como Removida.\n\nVeja também: «Montar o catálogo de produtos e deixar o agente consultar» (`catalogo-de-produtos`); «Ligar seus dados ao agente: Google Workspace, Notion, Baserow, Supabase, n8n e ClickUp» (`ligar-seus-dados-ao-agente`)\n" }, { "slug": "organizar-tarefas", "categoria": "Equipe", "titulo": "Organizar tarefas da equipe", "resumo": "Crie tarefas para pessoas ou departamentos, acompanhe prazos e registre os próximos passos do atendimento.", "tags": [ "tarefas", "to-do", "prazo", "lembrete", "departamento", "atribuir tarefa", "follow-up interno", "pendências" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Tarefas" ], "atualizado": "17/10/2026", "faq": [], "problemas": [], "para_ia": { "perguntas": [ "Organizar tarefas da equipe?" ], "resposta": "Crie tarefas para pessoas ou departamentos, acompanhe prazos e registre os próximos passos do atendimento. Clique em Criar tarefa e informe um título. Você já aparece como responsável; troque a pessoa se precisar. Clique em Criar tarefa para salvar. Na edição, use Salvar.", "escalar": [] }, "relacionados": [ "convidar-equipe", "conversar-com-a-equipe", "automacao-basica" ], "markdown": "---\nslug: organizar-tarefas\ncategoria: Equipe\natualizado: 17/10/2026\ntags: tarefas, to-do, prazo, lembrete, departamento, atribuir tarefa, follow-up interno, pendências\nno_painel: Tarefas\nverificacao: baseado no guia oficial do painel\n---\n\n# Organizar tarefas da equipe\n\nCrie tarefas para pessoas ou departamentos, acompanhe prazos e registre os próximos passos do atendimento.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\nEm **Tarefas**, acompanhe atividades internas e ações vinculadas a contatos, conversas ou oportunidades. Cada tarefa pertence ao workspace aberto.\n\nA tarefa funciona sem fluxo de automação: basta informar o título e escolher uma pessoa ou departamento. Prazo, lembrete, contato e automações são opcionais. Se quiser, associe um fluxo a um evento da tarefa; ele pode executar as ações configuradas, como notificar a equipe ou solicitar um relatório.\n\n## Criar e distribuir\n\n1. Clique em **Criar tarefa** e informe um título. Você já aparece como responsável; troque a pessoa se precisar.\n2. Clique em **Criar tarefa** para salvar. Na edição, use **Salvar**.\n\nPara acrescentar detalhes, abra **Mais opções**. Ali ficam descrição, departamento, prioridade, prazo, lembrete, contato e **Automações (opcional)**. Para deixar na fila de um departamento, selecione o departamento e mantenha **Aguardando responsável**. Um integrante autorizado poderá clicar em **Assumir tarefa**.\n\nO lembrete fica em **Prazo e lembrete**, junto às datas. O formulário indica o fuso do workspace. Sem horário, o prazo termina ao final do dia.\n\nNo chat ao vivo, **Tarefas** abre diretamente **Criar tarefa**. Use **Ver tarefas do contato** para consultar atividades já existentes, inclusive de outras conversas permitidas, sem perder o rascunho. Também é possível abrir **Tarefas** no contato e na oportunidade. No menu de uma mensagem, **Criar tarefa** guarda sua referência e vincula a conversa. O responsável pela tarefa pode ser diferente de quem atende a conversa. O destino precisa ter acesso ao contexto vinculado.\n\nPara revisões internas ou entrega de relatórios, deixe **Vincular contato ou oportunidade** recolhido. Se precisar de um vínculo, abra essa seção e escolha o contato. Escolha o responsável ou departamento e, se precisar, um lembrete e um fluxo.\n\n## Acompanhar e concluir\n\nUse **Minhas tarefas**, **Meus departamentos**, **Criadas por mim** ou **Todas as permitidas**. Filtre por prazo, status, departamento, responsável e prioridade. Use **Mais filtros** para departamento, responsável e prioridade; **Limpar filtros** restaura a visão atual. Abra uma tarefa para comentar, editar ou mudar o status para **Concluída** ou **Cancelada**. Para reabrir, volte para **Pendente**.\n\nAtraso é calculado pelo prazo. Ele continua contando enquanto a tarefa está na fila. Ao trocar de departamento, escolha um responsável elegível ou deixe na fila. Ao mudar o prazo, configure novamente o lembrete.\n\nSem ação automática configurada, concluir uma tarefa não envia mensagem ao cliente nem encerra a conversa. O histórico conserva as mudanças e os comentários. Se outra pessoa alterar a tarefa durante sua edição, recarregue antes de salvar novamente.\n\n## Acionar um fluxo no lembrete\n\nAbra **Automações (opcional)**, escolha **Fluxo no lembrete (opcional)** e informe uma data e hora futuras. O fluxo pode estar com seu disparo automático desativado: o lembrete inicia a execução sob demanda. Para avisar outro atendente, configure **Notificar agente humano** dentro do fluxo e selecione o destinatário e o canal da notificação.\n\nTarefas internas também podem iniciar fluxos, sem contato ou conversa. Por exemplo, crie uma tarefa para entregar um relatório e use **Notificar agente humano** no fluxo para lembrar um membro da equipe. Para ações que precisam de um atendimento, crie a tarefa pelo chat da conversa desejada. A verificação ocorre a cada cinco minutos, independentemente da preferência de push; filas podem acrescentar tempo. A tarefa precisa estar pendente ou em andamento. Concluir ou cancelar a tarefa, ou remover ou reagendar o lembrete, cancela a ação do lembrete que ainda não começou. Ao mudar o prazo, configure novamente o lembrete ou selecione **Nenhuma ação**. Um fluxo já ativo na conversa não é substituído; confira o resultado no histórico. Se lembrete e atraso forem processados juntos, suas ações são consideradas separadamente, com um único aviso de tarefa.\n\n## Ações automáticas da tarefa\n\nEm **Automações (opcional)**, escolha uma ação para cada evento: **Ao criar**, **Ao atribuir ou transferir**, **Ao atrasar** e **Ao concluir**. Cada evento pode ficar sem ação, **Aplicar etiqueta** ou **Iniciar fluxo**. Para **Iniciar fluxo**, o contato e a conversa são opcionais. **Aplicar etiqueta** exige um contato.\n\n**Ao criar** aparece somente durante a criação da tarefa. Na edição, ficam disponíveis as ações de atribuição, atraso e conclusão.\n\n- **Aplicar etiqueta:** selecione a etiqueta que inicia suas automações. O gatilho de etiqueta adicionada é emitido uma vez por evento da tarefa, mesmo se a etiqueta já estiver no contato. As regras e os canais dessas automações continuam valendo.\n- **Iniciar fluxo:** selecione um fluxo existente, inclusive para tarefas internas sem contato. Configure o destinatário e o canal em **Notificar agente humano**. Ações que dependem de contato ou conversa precisam desse contexto; crie a tarefa pelo chat para vincular a conversa exata. O fluxo pode ser chamado sob demanda, mesmo com seu disparo automático desativado. Se já houver um fluxo ativo na conversa, a ação não o substitui; o motivo aparece no histórico.\n- **Ao atribuir ou transferir:** vale para a atribuição inicial na criação, troca de responsável/departamento e quando alguém assume a fila. Se configurar também uma ação de criação, os dois eventos têm ações próprias.\n- **Ao atrasar:** exige prazo e só dispara enquanto a tarefa estiver pendente ou em andamento. Sem horário, considera o fim do dia no fuso da tarefa. Alterar o prazo ou concluir cancela a ação de atraso que ainda não começou. Cada vencimento é registrado uma vez; reagendar ou reabrir permite um novo vencimento.\n- **Ao concluir:** dispara na mudança para concluída. Salvar novamente uma tarefa já concluída não repete a ação; reabrir e concluir novamente gera um novo evento.\n\nA criação, atribuição e conclusão tentam encaminhar a ação em segundo plano após salvar. A verificação de atrasos e recuperação ocorre a cada cinco minutos, sujeita à fila. O histórico mostra ações aguardando, encaminhadas, não executadas ou com falha. Encaminhada significa entregue ao processamento de automações; o resultado do fluxo é consultado no histórico da própria automação.\n\nEditar as configurações não executa eventos antigos. As permissões e o acesso de quem configurou são conferidos novamente antes de iniciar a ação. Excluir a tarefa cancela um fluxo preparado que ainda não foi encaminhado; fluxos já encaminhados seguem seu próprio ciclo.\n\nNos textos do fluxo, você pode usar `{{task.title}}` e `{{task.description}}` para incluir o título e a descrição da tarefa na notificação. Sem contato vinculado, as variáveis de contato ficam vazias.\n\n## Avisos e acesso\n\n**Avisos não lidos** reúne atualizações das suas tarefas. Abrir a tarefa marca seus avisos como lidos. Abra **Preferências de notificações** abaixo da lista para ajustar o push. O push depende da inscrição do dispositivo e da opção **Receber avisos de tarefas neste workspace por push**. Os avisos externos são processados periodicamente, normalmente em até cinco minutos, podendo demorar mais quando houver fila ou falhas de entrega.\n\nO criador acompanha quem assumiu e a conclusão. Depois que uma pessoa assume, os lembretes vão para ela. As permissões de tarefas são configuradas em **Equipe**; receber uma tarefa não libera acesso adicional à conversa ou ao contato.\n\nRemover uma pessoa ou departamento preserva tarefas para redistribuição. Mesclar contatos mantém as tarefas no contato de destino. Excluir definitivamente um contato, conversa ou oportunidade remove as tarefas vinculadas e seu histórico.\n\n## Criar tarefas por automação\n\nNo editor **Básico** ou **Fluxo**, adicione uma ação e escolha **Criar tarefa**. Informe o título e, se necessário, a descrição; os dois aceitam variáveis do contato e da automação. Escolha um responsável ou um departamento e defina a prioridade.\n\nO prazo pode ficar vazio, ser calculado **Após a execução** (dias, horas ou minutos) ou usar **Data e hora específicas**, inclusive uma variável. O cálculo usa o fuso do workspace. Dias preservam o horário local; horas e minutos contam a duração. O lembrete é opcional: informe quantos minutos antes do prazo; zero lembra no próprio prazo e vazio não cria lembrete. O instante do lembrete precisa estar no futuro.\n\nA tarefa nasce pendente e herda o contato, a conversa e a oportunidade disponíveis no contexto. Sem vínculos, é uma tarefa interna. O destino precisa ter acesso aos vínculos. As permissões atuais de quem salvou a automação são verificadas na execução: é necessário poder visualizar/criar tarefas e atribuí-las quando o destino for outra pessoa ou um departamento.\n\nCada ação cria uma tarefa por execução da automação. Retentativas ou uma nova passagem pela mesma ação na mesma execução reutilizam a tarefa, preservando alterações feitas pela equipe. Outra ação de criação ou uma nova execução pode criar outra tarefa. O resultado aparece no histórico da automação e a tarefa na central de **Tarefas**.\n\n## Excluir uma tarefa\n\nAbra os detalhes da tarefa e clique em **Excluir tarefa**. Confira o nome e confirme em **Excluir definitivamente**. A opção aparece para quem pode editar essa tarefa: seu criador, responsável ou alguém com permissão de atribuir tarefas, sempre com acesso ao contexto vinculado.\n\nA exclusão remove permanentemente a tarefa, comentários, histórico, avisos e ações pendentes. Contatos, conversas e oportunidades vinculados são preservados. Ações já iniciadas não são desfeitas. Para manter o histórico, use o status **Cancelada**. Se a tarefa tiver sido alterada por outra pessoa, recarregue e revise antes de excluir.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Organizar tarefas da equipe?\n\nResposta curta: Crie tarefas para pessoas ou departamentos, acompanhe prazos e registre os próximos passos do atendimento. Clique em Criar tarefa e informe um título. Você já aparece como responsável; troque a pessoa se precisar. Clique em Criar tarefa para salvar. Na edição, use Salvar.\n\nVeja também: «Convidar pessoas para a equipe e definir o que cada uma acessa» (`convidar-equipe`); «Conversar com a equipe pelo chat interno» (`conversar-com-a-equipe`); «Criar uma Automação Básica: quando isso acontecer, faça aquilo» (`automacao-basica`)\n" }, { "slug": "conversar-com-a-equipe", "categoria": "Equipe", "titulo": "Conversar com a equipe pelo chat interno", "resumo": "Converse com colegas, grupos e departamentos e peça ajuda a agentes de IA internos pelo botão do chat da equipe.", "tags": [ "chat interno", "chat da equipe", "grupo", "mensagem para colega", "agente interno", "departamento", "menção" ], "publico": "Donos, administradores e equipe que usam o painel.", "no_painel": [ "Chat da equipe" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O botão do chat da equipe sumiu da tela Conversas", "causa": "", "solucao": "Ele foi ocultado neste navegador. Em Configurações, na seção Chat ao vivo, ligue Exibir bolha do chat da equipe nas conversas. Ou, numa conversa aberta, clique em Mais ações (⋮) e em Mostrar bolha da equipe." }, { "sintoma": "Um colega me escreveu, mas a conversa não aparece na minha lista", "causa": "", "solucao": "Uma conversa nova que outra pessoa criou com você pode levar até 5 minutos para aparecer na lista e no número do botão. Para ver na hora, recarregue a página. Já as mensagens novas em conversas que estão na lista chegam na hora." }, { "sintoma": "Aparece \"Nenhum outro membro\"", "causa": "", "solucao": "Você é a única pessoa no workspace. Veja «Convidar pessoas para a equipe e definir o que cada uma acessa»." }, { "sintoma": "Aparece \"Nenhum departamento\"", "causa": "", "solucao": "O workspace não tem departamento ativo. Quem gerencia a equipe cria um em Equipe, na aba Equipes, com Nova equipe. Uma equipe com Equipe ativa desligada não aparece aqui." }, { "sintoma": "Aparece \"Nenhum agente interno ativo. Crie ou ative um agente interno em Agentes IA\"", "causa": "", "solucao": "O workspace não tem agente interno ativo. Peça ao dono ou a um admin para criar um em Agentes IA, com Novo agente e Agente interno. Se o agente já existe, ele precisa abrir o agente, clicar em Desativado para que mude para Ativo e salvar." }, { "sintoma": "Aparece \"Não foi possível carregar os agentes\"", "causa": "", "solucao": "Clique em Tentar novamente. Se continuar, confira a sua internet." }, { "sintoma": "Apareceu \"Erro ao enviar\" embaixo da mensagem", "causa": "", "solucao": "A mensagem não foi enviada. O texto depois de \"Erro ao enviar\" diz o motivo, por exemplo falta de internet. Clique em Tentar novamente, logo abaixo da mensagem. Tentar de novo não duplica a mensagem." }, { "sintoma": "Ao escrever para um agente, aparece \"Erro ao enviar: conflito com outra alteração feita ao mesmo tempo\"", "causa": "", "solucao": "Apesar do texto, o problema é o agente: ele foi apagado, desativado ou deixou de ser interno. Atualizar a página não resolve. Peça ao dono ou a um admin para conferir o agente em Agentes IA." }, { "sintoma": "A mensagem mostra \"Envio interrompido. Volte a esta conta e workspace para tentar novamente\"", "causa": "", "solucao": "Você trocou de workspace ou de conta antes de a mensagem sair. Volte ao workspace e à conta da conversa e clique em Tentar novamente. As mensagens que ainda não saíram se perdem se você recarregar ou fechar a página." }, { "sintoma": "Aparece \"Escolha um arquivo de até 20 MB\" ou \"Formato de arquivo não suportado\"", "causa": "", "solucao": "O arquivo passa de 20 MB, está vazio ou tem um formato fora da lista da seção \"Enviar um arquivo\", acima. Escolha outro arquivo. Para um formato fora da lista, compacte o arquivo em ZIP." }, { "sintoma": "No lugar da resposta, aparece em vermelho o nome do agente e um aviso", "causa": "", "solucao": "O agente não conseguiu responder. O aviso diz o motivo:\n- falta a credencial do modelo: o workspace não tem a integração de IA usada pelo agente. Veja «Conectar um provedor de IA e outras integrações»;\n- a conta do provedor de IA está sem créditos: confira o saldo com o provedor;\n- o agente foi desativado: peça ao dono ou a um admin para reativá-lo;\n- a resposta foi interrompida ou não foi concluída: antes de pedir de novo, confira se as ações do agente já foram feitas, porque as Functions podem ter agido." }, { "sintoma": "O botão Nova conversa da conversa com o agente está apagado", "causa": "", "solucao": "Espere as suas mensagens saírem e o agente terminar de responder. Se aparecer \"Aguarde o agente terminar e tente iniciar a nova conversa novamente\", espere alguns segundos e tente de novo." }, { "sintoma": "Não encontro as mensagens mais antigas de uma conversa", "causa": "", "solucao": "Ao abrir uma conversa, o painel carrega as 50 mensagens mais recentes. As anteriores não aparecem no chat da equipe." } ], "para_ia": { "perguntas": [ "Conversar com a equipe pelo chat interno?", "O botão do chat da equipe sumiu da tela Conversas", "Um colega me escreveu, mas a conversa não aparece na minha lista", "Aparece \"Nenhum outro membro\"", "Aparece \"Nenhum departamento\"" ], "resposta": "Converse com colegas, grupos e departamentos e peça ajuda a agentes de IA internos pelo botão do chat da equipe. No canto inferior direito de qualquer tela do painel, clique no botão redondo com o ícone de pessoas. Com o mouse, o botão fica pequeno e meio transparente até você passar o cursor sobre ele. O painel abre com as suas conversas, das mais recentes para as mais antigas. Para achar uma, digite o nome da conversa ou da pessoa em Pesquisar conversa…. A busca não procura no texto das mensagens. Para fechar, clique de novo no botão, que agora fica vermelho e com um X. No painel, clique em Nova conversa.", "escalar": [] }, "relacionados": [ "convidar-equipe", "disponivel-ou-ausente", "criar-agente" ], "markdown": "---\nslug: conversar-com-a-equipe\ncategoria: Equipe\natualizado: 17/10/2026\ntags: chat interno, chat da equipe, grupo, mensagem para colega, agente interno, departamento, menção\nno_painel: Chat da equipe\nverificacao: baseado no guia oficial do painel\n---\n\n# Conversar com a equipe pelo chat interno\n\nConverse com colegas, grupos e departamentos e peça ajuda a agentes de IA internos pelo botão do chat da equipe.\n\n**Para quem é:** Donos, administradores e equipe que usam o painel.\n\n**Antes de começar:**\n- Qualquer pessoa do workspace usa o chat da equipe, sem precisar de permissão.\n- O chat é separado por workspace: as conversas, as pessoas e os agentes que aparecem são os do workspace aberto. Para ver as conversas de outro workspace, troque de workspace no rodapé do menu lateral ou, no aplicativo instalado, pelo botão **Menu**.\n- As conversas são privadas. Só quem participa de uma conversa vê as mensagens e baixa os arquivos dela. O dono e os admins do workspace não veem as conversas de que não participam.\n- Para conversar com um agente de IA, o workspace precisa de um agente interno ativo. Só o dono e os admins criam agentes: em **Agentes IA**, eles clicam em **Novo agente** e escolhem **Agente interno**. Veja «Criar um agente de IA e ligá-lo a um canal» (artigo `criar-agente`).\n\nO chat da equipe é um chat só entre as pessoas do workspace, separado das conversas com clientes. Nele você fala com um colega, cria grupos, reúne um departamento e pede ajuda a um agente de IA interno. As mensagens ficam dentro do painel e não vão para nenhum cliente.\n\n## Abrir e fechar o chat\n\n1. No canto inferior direito de qualquer tela do painel, clique no botão redondo com o ícone de pessoas. Com o mouse, o botão fica pequeno e meio transparente até você passar o cursor sobre ele.\n2. O painel abre com as suas conversas, das mais recentes para as mais antigas. Para achar uma, digite o nome da conversa ou da pessoa em **Pesquisar conversa…**. A busca não procura no texto das mensagens.\n3. Para fechar, clique de novo no botão, que agora fica vermelho e com um X.\n\nEm telas estreitas, como a do celular, o painel ocupa a tela inteira; toque no X para fechar. Numa conversa aberta em **Conversas**, o botão fica um pouco mais alto, acima dos botões da caixa de mensagem.\n\nQuando chega mensagem nova, o botão pulsa e mostra quantas mensagens você não leu (acima de 9, mostra 9+). Com o mouse, aparece só um ponto vermelho, e o número surge quando você passa o cursor. Na lista, a conversa com mensagens novas fica em destaque, com o número ao lado. Ao abrir a conversa, as mensagens contam como lidas. O chat da equipe não toca som nem mostra notificação do navegador.\n\n## Conversar com uma pessoa\n\n1. No painel, clique em **Nova conversa**.\n2. Na aba **Direta**, clique na pessoa. A lista mostra todo mundo do workspace, menos você.\n3. Escreva a mensagem e pressione Enter para enviar. Para mudar de linha sem enviar, use Shift+Enter.\n\n> **Dica:** Para continuar uma conversa, abra-a pela lista. Se você escolher a mesma pessoa de novo em **Nova conversa**, o painel cria uma segunda conversa com ela.\n\nNa lista, uma bolinha verde na foto de uma conversa direta mostra que a pessoa está disponível para atendimento. É o status que cada pessoa liga no próprio perfil: ele não indica se a pessoa está com o painel aberto. Veja «Ficar disponível ou ausente para receber conversas» (artigo `disponivel-ou-ausente`).\n\nEnquanto a mensagem sai, aparece **Na fila** ou **Enviando…** embaixo dela. Você pode fechar o painel, que o envio continua. Depois de enviada, a mensagem não pode ser editada nem apagada.\n\n## Criar um grupo\n\n1. Clique em **Nova conversa** e depois na aba **Grupo**.\n2. Em **Nome do grupo**, escreva o nome, por exemplo *Plantão de sábado*.\n3. Em **Membros**, marque quem vai participar. Você entra no grupo automaticamente.\n4. Clique em **Criar grupo**. O botão mostra quantas pessoas você marcou e só funciona com um nome e pelo menos uma pessoa marcada.\n\nDepois de criado, o grupo não muda de nome nem de participantes pelo painel. Para mudar quem participa, crie outro grupo.\n\n## Conversar com um departamento\n\n1. Clique em **Nova conversa** e depois na aba **Departamento**. A lista mostra os departamentos ativos e quantos membros cada um tem.\n2. Clique no departamento. O painel cria um grupo com o nome dele, com você e as pessoas que estão no departamento nesse momento.\n\nQuem entrar no departamento depois não entra nesse grupo. Clicar no mesmo departamento de novo cria outro grupo.\n\n## Enviar um arquivo\n\n1. Numa conversa direta ou num grupo, clique no clipe, ao lado da caixa de mensagem.\n2. Escolha o arquivo. Se quiser, escreva um texto para ir junto.\n3. Pressione Enter ou clique no botão de enviar, o do avião de papel.\n\n- Vai um arquivo por mensagem, com até 20 MB.\n- Formatos aceitos: imagens JPG, PNG, GIF e WEBP; PDF, TXT, CSV e ZIP; arquivos do Word, Excel e PowerPoint (DOC, DOCX, XLS, XLSX, PPT, PPTX) e do OpenDocument (ODT, ODS, ODP).\n- As imagens aparecem na conversa. Para salvar qualquer arquivo, clique em **Baixar arquivo**.\n- O chat da equipe não envia áudio nem grava mensagens de voz.\n- Na conversa com um agente de IA, o clipe não aparece.\n\n## Conversar com um agente de IA interno\n\n1. Clique em **Nova conversa** e depois na aba **Agentes IA**. A lista mostra os agentes internos ativos. Embaixo do nome aparece a descrição do agente ou **Assistente da equipe**.\n2. Clique no agente. A conversa abre com o aviso **Agente interno · Conversa individual com você**: só você vê essa conversa. Se você já conversou com esse agente, o painel abre a mesma conversa.\n3. Escreva o pedido e envie. Enquanto o agente trabalha, aparece o nome dele seguido de **digitando…**, e a resposta chega na mesma conversa.\n4. Para recomeçar sem o histórico, clique em **Nova conversa**, no topo da conversa com o agente, e depois em **Começar do zero**. A conversa anterior sai da lista, e o agente continua com as mesmas configurações.\n\n## Chamar um agente num grupo\n\n1. Num grupo, clique no botão @, ao lado da caixa de mensagem, ou digite @ no texto.\n2. Escolha o agente na lista. O nome dele entra na mensagem, por exemplo *@Assistente*.\n3. Termine o pedido e envie. A resposta do agente aparece no grupo, para todos que participam dele.\n\nVocê pode chamar até 3 agentes na mesma mensagem. Para desfazer uma menção, clique no nome do agente com o ×, acima da caixa de mensagem. Só dá para chamar agentes em grupos: uma conversa direta entre duas pessoas não aceita menção, e uma mensagem com arquivo não chama agente.\n\n## Esconder o botão na tela Conversas\n\n1. No menu lateral, clique em **Configurações**.\n2. Em **Chat ao vivo**, desligue **Exibir bolha do chat da equipe nas conversas**.\n\nO botão some só da tela **Conversas** e continua nas outras telas. A escolha vale só para este navegador. Numa conversa aberta, você também pode clicar em **Mais ações** (⋮) e, em **Exibição**, escolher **Ocultar bolha da equipe** ou **Mostrar bolha da equipe**. No aplicativo instalado no celular, que não mostra **Configurações**, use esse menu da conversa.\n\n## O que o agente interno pode fazer\n\nO agente responde com as instruções, o conhecimento e o FAQ configurados nele em **Agentes IA**, usando o modelo de IA das integrações do workspace. Ele lê só as mensagens de texto da conversa em que foi chamado: os arquivos enviados não chegam a ele.\n\nSe o agente tem Functions ligadas na seção **Ferramentas**, ele pode usá-las no chat da equipe, e elas agem de verdade. Funcionam as ações que não dependem de um cliente, por exemplo:\n\n- ler e editar planilhas, documentos e arquivos do Google Workspace;\n- consultar e gravar dados no Supabase ou no Baserow;\n- usar conexões como ClickUp, Notion e n8n;\n- pesquisar na web com Perplexity ou Tavily;\n- chamar requisições HTTP que não usam dados de um contato.\n\nNão funcionam aqui as ações ligadas a um cliente ou a uma conversa de atendimento: agendar no Google Calendar ou no Cal.com, consultar o catálogo, cobrar pelo InfinitePay, gerar PDF ou contrato, executar um flow, notificar um atendente e as ações nativas do workspace, como aplicar etiqueta ou transferir. A pesquisa na web pelo 9Router também não funciona no chat da equipe. O agente não envia mensagens para clientes. Veja «Dar ações ao agente com Functions» (artigo `functions-do-agente`).\n\n> **Atenção:** Qualquer pessoa do workspace pode conversar com os agentes internos ativos e pedir as ações das Functions deles, inclusive as que gravam ou alteram dados. Ligue a um agente interno só as Functions que toda a equipe pode usar.\n\n## Não funcionou?\n\n- **O botão do chat da equipe sumiu da tela Conversas**\n Ele foi ocultado neste navegador. Em **Configurações**, na seção **Chat ao vivo**, ligue **Exibir bolha do chat da equipe nas conversas**. Ou, numa conversa aberta, clique em **Mais ações** (⋮) e em **Mostrar bolha da equipe**.\n- **Um colega me escreveu, mas a conversa não aparece na minha lista**\n Uma conversa nova que outra pessoa criou com você pode levar até 5 minutos para aparecer na lista e no número do botão. Para ver na hora, recarregue a página. Já as mensagens novas em conversas que estão na lista chegam na hora.\n- **Aparece \"Nenhum outro membro\"**\n Você é a única pessoa no workspace. Veja «Convidar pessoas para a equipe e definir o que cada uma acessa» (artigo `convidar-equipe`).\n- **Aparece \"Nenhum departamento\"**\n O workspace não tem departamento ativo. Quem gerencia a equipe cria um em **Equipe**, na aba **Equipes**, com **Nova equipe**. Uma equipe com **Equipe ativa** desligada não aparece aqui.\n- **Aparece \"Nenhum agente interno ativo. Crie ou ative um agente interno em Agentes IA\"**\n O workspace não tem agente interno ativo. Peça ao dono ou a um admin para criar um em **Agentes IA**, com **Novo agente** e **Agente interno**. Se o agente já existe, ele precisa abrir o agente, clicar em **Desativado** para que mude para **Ativo** e salvar.\n- **Aparece \"Não foi possível carregar os agentes\"**\n Clique em **Tentar novamente**. Se continuar, confira a sua internet.\n- **Apareceu \"Erro ao enviar\" embaixo da mensagem**\n A mensagem não foi enviada. O texto depois de \"Erro ao enviar\" diz o motivo, por exemplo falta de internet. Clique em **Tentar novamente**, logo abaixo da mensagem. Tentar de novo não duplica a mensagem.\n- **Ao escrever para um agente, aparece \"Erro ao enviar: conflito com outra alteração feita ao mesmo tempo\"**\n Apesar do texto, o problema é o agente: ele foi apagado, desativado ou deixou de ser interno. Atualizar a página não resolve. Peça ao dono ou a um admin para conferir o agente em **Agentes IA**.\n- **A mensagem mostra \"Envio interrompido. Volte a esta conta e workspace para tentar novamente\"**\n Você trocou de workspace ou de conta antes de a mensagem sair. Volte ao workspace e à conta da conversa e clique em **Tentar novamente**. As mensagens que ainda não saíram se perdem se você recarregar ou fechar a página.\n- **Aparece \"Escolha um arquivo de até 20 MB\" ou \"Formato de arquivo não suportado\"**\n O arquivo passa de 20 MB, está vazio ou tem um formato fora da lista da seção \"Enviar um arquivo\", acima. Escolha outro arquivo. Para um formato fora da lista, compacte o arquivo em ZIP.\n- **No lugar da resposta, aparece em vermelho o nome do agente e um aviso**\n O agente não conseguiu responder. O aviso diz o motivo:\n - falta a credencial do modelo: o workspace não tem a integração de IA usada pelo agente. Veja «Conectar um provedor de IA e outras integrações» (artigo `integracoes-e-provedores-de-ia`);\n - a conta do provedor de IA está sem créditos: confira o saldo com o provedor;\n - o agente foi desativado: peça ao dono ou a um admin para reativá-lo;\n - a resposta foi interrompida ou não foi concluída: antes de pedir de novo, confira se as ações do agente já foram feitas, porque as Functions podem ter agido.\n- **O botão Nova conversa da conversa com o agente está apagado**\n Espere as suas mensagens saírem e o agente terminar de responder. Se aparecer \"Aguarde o agente terminar e tente iniciar a nova conversa novamente\", espere alguns segundos e tente de novo.\n- **Não encontro as mensagens mais antigas de uma conversa**\n Ao abrir uma conversa, o painel carrega as 50 mensagens mais recentes. As anteriores não aparecem no chat da equipe.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Conversar com a equipe pelo chat interno?\n- O botão do chat da equipe sumiu da tela Conversas\n- Um colega me escreveu, mas a conversa não aparece na minha lista\n- Aparece \"Nenhum outro membro\"\n- Aparece \"Nenhum departamento\"\n\nResposta curta: Converse com colegas, grupos e departamentos e peça ajuda a agentes de IA internos pelo botão do chat da equipe. No canto inferior direito de qualquer tela do painel, clique no botão redondo com o ícone de pessoas. Com o mouse, o botão fica pequeno e meio transparente até você passar o cursor sobre ele. O painel abre com as suas conversas, das mais recentes para as mais antigas. Para achar uma, digite o nome da conversa ou da pessoa em Pesquisar conversa…. A busca não procura no texto das mensagens. Para fechar, clique de novo no botão, que agora fica vermelho e com um X. No painel, clique em Nova conversa.\n\nVeja também: «Convidar pessoas para a equipe e definir o que cada uma acessa» (`convidar-equipe`); «Ficar disponível ou ausente para receber conversas» (`disponivel-ou-ausente`); «Criar um agente de IA e ligá-lo a um canal» (`criar-agente`)\n" }, { "slug": "liberar-addon-no-workspace", "categoria": "Conta e assinatura", "titulo": "Liberar um addon no workspace", "resumo": "Distribua entre os workspaces os addons que a agência contratou, tire um addon de volta e entenda os avisos de recurso bloqueado.", "tags": [ "addon", "add-on", "recurso bloqueado", "fora do plano", "limite", "liberar", "agência", "workspace" ], "publico": "Donos de agência e administradores de conta.", "no_painel": [ "Agência", "Configurar", "Limites e addons" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Aparece \"Nenhum addon contratado para este recurso\"", "causa": "", "solucao": "A agência ainda não contratou nenhum addon desse recurso. No próprio cartão, clique em Ver addons disponíveis na Assinatura e contrate em Addons disponíveis. Depois, volte ao cartão e libere o addon, se ele ainda não aparecer em Addons aqui." }, { "sintoma": "Aparece \"Todos os extras estão em outros workspaces\"", "causa": "", "solucao": "Todos os addons desse recurso já estão liberados em outros workspaces. Tire um de outro workspace (veja *Tirar um addon de um workspace*) e libere aqui, ou contrate mais: no menu lateral, em Agência, clique em Assinatura e vá até Addons disponíveis." }, { "sintoma": "O botão Liberar +1 addon neste workspace não aparece", "causa": "", "solucao": "Ele só aparece quando há extra livre. Veja a mensagem no topo do cartão:\n- Ilimitado pelo plano: o recurso não tem limite, então não precisa de addon.\n- Indisponível no plano da agência: o recurso não faz parte do plano da agência e não pode receber addon.\n- Nenhum addon contratado para este recurso ou Todos os extras estão em outros workspaces: veja os itens acima.\nSe no lugar dele aparece Aumentar +1 até o limite do plano, o limite deste workspace está abaixo do que o plano inclui: clique em Usar o plano e salve. Recursos em Limites gerais não recebem addon: ali você só pode reduzir o limite deste workspace." }, { "sintoma": "Aparece \"Máximo disponível para este workspace\"", "causa": "", "solucao": "O número digitado passa do que o plano inclui mais os extras livres. Diminua o número. Enquanto isso, Salvar alterações fica desativado." }, { "sintoma": "Aparece \"Uso acima do limite configurado\"", "causa": "", "solucao": "O workspace já usa mais desse recurso do que o novo limite total. Nada do que já existe é apagado. Para resolver, libere mais um addon ou diminua o uso desse recurso no workspace." }, { "sintoma": "A sua equipe vê \"não incluído no seu plano\", \"fora do plano\" ou \"limite atingido\"", "causa": "", "solucao": "- Um aviso com cadeado, como WhatsApp QR não incluído no seu plano, e, em Conexões, o cartão do canal com fora do plano: o workspace não tem vaga desse recurso.\n- \"limite atingido\": o workspace já usa todo o limite total.\nNo aviso com cadeado, quem não é o dono da conta vê Fale com o responsável pela sua agência para liberar este recurso. e precisa pedir a você. Libere um addon como no passo a passo e peça para a pessoa recarregar a página. Nesses avisos, você, como dono, vê Contratar addon, que leva à Assinatura. Antes de contratar, confira em Limites e addons se já não há um extra livre." } ], "para_ia": { "perguntas": [ "Liberar um addon no workspace?", "Aparece \"Nenhum addon contratado para este recurso\"", "Aparece \"Todos os extras estão em outros workspaces\"", "O botão Liberar +1 addon neste workspace não aparece", "Aparece \"Máximo disponível para este workspace\"" ], "resposta": "Distribua entre os workspaces os addons que a agência contratou, tire um addon de volta e entenda os avisos de recurso bloqueado. No menu lateral, clique em Agência. Na linha do workspace, clique em Configurar. A página Configurar workspace abre. Confira se a aba Limites e addons está aberta. Ela já abre selecionada. Em Canais e addons, encontre o cartão do recurso, por exemplo WhatsApp QR Code ou Agentes IA. Os recursos com extras livres aparecem primeiro.", "escalar": [ "Contratar addon ou mudar plano" ] }, "relacionados": [ "assinatura-e-cobranca", "criar-workspaces-e-configurar-a-marca" ], "markdown": "---\nslug: liberar-addon-no-workspace\ncategoria: Conta e assinatura\natualizado: 17/10/2026\ntags: addon, add-on, recurso bloqueado, fora do plano, limite, liberar, agência, workspace\nno_painel: Agência > Configurar > Limites e addons\nverificacao: baseado no guia oficial do painel\n---\n\n# Liberar um addon no workspace\n\nDistribua entre os workspaces os addons que a agência contratou, tire um addon de volta e entenda os avisos de recurso bloqueado.\n\n**Para quem é:** Donos de agência e administradores de conta.\n\n**Antes de começar:**\n- Só o dono da conta faz isso: o menu **Agência** aparece apenas para ele.\n- Para liberar, a agência precisa ter um addon do recurso contratado e ainda livre. O cartão do recurso mostra se há (veja *Se algo der errado*).\n\nUm addon (adicional) é uma unidade extra de um recurso, como mais uma conexão de WhatsApp ou mais uma vaga de agente de IA, que a agência contrata e distribui entre os seus workspaces. Aqui você libera um addon para um workspace, tira o addon de volta quando quiser e entende os avisos que a sua equipe vê.\n\n> **Bom saber:** Os addons formam um único saldo da agência. Cada workspace recebe o que o plano inclui, e você escolhe onde usar os extras. Por exemplo: 1 incluído no plano + 2 addons = limite total 3 naquele workspace.\n\n1. No menu lateral, clique em **Agência**.\n2. Na linha do workspace, clique em **Configurar**. A página **Configurar workspace** abre.\n3. Confira se a aba **Limites e addons** está aberta. Ela já abre selecionada.\n4. Em **Canais e addons**, encontre o cartão do recurso, por exemplo **WhatsApp QR Code** ou **Agentes IA**. Os recursos com extras livres aparecem primeiro.\n5. Clique em **Liberar +1 addon neste workspace**. Cada clique libera mais um: o número em **Addons aqui** sobe e o **Limite total** acompanha.\n6. Clique em **Salvar alterações** e aguarde **Alterações salvas**. O workspace já pode usar o recurso até o novo limite total.\n\n> **Dica:** Você também pode digitar o número direto em **Limite total neste workspace**: ele é sempre o total do workspace, ou seja, o que o plano inclui mais os addons liberados ali. Errou antes de salvar? Clique em **Descartar**.\n\n## Tirar um addon de um workspace\n\n1. No menu lateral, clique em **Agência** e, na linha do workspace, em **Configurar**.\n2. Na aba **Limites e addons**, no cartão do recurso, clique no botão **−**, logo abaixo de **Limite total neste workspace**. Cada clique tira um addon. Para tirar todos de uma vez, clique em **Usar o plano**.\n3. Clique em **Salvar alterações**. O addon volta para o saldo da agência e pode ser liberado em outro workspace.\n\n> **Atenção:** Pare quando **Addons aqui** chegar a 0. Se continuar clicando em **−**, você reduz o que o plano inclui para este workspace.\n\n## Não funcionou?\n\n- **Aparece \"Nenhum addon contratado para este recurso\"**\n A agência ainda não contratou nenhum addon desse recurso. No próprio cartão, clique em **Ver addons disponíveis na Assinatura** e contrate em **Addons disponíveis**. Depois, volte ao cartão e libere o addon, se ele ainda não aparecer em **Addons aqui**.\n- **Aparece \"Todos os extras estão em outros workspaces\"**\n Todos os addons desse recurso já estão liberados em outros workspaces. Tire um de outro workspace (veja *Tirar um addon de um workspace*) e libere aqui, ou contrate mais: no menu lateral, em **Agência**, clique em **Assinatura** e vá até **Addons disponíveis**.\n- **O botão Liberar +1 addon neste workspace não aparece**\n Ele só aparece quando há extra livre. Veja a mensagem no topo do cartão:\n - **Ilimitado pelo plano**: o recurso não tem limite, então não precisa de addon.\n - **Indisponível no plano da agência**: o recurso não faz parte do plano da agência e não pode receber addon.\n - **Nenhum addon contratado para este recurso** ou **Todos os extras estão em outros workspaces**: veja os itens acima.\n Se no lugar dele aparece **Aumentar +1 até o limite do plano**, o limite deste workspace está abaixo do que o plano inclui: clique em **Usar o plano** e salve. Recursos em **Limites gerais** não recebem addon: ali você só pode reduzir o limite deste workspace.\n- **Aparece \"Máximo disponível para este workspace\"**\n O número digitado passa do que o plano inclui mais os extras livres. Diminua o número. Enquanto isso, **Salvar alterações** fica desativado.\n- **Aparece \"Uso acima do limite configurado\"**\n O workspace já usa mais desse recurso do que o novo limite total. Nada do que já existe é apagado. Para resolver, libere mais um addon ou diminua o uso desse recurso no workspace.\n- **A sua equipe vê \"não incluído no seu plano\", \"fora do plano\" ou \"limite atingido\"**\n - Um aviso com cadeado, como **WhatsApp QR não incluído no seu plano**, e, em **Conexões**, o cartão do canal com **fora do plano**: o workspace não tem vaga desse recurso.\n - \"limite atingido\": o workspace já usa todo o limite total.\n No aviso com cadeado, quem não é o dono da conta vê **Fale com o responsável pela sua agência para liberar este recurso.** e precisa pedir a você. Libere um addon como no passo a passo e peça para a pessoa recarregar a página. Nesses avisos, você, como dono, vê **Contratar addon**, que leva à **Assinatura**. Antes de contratar, confira em **Limites e addons** se já não há um extra livre.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Liberar um addon no workspace?\n- Aparece \"Nenhum addon contratado para este recurso\"\n- Aparece \"Todos os extras estão em outros workspaces\"\n- O botão Liberar +1 addon neste workspace não aparece\n- Aparece \"Máximo disponível para este workspace\"\n\nResposta curta: Distribua entre os workspaces os addons que a agência contratou, tire um addon de volta e entenda os avisos de recurso bloqueado. No menu lateral, clique em Agência. Na linha do workspace, clique em Configurar. A página Configurar workspace abre. Confira se a aba Limites e addons está aberta. Ela já abre selecionada. Em Canais e addons, encontre o cartão do recurso, por exemplo WhatsApp QR Code ou Agentes IA. Os recursos com extras livres aparecem primeiro.\n\nEscalar para um humano quando:\n- Contratar addon ou mudar plano\n\nVeja também: «Acompanhar a assinatura» (`assinatura-e-cobranca`); «Criar workspaces e configurar a marca da agência» (`criar-workspaces-e-configurar-a-marca`)\n" }, { "slug": "criar-workspaces-e-configurar-a-marca", "categoria": "Conta e assinatura", "titulo": "Criar workspaces e configurar a marca da agência", "resumo": "Crie ou clone um workspace para cada cliente, entre nele e configure a marca que os seus clientes veem: nome, logos, cor e domínio próprio.", "tags": [ "workspace", "criar workspace", "clonar", "agência", "white label", "marca", "logo", "domínio próprio", "revenda", "subconta" ], "publico": "Donos de agência e administradores de conta.", "no_painel": [ "Agência" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O botão Criar workspace está desativado", "causa": "", "solucao": "A agência já usa todos os workspaces do plano (por exemplo, *5 / 5 workspaces*). Workspaces suspensos continuam ocupando vaga. Só a exclusão (Ações → Excluir, na linha) libera a vaga, e ela apaga todos os dados do workspace de vez. Para ter mais vagas, veja o upgrade e os addons em «Acompanhar a assinatura»." }, { "sintoma": "Aparece \"White-label não incluído no seu plano\"", "causa": "", "solucao": "O plano da agência não inclui marca própria. Clique em Contratar addon: a tela Assinatura abre, e os extras ficam em Addons disponíveis. Se não houver addon de white-label, fale com o suporte: no menu lateral, em Agência, clique em Suporte." }, { "sintoma": "Não consigo adicionar o domínio", "causa": "", "solucao": "Veja a mensagem que aparece:\n- \"hostname inválido (use um domínio ou subdomínio válido)\": digite só o endereço, sem https:// e sem barra no fim, por exemplo *chat.suaempresa.com.br*.\n- \"este domínio já está em uso\": o domínio já está na agência, em outro workspace ou em outra conta. Se ele estiver com você, clique em Remover onde ele está e em Confirmar remoção?. Se não, use outro subdomínio.\n- Integração de domínio próprio ainda não configurada no servidor.: o domínio próprio ainda não está disponível. Fale com o suporte em Agência → Suporte." }, { "sintoma": "O domínio continua em \"Aguardando DNS\" ou mostra \"Erro\"", "causa": "", "solucao": "Confira no provedor de DNS se cada registro tem o mesmo tipo, Nome e Valor da tela, sem espaços a mais. Depois, clique em Verificar agora. A mudança no DNS pode levar um tempo para ser reconhecida. Se o Erro continuar, fale com o suporte em Agência → Suporte." }, { "sintoma": "Salvei a marca, mas o painel continua com a aparência de antes", "causa": "", "solucao": "- Abra o painel pelo seu domínio próprio, já com o status Ativo, e recarregue a página. Por outro endereço, a marca não aparece.\n- A marca própria de um workspace só aparece pelo domínio dele. Pelo domínio da agência, vale a marca da agência." }, { "sintoma": "Aparece um erro ao enviar uma logo ou ao salvar a cor", "causa": "", "solucao": "- Arquivo muito grande. Envie uma imagem de até 2 MB.: diminua a imagem e clique em Upload de novo.\n- Formato não suportado. Use PNG, JPG, WebP, GIF ou ICO.: salve a imagem num desses formatos.\n- Cor primária inválida. Use o formato #rrggbb.: escreva # e seis letras ou números, como *#1d4ed8*, ou escolha a cor no quadrado." }, { "sintoma": "O botão Entrar está desativado ou o workspace sumiu do cartão Workspace", "causa": "", "solucao": "O workspace está suspenso: na coluna Status aparece Suspenso, e a equipe dele fica sem acesso. Na linha, clique em Ações → Reativar. Se aparece Excluindo…, o workspace está sendo excluído." }, { "sintoma": "A opção Clonar estrutura não aparece ou está desativada", "causa": "", "solucao": "Ela fica desativada quando o workspace está suspenso: reative-o antes. Para um admin, ela só aparece com a permissão Clonar estrutura do workspace, dada pelo dono da conta." }, { "sintoma": "Ao clonar, aparece \"A cota da agência ou os recursos do novo workspace não comportam esta cópia. Nenhum workspace foi criado.\"", "causa": "", "solucao": "A agência já usa todos os workspaces do plano, ou a origem tem mais agentes, automações, pipelines ou etapas do que o plano permite num workspace. Libere uma vaga ou veja o upgrade em «Acompanhar a assinatura»." }, { "sintoma": "Ao clonar, aparece um aviso sobre fluxo incompleto, mídias da galeria, dependências ou o limite da cópia", "causa": "", "solucao": "Nada foi criado. Se o aviso fala de um fluxo incompleto, corrija o fluxo no workspace de origem e clone de novo. A cópia ainda não leva arquivos da galeria usados na estrutura nem dependências que não sabe copiar, e aceita até 500 registros de cada tipo e 2 MB de estrutura. Nesses casos, crie o workspace com Criar workspace e monte a estrutura nele." } ], "para_ia": { "perguntas": [ "Criar workspaces e configurar a marca da agência?", "O botão Criar workspace está desativado", "Aparece \"White-label não incluído no seu plano\"", "Não consigo adicionar o domínio", "O domínio continua em \"Aguardando DNS\" ou mostra \"Erro\"" ], "resposta": "Crie ou clone um workspace para cada cliente, entre nele e configure a marca que os seus clientes veem: nome, logos, cor e domínio próprio. No menu lateral, clique em Agência. Clique em Criar workspace. Em Nome, escreva o nome do cliente, por exemplo Clínica Sorriso, e clique em Criar. O workspace entra na lista com o status Ativo. Na linha do workspace, clique em Entrar. O painel abre o Dashboard desse cliente. Convide a equipe do cliente pelo menu Equipe: veja . Você continua como dono de cada workspace que cria; o cliente entra como administrador ou agente.", "escalar": [ "Domínio próprio que não funciona depois da configuração" ] }, "relacionados": [ "liberar-addon-no-workspace", "assinatura-e-cobranca", "convidar-equipe" ], "markdown": "---\nslug: criar-workspaces-e-configurar-a-marca\ncategoria: Conta e assinatura\natualizado: 17/10/2026\ntags: workspace, criar workspace, clonar, agência, white label, marca, logo, domínio próprio, revenda, subconta\nno_painel: Agência\nverificacao: baseado no guia oficial do painel\n---\n\n# Criar workspaces e configurar a marca da agência\n\nCrie ou clone um workspace para cada cliente, entre nele e configure a marca que os seus clientes veem: nome, logos, cor e domínio próprio.\n\n**Para quem é:** Donos de agência e administradores de conta.\n\n**Antes de começar:**\n- Só o dono da conta cria workspaces e configura a marca. Os admins de workspace também veem o menu **Agência**, mas só com a lista dos workspaces que administram (veja *Clonar a estrutura de um workspace*).\n- O plano da agência define quantos workspaces você pode criar. O uso aparece no topo da página **Agência**, por exemplo *3 / 5 workspaces*.\n- Marca e domínio próprio dependem do white-label no plano da agência. Sem ele, as abas mostram um aviso com cadeado (veja *Se algo der errado*).\n- Para o domínio próprio, você precisa de acesso ao provedor de DNS do domínio.\n\nNa página **Agência** você cuida dos seus clientes. Cada cliente ganha um workspace próprio, com conversas, contatos, conexões e equipe separados dos outros. Aqui você cria e clona esses workspaces, entra neles e define a marca que os clientes veem: nome, logos, cor e domínio próprio.\n\n> **Atenção:** A sua marca aparece na tela de login, no topo do menu lateral, na aba do navegador e na cor dos botões, mas só para quem abre o painel pelo domínio próprio. Configure o domínio e passe esse endereço aos seus clientes.\n\n## Criar o workspace de um cliente\n\n1. No menu lateral, clique em **Agência**.\n2. Clique em **Criar workspace**. Em **Nome**, escreva o nome do cliente, por exemplo *Clínica Sorriso*, e clique em **Criar**. O workspace entra na lista com o status **Ativo**.\n3. Na linha do workspace, clique em **Entrar**. O painel abre o Dashboard desse cliente.\n4. Convide a equipe do cliente pelo menu **Equipe**: veja «Convidar pessoas para a equipe e definir o que cada uma acessa» (artigo `convidar-equipe`). Você continua como dono de cada workspace que cria; o cliente entra como administrador ou agente.\n\n> **Dica:** Para trocar de workspace, clique no cartão **Workspace**, no rodapé do menu lateral. Para mudar o nome de um workspace, clique em **Ações** e em **Editar** na linha dele.\n\n## Clonar a estrutura de um workspace\n\nPara começar um cliente a partir de um workspace já montado, clone a estrutura dele. A cópia leva os agentes de IA, com prompts e configurações, as Functions e Skills, as automações, as etiquetas, os campos personalizados, os pipelines com as etapas e as equipes, sem os membros. Não leva contatos, conversas, histórico, base de conhecimento, FAQ, conexões nem credenciais.\n\n1. Na página **Agência**, na linha do workspace que vai servir de origem, clique em **Ações** e em **Clonar estrutura**.\n2. Em **Nome do novo workspace**, troque o nome sugerido pelo nome do cliente.\n3. Clique em **Clonar estrutura** e aguarde. A janela mostra o que foi copiado e, em **Configurações a revisar**, o que precisa de ajuste. Se algo falhar, nenhum workspace é criado.\n4. Clique em **Abrir integrações**, **Abrir Functions** ou **Abrir automações** para entrar no novo workspace. Conecte os canais e as integrações, escolha os canais nos agentes e nos gatilhos das automações e os responsáveis que faltarem.\n5. Ative os agentes, as Functions e as automações quando terminar: na cópia, todos começam desativados.\n\nA cópia ocupa uma vaga de workspace do plano, fica na mesma agência, com o mesmo dono, e precisa caber nos limites de agentes, automações e pipelines do novo workspace. Para rever depois o que ficou pendente, clique em **Ações** → **Revisar configuração da cópia** na linha do novo workspace. A lista mostra o que faltava no momento da cópia e não confere o que você já configurou.\n\nUm admin também pode clonar o workspace que administra, se você ligar **Clonar estrutura do workspace** em **Permissões para administrar administradores**, ao editar esse admin em **Equipe**, nesse workspace. Ele vê no menu **Agência** só a lista dos workspaces que administra, com **Entrar** e **Ações**, e recebe acesso de admin ao novo workspace.\n\n## Criar um workspace vazio pela API ou pelo copiloto\n\nNo copiloto, peça para criar o workspace e informe o nome. Pela API, envie `POST /v1/agency/workspaces` com `{\"name\":\"Meu workspace\"}`, usando uma chave do dono com a permissão de criação. Ao criar a chave, marque **Permitir criar workspaces na minha agência**. A criação usa a cota de workspaces da agência e não exige addon de revenda, plano comercial, cliente, modelo ou vencimento. O dono permanece owner.\n\nPara repetir com segurança uma requisição da API, seu sistema pode enviar `idempotency_key` e reutilizar o mesmo nome e chave. Esse campo é opcional; sem ele, cada requisição é uma nova criação. O copiloto cuida dessa referência internamente.\n\n## Criar por plano de revenda pela API (opcional)\n\nSe você vende planos pela aba **Planos**, um sistema seu, como a automação que confirma a venda, pode criar o workspace do cliente sozinho, como cópia de um workspace modelo.\n\n1. Na página **Agência**, clique em **Configurar agência**, abra a aba **Planos** e clique em **Editar** no plano, ou em **Novo plano**.\n2. Em **Workspace modelo para criação por API**, escolha o modelo. A lista mostra os workspaces ativos de que você é dono.\n3. Em **Limites para os novos workspaces**, defina o limite de cada recurso. Em branco, vale o limite da agência; zero deixa o recurso sem capacidade.\n4. Clique em **Salvar**. A linha do plano mostra o ID do plano, que o seu sistema informa ao criar o workspace.\n5. No workspace que o seu sistema vai usar, crie a chave de API marcando **Permitir criar workspaces na minha agência**. Veja «Integrar outros sistemas pela API e pelo MCP» (artigo `usar-a-api-e-o-mcp`).\n\nCada workspace criado assim segue as regras de *Clonar a estrutura de um workspace*, recebe o plano de revenda com o vencimento informado no pedido e um convite de administrador para o cliente, que vale 7 dias. O painel não envia esse convite por e-mail: o seu sistema recebe o link e o entrega ao cliente. A criação não cobra o cliente. Mudar o plano ou o modelo depois não altera os workspaces já criados. Uma chave que já existe não ganha essa permissão: revogue-a e crie outra, atualizando as integrações que usavam a antiga.\n\n## Configurar a marca da agência\n\n1. Na página **Agência**, clique em **Configurar agência**. A janela **Configurações da agência** abre na aba **Geral**.\n2. Confira o **Nome da agência**. Ele vira o nome da marca quando **Nome do app** fica vazio. Se mudar, clique em **Salvar** e aguarde **Nome atualizado**.\n3. Abra a aba **Personalização**. Em **Nome do app**, escreva o nome que os clientes vão ver. Em **Cor primária**, escolha a cor no quadrado ou digite o código, por exemplo *#1d4ed8*.\n4. Em **Logos por tema**, clique em **Upload** em **Logo — tema claro** (logo escura, para fundo claro) e em **Logo — tema escuro** (logo clara, para fundo escuro).\n5. Em **Arquivos gerais**, envie a **Logo padrão (fallback)**, usada quando falta alguma logo, o **Ícone compacto**, que vai no topo do menu lateral, e o **Favicon**, o ícone da aba do navegador.\n6. Se quiser, preencha **Política de Privacidade (URL)** e **Termos de Uso (URL)**. Os links aparecem na tela de login.\n7. Clique em **Salvar** e aguarde **Salvo**. O **Upload** só coloca a imagem no campo: sem **Salvar**, nada muda. Os workspaces dos clientes herdam essa marca.\n\n## Usar o seu domínio próprio\n\n1. Em **Configurações da agência**, abra a aba **Domínio**.\n2. Digite o endereço que os clientes vão usar, por exemplo *chat.suaempresa.com.br*, e clique em **Adicionar domínio**.\n3. Em **Configuração DNS**, a tela mostra os registros que você precisa criar. No provedor de DNS do domínio, crie cada um com o mesmo tipo, **Nome** e **Valor**. O botão ao lado de cada campo copia o texto.\n4. Volte à aba **Domínio** e clique em **Verificar agora**. Quando o status muda de **Aguardando DNS** para **Ativo**, o domínio está pronto.\n5. Passe o endereço aos seus clientes.\n\n## Dar a um cliente uma marca própria (opcional)\n\n1. Em **Agência**, na linha do workspace, clique em **Ações** e em **Configurar**, e abra a aba **White label**.\n2. Preencha só o que muda para esse cliente. O campo vazio mostra **Herda da agência** e usa a marca da agência.\n3. Clique em **Salvar** e aguarde **Salvo**.\n4. Em **Domínio próprio**, na mesma aba, adicione o domínio do cliente e crie os registros DNS, como no domínio da agência. A marca do cliente aparece para quem entra por esse domínio.\n\nA outra aba, **Limites e addons**, define quanto o workspace pode usar de cada recurso: veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n\n## Não funcionou?\n\n- **O botão Criar workspace está desativado**\n A agência já usa todos os workspaces do plano (por exemplo, *5 / 5 workspaces*). Workspaces suspensos continuam ocupando vaga. Só a exclusão (**Ações** → **Excluir**, na linha) libera a vaga, e ela apaga todos os dados do workspace de vez. Para ter mais vagas, veja o upgrade e os addons em «Acompanhar a assinatura» (artigo `assinatura-e-cobranca`).\n- **Aparece \"White-label não incluído no seu plano\"**\n O plano da agência não inclui marca própria. Clique em **Contratar addon**: a tela **Assinatura** abre, e os extras ficam em **Addons disponíveis**. Se não houver addon de white-label, fale com o suporte: no menu lateral, em **Agência**, clique em **Suporte**.\n- **Não consigo adicionar o domínio**\n Veja a mensagem que aparece:\n - \"hostname inválido (use um domínio ou subdomínio válido)\": digite só o endereço, sem https:// e sem barra no fim, por exemplo *chat.suaempresa.com.br*.\n - \"este domínio já está em uso\": o domínio já está na agência, em outro workspace ou em outra conta. Se ele estiver com você, clique em **Remover** onde ele está e em **Confirmar remoção?**. Se não, use outro subdomínio.\n - **Integração de domínio próprio ainda não configurada no servidor.**: o domínio próprio ainda não está disponível. Fale com o suporte em **Agência** → **Suporte**.\n- **O domínio continua em \"Aguardando DNS\" ou mostra \"Erro\"**\n Confira no provedor de DNS se cada registro tem o mesmo tipo, **Nome** e **Valor** da tela, sem espaços a mais. Depois, clique em **Verificar agora**. A mudança no DNS pode levar um tempo para ser reconhecida. Se o **Erro** continuar, fale com o suporte em **Agência** → **Suporte**.\n- **Salvei a marca, mas o painel continua com a aparência de antes**\n - Abra o painel pelo seu domínio próprio, já com o status **Ativo**, e recarregue a página. Por outro endereço, a marca não aparece.\n - A marca própria de um workspace só aparece pelo domínio dele. Pelo domínio da agência, vale a marca da agência.\n- **Aparece um erro ao enviar uma logo ou ao salvar a cor**\n - **Arquivo muito grande. Envie uma imagem de até 2 MB.**: diminua a imagem e clique em **Upload** de novo.\n - **Formato não suportado. Use PNG, JPG, WebP, GIF ou ICO.**: salve a imagem num desses formatos.\n - **Cor primária inválida. Use o formato #rrggbb.**: escreva # e seis letras ou números, como *#1d4ed8*, ou escolha a cor no quadrado.\n- **O botão Entrar está desativado ou o workspace sumiu do cartão Workspace**\n O workspace está suspenso: na coluna **Status** aparece **Suspenso**, e a equipe dele fica sem acesso. Na linha, clique em **Ações** → **Reativar**. Se aparece **Excluindo…**, o workspace está sendo excluído.\n- **A opção Clonar estrutura não aparece ou está desativada**\n Ela fica desativada quando o workspace está suspenso: reative-o antes. Para um admin, ela só aparece com a permissão **Clonar estrutura do workspace**, dada pelo dono da conta.\n- **Ao clonar, aparece \"A cota da agência ou os recursos do novo workspace não comportam esta cópia. Nenhum workspace foi criado.\"**\n A agência já usa todos os workspaces do plano, ou a origem tem mais agentes, automações, pipelines ou etapas do que o plano permite num workspace. Libere uma vaga ou veja o upgrade em «Acompanhar a assinatura» (artigo `assinatura-e-cobranca`).\n- **Ao clonar, aparece um aviso sobre fluxo incompleto, mídias da galeria, dependências ou o limite da cópia**\n Nada foi criado. Se o aviso fala de um fluxo incompleto, corrija o fluxo no workspace de origem e clone de novo. A cópia ainda não leva arquivos da galeria usados na estrutura nem dependências que não sabe copiar, e aceita até 500 registros de cada tipo e 2 MB de estrutura. Nesses casos, crie o workspace com **Criar workspace** e monte a estrutura nele.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Criar workspaces e configurar a marca da agência?\n- O botão Criar workspace está desativado\n- Aparece \"White-label não incluído no seu plano\"\n- Não consigo adicionar o domínio\n- O domínio continua em \"Aguardando DNS\" ou mostra \"Erro\"\n\nResposta curta: Crie ou clone um workspace para cada cliente, entre nele e configure a marca que os seus clientes veem: nome, logos, cor e domínio próprio. No menu lateral, clique em Agência. Clique em Criar workspace. Em Nome, escreva o nome do cliente, por exemplo Clínica Sorriso, e clique em Criar. O workspace entra na lista com o status Ativo. Na linha do workspace, clique em Entrar. O painel abre o Dashboard desse cliente. Convide a equipe do cliente pelo menu Equipe: veja . Você continua como dono de cada workspace que cria; o cliente entra como administrador ou agente.\n\nEscalar para um humano quando:\n- Domínio próprio que não funciona depois da configuração\n\nVeja também: «Liberar um addon no workspace» (`liberar-addon-no-workspace`); «Acompanhar a assinatura» (`assinatura-e-cobranca`); «Convidar pessoas para a equipe e definir o que cada uma acessa» (`convidar-equipe`)\n" }, { "slug": "assinatura-e-cobranca", "categoria": "Conta e assinatura", "titulo": "Acompanhar a assinatura", "resumo": "Veja plano, status e vencimento, pague ou renove, faça upgrade, cobre clientes, acompanhe as automações de cada workspace e saiba o que acontece quando o plano vence.", "tags": [ "assinatura", "plano", "pagamento", "vencimento", "renovar", "upgrade", "fatura", "plano vencido", "cobrar clientes" ], "publico": "Donos de agência e administradores de conta.", "no_painel": [ "Agência", "Assinatura" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "Aparece \"Seu plano está vencido e o acesso ao sistema foi suspenso. Regularize o pagamento para reativar.\"", "causa": "", "solucao": "O plano da agência passou um dia do vencimento sem pagamento, ou a cobrança automática ficou com pagamento pendente. Até regularizar, você só abre Assinatura, Agência → Suporte e a Central de ajuda; as outras telas voltam para Assinatura. A sua equipe e as equipes dos clientes veem Plano expirado e ficam sem acesso. Clique em Pagar agora ou em Pagar / Renovar." }, { "sintoma": "A equipe do cliente vê \"Assinatura vencida\"", "causa": "", "solucao": "O plano do workspace com a agência passou um dia do vencimento, e a equipe fica sem acesso até a agência definir um novo vencimento. Se você é da equipe, fale com o responsável pela sua agência. Se você é o dono da conta, nesse workspace as telas voltam para Assinatura: troque de workspace no cartão Workspace, abra Agência e defina o novo Vencimento em Ações → Plano de revenda." }, { "sintoma": "Paguei, mas o status não mudou", "causa": "", "solucao": "- Plano da agência: aguarde um pouco e recarregue a página. Se nada mudar, fale com o suporte em Agência → Suporte.\n- Workspace de cliente: o vencimento muda quando a agência registra o pagamento. Fale com o responsável pela sua agência." }, { "sintoma": "O botão Pagar / Renovar não aparece", "causa": "", "solucao": "- Com Renovação automática, ele não aparece, porque a renovação é automática.\n- Sem ela, o plano ainda não tem pagamento pelo painel: fale com o suporte em Agência → Suporte.\n- No workspace de cliente, Pagar/Renovar só aparece quando a agência cadastra um link de pagamento no plano. Fale com o responsável pela sua agência." }, { "sintoma": "Quero trocar o cartão, ver faturas, cancelar ou mudar para um plano menor", "causa": "", "solucao": "Essas opções não ficam no painel, que só faz upgrade para um plano superior. Dono da conta: fale com o suporte em Agência → Suporte. No workspace de cliente, fale com o responsável pela sua agência." }, { "sintoma": "Um addon mostra \"Fale com o suporte\" no lugar de Contratar", "causa": "", "solucao": "Esse addon não pode ser contratado pelo painel agora. Fale com o suporte em Agência → Suporte." }, { "sintoma": "Aparece \"Canais sem cobertura de assinatura\"", "causa": "", "solucao": "Esse aviso aparece somente para o dono da agência em Assinatura. Ele identifica o workspace, o canal e os addons relacionados ao recurso sem cobertura. Confira se o plano está vigente e revise a alocação do workspace; se precisar de mais unidades, use Ver addons disponíveis. O envio, o recebimento e novos contatos e conversas ficam bloqueados nos canais indicados. As conexões e o histórico continuam preservados. A equipe vê apenas que o canal está indisponível no chat, sem detalhes de cobrança." }, { "sintoma": "Em Plano de revenda, aparece \"Nenhum plano ativo cadastrado\"", "causa": "", "solucao": "Crie um plano na aba Planos das Configurações da agência, com Ativo (visível aos clientes) marcado. Planos inativos não aparecem para escolher nem na tela do cliente." } ], "para_ia": { "perguntas": [ "Acompanhar a assinatura?", "Aparece \"Seu plano está vencido e o acesso ao sistema foi suspenso. Regularize o pagamento para reativar.\"", "A equipe do cliente vê \"Assinatura vencida\"", "Paguei, mas o status não mudou", "O botão Pagar / Renovar não aparece" ], "resposta": "Veja plano, status e vencimento, pague ou renove, faça upgrade, cobre clientes, acompanhe as automações de cada workspace e saiba o que acontece quando o plano vence. No menu lateral, clique em Agência e depois em Assinatura. Em Plano atual, veja o nome do seu plano e o status ao lado dele: Para pagar ou renovar, clique em Pagar / Renovar e conclua na página de pagamento. Role a tela até Limites do plano, que valem para cada workspace (Não incluso marca o que o plano não tem), e Por workspace, que mostra cada workspace com o uso de automações no mês e, quando houver, as Assinaturas de addon e o uso Acima do limite.", "escalar": [ "Qualquer dúvida de valor, cobrança ou contrato" ] }, "relacionados": [ "execucoes-de-automacoes-por-plano", "liberar-addon-no-workspace" ], "markdown": "---\nslug: assinatura-e-cobranca\ncategoria: Conta e assinatura\natualizado: 17/10/2026\ntags: assinatura, plano, pagamento, vencimento, renovar, upgrade, fatura, plano vencido, cobrar clientes\nno_painel: Agência > Assinatura\nverificacao: baseado no guia oficial do painel\n---\n\n# Acompanhar a assinatura\n\nVeja plano, status e vencimento, pague ou renove, faça upgrade, cobre clientes, acompanhe as automações de cada workspace e saiba o que acontece quando o plano vence.\n\n**Para quem é:** Donos de agência e administradores de conta.\n\n**Antes de começar:**\n- **Agência** → **Assinatura** aparece só para o dono da conta.\n- **Assinatura**, na seção **Workspace**, aparece para o dono e os admins do workspace de um cliente quando a agência vende os próprios planos pelo painel.\n- O pagamento é feito numa página de pagamento, fora do painel.\n\nEm **Assinatura** você acompanha o plano: o status, a data de vencimento e o botão para pagar. Existem duas telas com esse nome. A da agência, em **Agência** → **Assinatura**, mostra o plano da sua agência, os limites e os addons. A do workspace, na seção **Workspace** do menu lateral, mostra o plano que o cliente tem com a agência.\n\nUm dia depois do vencimento sem pagamento, o acesso é suspenso. Aqui você vê como pagar em dia e o que fazer se isso acontecer.\n\n## Acompanhar o plano da agência (dono da conta)\n\n1. No menu lateral, clique em **Agência** e depois em **Assinatura**.\n2. Em **Plano atual**, veja o nome do seu plano e o status ao lado dele:\n - **Renovação automática**: a cobrança é automática, na data de **Próxima cobrança**.\n - **Pagamento manual**, **Vence hoje** ou o aviso de quantos dias faltam: pague até a data de **Vencimento**.\n - **Vencido**: o prazo passou e o acesso está suspenso (veja *Se algo der errado*).\n - **pagamento pendente**: a cobrança automática não foi paga. Enquanto ela não é confirmada, o acesso fica suspenso, como em **Vencido**.\n3. Para pagar ou renovar, clique em **Pagar / Renovar** e conclua na página de pagamento.\n4. Role a tela até **Limites do plano**, que valem para cada workspace (**Não incluso** marca o que o plano não tem), e **Por workspace**, que mostra cada workspace com o uso de automações no mês e, quando houver, as **Assinaturas de addon** e o uso **Acima do limite**.\n\n## Acompanhar as automações de cada workspace (dono da conta)\n\n1. Em **Agência** → **Assinatura**, role até **Por workspace**. Os workspaces mais perto do limite aparecem primeiro, e os sem limite, no fim.\n2. Em cada workspace, veja **Automações este mês**: quantas execuções de automação ele usou no mês, o limite do plano e a porcentagem, por exemplo *1.200 de 3.000 (40%)*. Embaixo aparecem a data de renovação e, se o plano tiver, o limite por minuto, como *até 20 por minuto*. Sem limite mensal, aparece só o total, como *350 execuções este mês · sem limite*.\n3. A partir de 80% do limite, aparece o aviso \"Perto do limite. Ao atingir, novas execuções aguardam a renovação ou um upgrade do plano.\". No limite, ele muda para \"Limite atingido: novas execuções aguardam a renovação ou um upgrade do plano.\".\n\nUma execução é cada vez que uma automação começa a rodar, numa Automação Básica ou num fluxo do Flow Builder. Os passos, as esperas e as respostas dessa mesma execução não contam de novo, mas um fluxo iniciado por outro conta como uma nova execução. A execução conta quando começa, mesmo que as condições não passem ou que um passo falhe depois. O mês é o do calendário, em UTC: o contador volta a zero no dia 1º, não na data de vencimento do plano.\n\nNo limite, as automações continuam disparando, mas cada nova execução fica parada, sem enviar nada, e aparece como **Aguardando cota** em **Execuções** e em **Fluxos ativos**, nas informações do contato. O painel tenta de novo a cada 5 minutos e libera as execuções na renovação do mês, depois de um upgrade do plano ou depois que um pacote de execuções extras do workspace é pago. Acima do limite por minuto, a execução espera o minuto seguinte. As execuções que já tinham começado continuam até o fim. Uma execução liberada roda os passos nessa hora: uma mensagem de boas-vindas que ficou parada chega depois. Para que ela não rode, tire o contato do fluxo em **Fluxos ativos**.\n\nPara ver quantas execuções cada plano inclui e contratar pacotes extras para um workspace, veja «Execuções de automações por plano» (artigo `execucoes-de-automacoes-por-plano`).\n\n## Fazer upgrade ou contratar um addon (dono da conta)\n\n1. Na seção **Fazer upgrade**, que só aparece quando há um plano superior ao seu, clique em **Fazer upgrade** no plano escolhido.\n2. Com **Renovação automática**, confirme na janela: você paga agora só a diferença proporcional do período, e o vencimento e o cartão não mudam. Sem ela, abre a página de pagamento do novo plano.\n3. Em **Addons disponíveis**, clique em **Contratar**, ou em **Adicionar** para mais uma unidade, e confirme. A contratação abre o checkout do Stripe. Com assinatura automática do plano ativa, o primeiro pagamento é proporcional até o próximo vencimento do plano; depois, o addon renova na mesma data em uma assinatura própria. Sem uma assinatura automática ativa, o checkout do addon tem ciclo independente. A unidade só é liberada após confirmar o pagamento. As unidades concedidas pelo administrador são preservadas. Assinaturas antigas não são alteradas por uma nova contratação.\n4. No addon de WhatsApp QR, a compra já libera a unidade num workspace: se houver mais de um, o painel pergunta qual. Para distribuir os demais addons, veja «Liberar um addon no workspace» (artigo `liberar-addon-no-workspace`).\n\n## Cobrar um cliente pelo painel (dono da conta)\n\n1. Em **Agência**, clique em **Configurar agência** e abra a aba **Planos**. Ela depende do recurso de revenda no plano da agência; sem ele, mostra um aviso com cadeado.\n2. Clique em **Novo plano**, preencha **Nome do plano** e **Preço**, deixe **Ativo (visível aos clientes)** marcado e, se quiser, cole o **Link de pagamento (seu gateway — opcional)**. Clique em **Salvar**. Você pode ter até 3 planos.\n3. Na lista de workspaces, na linha do cliente, clique em **Ações** e em **Plano de revenda**. Escolha o **Plano**, defina o **Vencimento** e clique em **Salvar**. Sem data, o plano não vence.\n4. Quando o cliente pagar, abra **Ações** → **Plano de revenda** de novo e defina o novo **Vencimento**.\n\n## Ver a assinatura do workspace (cliente)\n\n1. No menu lateral, na seção **Workspace**, clique em **Assinatura**.\n2. Veja o **Plano** e o **Vencimento**. Um dia depois do vencimento, aparece **vencido** ao lado da data.\n3. Para pagar, clique em **Pagar/Renovar**, ou em **Assinar** num dos planos que a agência oferece. A página de pagamento da agência abre numa nova aba. Depois do pagamento, a agência atualiza o vencimento.\n\n> **Dica:** Dono da conta: para ver o que o cliente vê, entre no workspace dele e abra **Assinatura**.\n\n## Não funcionou?\n\n- **Aparece \"Seu plano está vencido e o acesso ao sistema foi suspenso. Regularize o pagamento para reativar.\"**\n O plano da agência passou um dia do vencimento sem pagamento, ou a cobrança automática ficou com **pagamento pendente**. Até regularizar, você só abre **Assinatura**, **Agência** → **Suporte** e a **Central de ajuda**; as outras telas voltam para **Assinatura**. A sua equipe e as equipes dos clientes veem **Plano expirado** e ficam sem acesso. Clique em **Pagar agora** ou em **Pagar / Renovar**.\n- **A equipe do cliente vê \"Assinatura vencida\"**\n O plano do workspace com a agência passou um dia do vencimento, e a equipe fica sem acesso até a agência definir um novo vencimento. Se você é da equipe, fale com o responsável pela sua agência. Se você é o dono da conta, nesse workspace as telas voltam para **Assinatura**: troque de workspace no cartão **Workspace**, abra **Agência** e defina o novo **Vencimento** em **Ações** → **Plano de revenda**.\n- **Paguei, mas o status não mudou**\n - Plano da agência: aguarde um pouco e recarregue a página. Se nada mudar, fale com o suporte em **Agência** → **Suporte**.\n - Workspace de cliente: o vencimento muda quando a agência registra o pagamento. Fale com o responsável pela sua agência.\n- **O botão Pagar / Renovar não aparece**\n - Com **Renovação automática**, ele não aparece, porque a renovação é automática.\n - Sem ela, o plano ainda não tem pagamento pelo painel: fale com o suporte em **Agência** → **Suporte**.\n - No workspace de cliente, **Pagar/Renovar** só aparece quando a agência cadastra um link de pagamento no plano. Fale com o responsável pela sua agência.\n- **Quero trocar o cartão, ver faturas, cancelar ou mudar para um plano menor**\n Essas opções não ficam no painel, que só faz upgrade para um plano superior. Dono da conta: fale com o suporte em **Agência** → **Suporte**. No workspace de cliente, fale com o responsável pela sua agência.\n- **Um addon mostra \"Fale com o suporte\" no lugar de Contratar**\n Esse addon não pode ser contratado pelo painel agora. Fale com o suporte em **Agência** → **Suporte**.\n- **Aparece \"Canais sem cobertura de assinatura\"**\n Esse aviso aparece somente para o dono da agência em **Assinatura**. Ele identifica o workspace, o canal e os addons relacionados ao recurso sem cobertura. Confira se o plano está vigente e revise a alocação do workspace; se precisar de mais unidades, use **Ver addons disponíveis**. O envio, o recebimento e novos contatos e conversas ficam bloqueados nos canais indicados. As conexões e o histórico continuam preservados. A equipe vê apenas que o canal está indisponível no chat, sem detalhes de cobrança.\n- **Em Plano de revenda, aparece \"Nenhum plano ativo cadastrado\"**\n Crie um plano na aba **Planos** das **Configurações da agência**, com **Ativo (visível aos clientes)** marcado. Planos inativos não aparecem para escolher nem na tela do cliente.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Acompanhar a assinatura?\n- Aparece \"Seu plano está vencido e o acesso ao sistema foi suspenso. Regularize o pagamento para reativar.\"\n- A equipe do cliente vê \"Assinatura vencida\"\n- Paguei, mas o status não mudou\n- O botão Pagar / Renovar não aparece\n\nResposta curta: Veja plano, status e vencimento, pague ou renove, faça upgrade, cobre clientes, acompanhe as automações de cada workspace e saiba o que acontece quando o plano vence. No menu lateral, clique em Agência e depois em Assinatura. Em Plano atual, veja o nome do seu plano e o status ao lado dele: Para pagar ou renovar, clique em Pagar / Renovar e conclua na página de pagamento. Role a tela até Limites do plano, que valem para cada workspace (Não incluso marca o que o plano não tem), e Por workspace, que mostra cada workspace com o uso de automações no mês e, quando houver, as Assinaturas de addon e o uso Acima do limite.\n\nEscalar para um humano quando:\n- Qualquer dúvida de valor, cobrança ou contrato\n\nVeja também: «Execuções de automações por plano» (`execucoes-de-automacoes-por-plano`); «Liberar um addon no workspace» (`liberar-addon-no-workspace`)\n" }, { "slug": "execucoes-de-automacoes-por-plano", "categoria": "Conta e assinatura", "titulo": "Execuções de automações por plano", "resumo": "Veja quantas execuções de automações cada plano inclui por workspace e como ampliar o limite de um workspace com pacotes extras.", "tags": [ "execuções", "automações", "limite", "plano", "pacote extra", "cota", "automação parou" ], "publico": "Donos de agência e administradores de conta.", "no_painel": [ "Agência", "Assinatura" ], "atualizado": "17/10/2026", "faq": [], "problemas": [ { "sintoma": "O workspace atingiu o limite e as automações aparecem como Aguardando cota", "causa": "", "solucao": "No limite, cada nova execução fica parada, sem enviar nada, e aparece como Aguardando cota em Execuções e em Fluxos ativos, nas informações do contato. O painel tenta de novo a cada 5 minutos: depois que um pacote extra desse workspace é pago ou que o plano recebe upgrade, as execuções paradas voltam a rodar. Sem isso, elas rodam na virada do mês. Se você é admin, avise o dono da conta." }, { "sintoma": "Contratei, mas o limite do workspace não mudou", "causa": "", "solucao": "O pacote só é liberado depois que o pagamento é confirmado. Aguarde um pouco e recarregue a página. Confira também o workspace escolhido na contratação: o pacote vale só para ele. Se nada mudar, fale com o suporte em Agência → Suporte." }, { "sintoma": "Aparece \"Crie ou ative um workspace para contratar este addon.\"", "causa": "", "solucao": "O pacote precisa de um workspace ativo da agência. Crie ou ative um workspace em Agência e tente de novo." }, { "sintoma": "Quero ampliar o limite de todos os workspaces", "causa": "", "solucao": "Cada pacote vale para um workspace só. Para ampliar todos de uma vez, faça upgrade do plano na seção Fazer upgrade, em Agência → Assinatura. Ela só aparece quando há um plano superior ao seu." } ], "para_ia": { "perguntas": [ "Execuções de automações por plano?", "O workspace atingiu o limite e as automações aparecem como Aguardando cota", "Contratei, mas o limite do workspace não mudou", "Aparece \"Crie ou ative um workspace para contratar este addon.\"", "Quero ampliar o limite de todos os workspaces" ], "resposta": "Veja quantas execuções de automações cada plano inclui por workspace e como ampliar o limite de um workspace com pacotes extras. No menu lateral, clique em Agência e depois em Assinatura. Em Por workspace, veja Automações este mês de cada workspace e decida qual precisa de mais execuções. Role a tela até Addons disponíveis e encontre o pacote de execuções extras. A linha mostra quantas execuções extras por mês cada pacote soma e o preço. Clique em Contratar. Se a conta já tem esse pacote, o botão é Adicionar.", "escalar": [ "Limite de execuções atingido" ] }, "relacionados": [ "assinatura-e-cobranca", "escolher-automacao" ], "markdown": "---\nslug: execucoes-de-automacoes-por-plano\ncategoria: Conta e assinatura\natualizado: 17/10/2026\ntags: execuções, automações, limite, plano, pacote extra, cota, automação parou\nno_painel: Agência > Assinatura\nverificacao: baseado no guia oficial do painel\n---\n\n# Execuções de automações por plano\n\nVeja quantas execuções de automações cada plano inclui por workspace e como ampliar o limite de um workspace com pacotes extras.\n\n**Para quem é:** Donos de agência e administradores de conta.\n\n**Antes de começar:**\n- Só o dono da conta contrata pacotes extras e faz upgrade do plano: o menu **Agência** aparece apenas para ele. Se você é admin, peça a ele.\n- O dono da conta acompanha o uso de cada workspace em **Agência** → **Assinatura**, na seção **Por workspace**, em **Automações este mês**.\n\nCada plano inclui uma cota de execuções de automações, e essa cota vale por workspace. Ou seja, cada workspace da sua conta tem o seu próprio limite, separado dos demais. Aqui você vê quanto cada plano inclui e como ampliar o limite de um workspace com pacotes extras.\n\nUma execução é cada vez que uma automação começa a rodar, numa Automação Básica ou num fluxo do Flow Builder. A cota é mensal: o contador volta a zero no dia 1º de cada mês, em UTC.\n\n## Execuções incluídas por plano\n\nCada workspace recebe, por mês:\n\n- **Basic**: 3.000 execuções\n- **PRO**: 5.000 execuções\n- **Revenda mini (legado)**: 3.000 execuções. Em **Plano atual**, ele aparece como *Revenda mini - inativo*.\n- **Revenda Mini**: 5.000 execuções\n- **Enterprise Starter**: 20.000 execuções\n- **Enterprise Pro**: 40.000 execuções\n\nO Revenda mini (legado) vale apenas para quem já assinava esse plano. Novas assinaturas entram no Revenda Mini.\n\n## Execuções extras\n\nSe um workspace precisar de mais execuções do que o plano inclui, é possível contratar pacotes extras para ele. Cada pacote soma 2.500 execuções por mês ao workspace para o qual foi contratado. Os outros workspaces continuam com o limite do plano.\n\n- Os pacotes se somam: 2 pacotes no mesmo workspace dão 5.000 execuções extras por mês.\n- O que sobrar no mês não passa para o mês seguinte.\n- O pacote amplia só a cota do mês. O limite por minuto continua o do plano.\n- Os extras valem enquanto a assinatura do pacote estiver ativa.\n\n## Contratar um pacote extra (dono da conta)\n\n1. No menu lateral, clique em **Agência** e depois em **Assinatura**.\n2. Em **Por workspace**, veja **Automações este mês** de cada workspace e decida qual precisa de mais execuções.\n3. Role a tela até **Addons disponíveis** e encontre o pacote de execuções extras. A linha mostra quantas execuções extras por mês cada pacote soma e o preço.\n4. Clique em **Contratar**. Se a conta já tem esse pacote, o botão é **Adicionar**.\n5. Se a conta tem mais de um workspace, abre a janela **Contratar addon para um workspace**: escolha o workspace em **Workspace** e clique em **Contratar e liberar**. Com um workspace só, confira o nome dele na confirmação e clique em **Contratar**.\n6. Conclua o pagamento no checkout do Stripe. O pacote é liberado no workspace depois que o pagamento é confirmado.\n\n## Exemplos\n\n- **Enterprise Starter com 3 workspaces**: cada um dos 3 workspaces tem 20.000 execuções por mês. O limite não é de 20.000 para a conta inteira.\n- **Workspace no Revenda Mini que precisa de 9.000 execuções por mês**: o plano inclui 5.000, faltam 4.000. São 2 pacotes extras (5.000 execuções a mais), contratados para esse workspace.\n\n## Não funcionou?\n\n- **O workspace atingiu o limite e as automações aparecem como Aguardando cota**\n No limite, cada nova execução fica parada, sem enviar nada, e aparece como **Aguardando cota** em **Execuções** e em **Fluxos ativos**, nas informações do contato. O painel tenta de novo a cada 5 minutos: depois que um pacote extra desse workspace é pago ou que o plano recebe upgrade, as execuções paradas voltam a rodar. Sem isso, elas rodam na virada do mês. Se você é admin, avise o dono da conta.\n- **Contratei, mas o limite do workspace não mudou**\n O pacote só é liberado depois que o pagamento é confirmado. Aguarde um pouco e recarregue a página. Confira também o workspace escolhido na contratação: o pacote vale só para ele. Se nada mudar, fale com o suporte em **Agência** → **Suporte**.\n- **Aparece \"Crie ou ative um workspace para contratar este addon.\"**\n O pacote precisa de um workspace ativo da agência. Crie ou ative um workspace em **Agência** e tente de novo.\n- **Quero ampliar o limite de todos os workspaces**\n Cada pacote vale para um workspace só. Para ampliar todos de uma vez, faça upgrade do plano na seção **Fazer upgrade**, em **Agência** → **Assinatura**. Ela só aparece quando há um plano superior ao seu.\n\nSe depois disso o problema continuar, fale com a equipe de suporte informando o nome do workspace, o canal afetado, o horário exato de um exemplo e o nome do contato.\n\n## Resumo para agentes de IA\n\nPerguntas que este artigo responde:\n- Execuções de automações por plano?\n- O workspace atingiu o limite e as automações aparecem como Aguardando cota\n- Contratei, mas o limite do workspace não mudou\n- Aparece \"Crie ou ative um workspace para contratar este addon.\"\n- Quero ampliar o limite de todos os workspaces\n\nResposta curta: Veja quantas execuções de automações cada plano inclui por workspace e como ampliar o limite de um workspace com pacotes extras. No menu lateral, clique em Agência e depois em Assinatura. Em Por workspace, veja Automações este mês de cada workspace e decida qual precisa de mais execuções. Role a tela até Addons disponíveis e encontre o pacote de execuções extras. A linha mostra quantas execuções extras por mês cada pacote soma e o preço. Clique em Contratar. Se a conta já tem esse pacote, o botão é Adicionar.\n\nEscalar para um humano quando:\n- Limite de execuções atingido\n\nVeja também: «Acompanhar a assinatura» (`assinatura-e-cobranca`); «Automações: qual usar em cada situação» (`escolher-automacao`)\n" } ] }