Tudo o que você precisa para dominar a plataforma — guias, passo a passo e respostas.
Pesquise os artigos aqui ou navegue pelas categorias abaixo.
Navegar por tópico
Encontre guias, tutoriais e respostas organizados por categoria.
Primeiros Passos
Visão geral da plataforma, login, perfil, 2FA, tour da interface, conceitos essenciais e onboarding com o Cérebro Maestro.
Navegar
Caixas de Entrada & Canais
WhatsApp Web e Cloud, Coexistence, Hub de grupos/comunidades, templates/flows/chamadas, site, e-mail, redes sociais, voz e API.
Navegar
Conversas & Atendimento
Tela de conversas, respostas, notas, atribuição, status, prioridade, labels, macros, respostas rápidas, busca, filtros e SLA.
Navegar
Contatos & CRM
Contatos, importação, segmentos, atributos, empresas, pipelines/kanban/negócios e registro de pedidos.
Navegar
Catálogo & Comércio
Catálogo nativo, sincronização e WhatsApp Business Catalog, envio de produtos/pedidos na conversa e ciclo de vida de e-commerce.
Navegar
Pagamentos
Conectar gateway (Asaas/Mercado Pago), criar cobranças (PIX/boleto/cartão), assinaturas, descontos, agendamento pago e relatórios.
Navegar
Agenda & Agendamentos
Conectar Google Calendar, tipos de evento, disponibilidade, página pública de agendamento, reagendar/cancelar, Meet e .ics.
Navegar
Tarefas
Listas, board e calendário, subtarefas, dependências, recorrência, lembretes, SLA, templates e painel na conversa.
Navegar
Follow-ups & Cadências
Sequências, passos, canais, composição, inscrição (manual/automação/evento/inatividade/IA), funil, saída e IA com aprovação humana.
Navegar
Automação & Fluxos
Regras de automação, macros, Flow Builder, roteamento inteligente, bots e Captain.
Navegar
Maestro IA & Cérebro da Conta
O que é o Maestro, onboarding por voz, copiloto generativo (propor→confirmar→executar), departamentos, riscos, insights e ferramentas por módulo.
Navegar
Growth & Marketing Studio
Page/Form Builder, AI Studio, publicação social, Ads/CTWA/leadgen, lançamentos, turmas de lançamento, automação social e Rede de Colaboração.
Navegar
Contratos & Assinatura Eletrônica
Empresas emissoras, certificado A1, templates, variáveis, auto-fill, assinatura interna/externa, página pública e validador.
Navegar
Vendas & Gamificação
Gestão de vendas, carteira, metas, meta-sobre-meta, gamificação, leaderboard, recompensas, comissões, TELÃO e lead score.
Navegar
Mídia
Biblioteca de mídia, pastas, lixeira, medidor de armazenamento e reutilização de arquivos em qualquer canal.
Navegar
Chat Interno
Canais, mensagens diretas, anúncios e compartilhamento de entidades (conversas, contatos, negócios) como cards.
Navegar
Relatórios & Análises
Visão geral, conversas, agentes, equipes, labels, inbox, CSAT, SLA e relatórios por módulo.
Navegar
Campanhas
Campanhas no site, campanhas de WhatsApp, templates HSM e variáveis.
Navegar
Administração & Configurações
Conta, agentes, equipes, papéis e governança (RBAC), horários, labels, atributos, integrações, auditoria, whitelabel, scripts e notificações.
Navegar
API & Desenvolvedores
API REST, tokens, webhooks, SDK de Custom Scripts e eventos por módulo.
Navegar
FAQ & Solução de Problemas
Perguntas frequentes, erros comuns (WhatsApp desconectado, pareamento, pagamento falho), limites e boas práticas anti-ban.
Navegar
Artigos populares
O que outras pessoas estão lendo agora.
Mensagens agendadas: criar, gerenciar e configurar
Visão geral Mensagens agendadas permitem preparar agora um envio que acontecerá depois na mesma conversa. O módulo aceita uma mensagem única, uma sequência e recorrências no fuso escolhido. Ele usa o mesmo conteúdo e as mesmas validações de canal do envio imediato. O recurso é diferente de: - Campanhas, que distribuem conteúdo para uma audiência ou vários contatos. - Follow-up, que automatiza uma cadência de acompanhamento e suas condições. - Agenda, que gerencia compromissos. Uma mensagem agendada não cria nem altera um compromisso. Pré-requisitos - Recurso Mensagens agendadas habilitado na conta. - Uma conversa existente e um canal apto a enviar o conteúdo. - Agentes criam e gerenciam os próprios agendamentos. Para gerenciar os de outras pessoas ou alterar políticas da conta/inbox, é preciso ser administrador ou ter a permissão Gerenciar mensagens agendadas. - Antes da primeira publicação, um administrador deve completar as políticas da conta. Passo a passo 1. Abra uma conversa e escreva a mensagem normalmente. 2. Ao lado de Enviar, no cabeçalho da conversa ou no painel lateral direito, abra o ícone de calendário e escolha Agendar uma vez, Agendar uma sequência ou Agendar mensagens recorrentes. O clique principal de Enviar continua enviando imediatamente. 3. Informe nome, data, hora e selecione o fuso pela busca de cidade. Em cada mensagem, escreva o texto, arraste uma mídia/arquivo ou abra o compositor de interativos e templates disponível para o canal. Em sequências, ordene os itens e defina o intervalo de cada um. 4. Em recorrências, escolha a frequência e um término: sem término, até uma data ou por quantidade. Para um padrão especial, abra Configuração avançada e comece por um dos exemplos explicados antes de editar a regra. 5. Revise a prévia. Ela mostra bloqueios, políticas efetivas, capacidade do canal e as próximas cinco ocorrências. 6. Confirme. O rascunho da conversa só é limpo depois que a criação for aceita. 7. Para acompanhar tudo, abra Mensagens agendadas no menu principal. Para a conversa atual, use a bandeja Mensagens agendadas no painel lateral. Captura sugerida: botão dividido de envio, diálogo de prévia e módulo global com o detalhe aberto. Configurações & opções Na tela Mensagens agendadas → Configurações, selecione Padrões da conta ou Uma caixa específica. Em uma conta nova, use Aplicar configuração recomendada para preencher uma base segura e revise somente as exceções. As políticas ficam agrupadas por objetivo e podem ser buscadas pelo nome. Em cada política da caixa, escolha Usar padrão da conta ou Personalizar nesta caixa. Contadores mostram políticas personalizadas, herdadas e pendentes antes de salvar. As políticas controlam resposta do cliente, conversa resolvida, atraso de execução, tentativas após falha, retomada, horário silencioso, sobreposição, troca de Inbox, remetente, variáveis, horário de verão e limites de materialização/recuperação. A origem de cada valor fica visível. Se outra pessoa salvar primeiro, recarregue a versão atual antes de repetir a alteração. No detalhe de um agendamento você pode pausar, retomar, cancelar, arquivar, tentar novamente ou reconciliar um resultado incerto. Em uma ocorrência é possível reagendar, pular, enviar agora ou repetir. Sempre confirme o escopo: apenas esta ocorrência, esta e as próximas, ou todas as futuras. Mídias e conteúdo interativo No próprio diálogo de agendamento, use Escolher da biblioteca para reaproveitar uma mídia da conta, Enviar do dispositivo para um arquivo novo, ou arraste imagens, vídeos, áudios e documentos para a mensagem. As opções acompanham a conversa: WhatsApp Cloud mostra Templates e interativos Cloud; WhatsApp Web mostra Interativo WhatsApp Web; uma conversa em Coexistência mostra os dois compositores, claramente separados. Outros canais não recebem ações incompatíveis. Templates de conteúdo também encaminham ao compositor nativo quando o canal oferece esse recurso. Ao aplicar, a prévia mantém o tipo e o conteúdo visíveis e oferece Editar ou Substituir no compositor nativo, sem perder nome, data, fuso, recorrência ou políticas. Em uma sequência, Duplicar mensagem copia o conteúdo completo; os detalhes técnicos ficam recolhidos por padrão. Casos de uso - Confirmar um retorno combinado com o cliente para amanhã. - Enviar uma sequência curta de instruções no mesmo atendimento. - Repetir um lembrete semanal sem criar uma campanha. - Programar um template aprovado para quando a janela do WhatsApp exigir esse formato. Dicas, limites e boas práticas - O alvo é sempre uma conversa existente; o módulo não aceita audiência, segmento ou vários contatos. - Até 500 ocorrências por agenda são materializadas em uma janela de 30 dias. O restante é criado progressivamente. - Anexos ficam vinculados ao agendamento. Não apague o arquivo de origem enquanto houver envios futuros. - O canal é validado na prévia e novamente no vencimento. Desconexão, opt-out, janela fechada, template não aprovado ou permissão removida podem bloquear o envio depois da criação. - Notificações são de exceção: falha ou estado Requer atenção. Um agendamento normal não gera alerta a cada ocorrência. - Um efeito externo incerto nunca é repetido às cegas. Use Reconciliar depois de verificar o provedor. Solução de problemas - Não vejo a opção de agendar: confirme a feature da conta e sua permissão. - A prévia mostra política incompleta: um administrador precisa completar a configuração da conta ou o valor ausente no escopo indicado. - O canal aparece bloqueado: abra o detalhe do bloqueio e corrija conexão, janela, template, anexo, opt-out ou acesso do remetente. - Recebi conflito ao salvar ou executar uma ação: alguém ou um job alterou o registro. Recarregue o detalhe e repita a intenção sobre a versão atual. - A ocorrência está em Requer atenção: confirme no provedor se houve envio e use Reconciliar → Enviado, Falhou ou Cancelado. Veja também - API e MCP de mensagens agendadas - Entrega de lembretes por WhatsApp e e-mail - Referência da API (Swagger/OpenAPI)
🧠 Maestro IA & Cérebro da ContaModelos: salvar, aplicar, duplicar, exportar e importar a configuração de um Robô
Visão geral Um Modelo é a configuração de um Robô guardada para ser reaproveitada: persona, instruções, modelo de linguagem, ferramentas habilitadas, guardrails, política de transferência, sequência de atendimento e tudo o mais que você ajustou. A biblioteca fica em Configurações → Robôs, logo abaixo da lista de Robôs — e aparece mesmo quando a conta ainda não tem nenhum Robô, porque importar um Modelo é uma das formas de criar o primeiro. | Ação | Onde fica | O que faz | |---|---|---| | Salvar como Modelo | no formulário do Robô | Guarda a configuração na biblioteca desta conta. | | Aplicar um Modelo | no formulário do Robô, em Modelos prontos | Traz a configuração guardada para o formulário; você revisa e salva o Robô. | | Duplicar | na lista de Modelos | Cria uma cópia do Modelo nesta conta, editável. | | Editar | na lista de Modelos | Altera nome, segmento e descrição. Não toca na configuração guardada. | | Excluir | na lista de Modelos | Remove o Modelo. Os Robôs já criados a partir dele continuam funcionando. | | Exportar / Importar | na lista de Modelos | Gera e lê um arquivo .maestro-template.json, que outra instalação consegue abrir. | Leia isto antes de migrar: um Modelo não é uma cópia integral do Robô. Duas classes de coisa ficam para trás por decisão de projeto — segredos e referências locais. Sempre que algo é salvo, exportado ou importado, o painel O que não viajou diz exatamente o que foi removido ou limpo. Nunca assuma "importou 100%". Pré-requisitos - Maestro habilitado e pelo menos um Robô configurado (ou um arquivo de Modelo para importar). - Permissão de administrador para salvar, duplicar, editar, excluir, exportar e importar. - Para importar em outra instalação: acesso de administrador lá também. Passo a passo Salvar um Robô como Modelo 1. Vá em Configurações → Robôs e abra o Robô que já está do jeito que você quer. 2. No bloco Modelos prontos, use Salvar como Modelo. 3. Preencha Nome, e opcionalmente Segmento (opcional) e Para que serve este Modelo? (opcional). Dê um nome que descreva o uso, não o cliente. 4. Confirme em Salvar Modelo. Ele aparece no topo da lista de Modelos. Atenção — são dois comportamentos, e o diálogo diz qual se aplica: - Robô já salvo: guarda a configuração que ele está rodando agora, e não as edições ainda não salvas neste formulário. Se você acabou de mudar algo, salve o Robô antes. - Robô ainda não criado: como não existe Robô, a configuração que está na tela é guardada como está. Aplicar um Modelo num Robô Este é o caminho de Modelo para Robô — duplicar não cria Robô nenhum. 1. Abra um Robô existente ou comece a criar um novo. 2. No bloco Modelos prontos, abra o seletor Agente por vertical. Os Modelos da sua conta (e os da biblioteca da instalação) aparecem na frente dos presets prontos do produto. 3. Escolha o Modelo e use Aplicar. O aviso informa quantos ajustes ele trouxe: aplicar mescla apenas os campos que o Modelo carrega — o resto do formulário continua como estava. 4. Revise a configuração, salve o Robô e vincule-o às caixas de entrada onde ele deve atender. Encontrar, duplicar, editar e excluir 1. Use o campo Buscar Modelos para filtrar por nome, descrição ou segmento. Limpar busca volta à lista completa. 2. Duplicar cria uma cópia do Modelo nesta conta, já editável (o aviso confirma: "Duplicado como …"). É assim que se personaliza um Modelo Compartilhado, que é só leitura. 3. Editar muda Nome, Segmento e Descrição — a configuração guardada não é tocada. Para mudar a configuração em si, aplique o Modelo num Robô, ajuste e use Salvar como Modelo de novo. 4. Excluir remove o Modelo da biblioteca. Os Robôs criados a partir dele continuam funcionando: um Modelo é ponto de partida, não vínculo. Exportar e importar entre instalações 1. No Modelo, escolha Exportar. O navegador baixa um arquivo .maestro-template.json. 2. Na instalação de destino, use Importar e escolha o arquivo. 3. Leia o painel "O que não viajou" — ele lista item por item o que foi removido ou limpo. 4. Reconfigure o que o painel apontou (chaves, times, base de conhecimento, mídias). 5. Aplique o Modelo num Robô, revise e salve. Configurações & opções Dois escopos: Modelos da conta e biblioteca da instalação A lista mostra os dois juntos, e eles se comportam de maneira diferente de propósito: - Modelos da conta — os que você salvou, duplicou ou importou. São editáveis e podem ser excluídos. - Biblioteca da instalação — vêm marcados com o selo Compartilhado e são só leitura: não oferecem Editar nem Excluir. Para personalizar um deles, use Duplicar: a cópia nasce nesta conta, editável, sem alterar o original. Publicar um Modelo para a instalação inteira é ação do operador da plataforma e não tem caminho no painel da conta: o efeito atravessa todas as contas da caixa, e restringir é reversível enquanto despublicar do mundo não é. O painel "O que não viajou" Aparece depois de salvar, editar, exportar ou importar um Modelo, e lista somente o que não pôde ser levado — referências reencontradas pelo nome não entram na lista, para o painel continuar sendo lido. Dispensar fecha o aviso. O que NUNCA viaja: segredos Nem os valores, nem os nomes. Um nome de segredo já é um mapa de onde estão as credenciais. São removidos ao salvar na biblioteca e ao exportar: - Chaves de provedor do Robô e o espelho das chaves nativas da conta. - Segredos cadastrados e a lista de nomes deles. - Credenciais digitadas literalmente dentro de ferramentas HTTP e servidores MCP — cabeçalhos como Authorization, Cookie, e qualquer campo cujo nome pareça api_key, token, password, secret. - Credencial embutida na URL (https://usuario:senha@host/...). Só o usuario:senha sai; host, caminho e query continuam, para a ferramenta seguir reconfigurável. A política é uma lista de negação: tudo viaja, exceto o que for nomeado como segredo ou referência local. Um campo novo cujo nome pareça credencial é removido automaticamente. Assim, o erro possível é "viajou de menos", nunca "vazou um segredo". Uma exceção importante e útil: uma referência no formato {{secret.NOME}} sobrevive — ela aponta para um segredo, não é um segredo. Do outro lado, basta cadastrar um segredo com aquele nome e a ferramenta volta a funcionar sem você reescrever nada. Use sempre essa forma nas ferramentas HTTP. O que NÃO viaja: referências locais Um time 7 na instalação de destino aponta para um time que não existe — ou, pior, para um time diferente. Por isso cada referência é exportada pelo nome que tinha, reencontrada pelo nome na importação, e limpa quando nada casa. Nada é inventado: um Robô apontando para o time 1 só porque o 1 existe é pior do que um Robô sem time. | Item | Na importação | |---|---| | Time de transferência | Remapeado pelo nome; limpo se não existir time com aquele nome. | | Subagentes (delegação) | Remapeados pelo nome. | | Base de conhecimento | Chega desligada — o conteúdo já ingerido não viaja. Reingira e ligue de novo. | | Mídias da biblioteca | Descartadas — as URLs apontam para o armazenamento da origem. Reenvie no destino. | | Banco de dados / voz clonada | O recurso não viaja; a capacidade chega desligada e nomeada no painel. | | Atributos de contato | Conferidos contra os que a conta de destino realmente define. | Uma capacidade cujo recurso não pôde viajar chega desligada de propósito: deixá-la ligada entregaria um Robô que responde "consultei nossa base de conhecimento" contra uma base vazia. O arquivo - Extensão .maestro-template.json, com um marcador de formato e uma versão. - Um arquivo sem o marcador não é tratado como Modelo: é recusado, não adivinhado. - Uma versão que esta instalação não conhece também é recusada — nunca lida pela metade. Um Modelo meio lido é um Robô que parece configurado e não está. Casos de uso - Padronizar o atendimento — um Modelo "Suporte nível 1" aplicado a vários Robôs. - Testar uma variante — duplique o Modelo, aplique a cópia num Robô de teste e compare. - Ambiente de testes → produção — configure com calma no ambiente de teste, exporte e importe. - Agência / multi-cliente — um Modelo por vertical, exportado e importado em cada conta. - Backup de configuração — exporte antes de uma mudança grande. - Migração de instalação — leve os Robôs sem reconfigurar tudo na mão. Dicas, limites e boas práticas - Sempre leia o painel "O que não viajou". Ele é a lista de tarefas do outro lado. - Depois de importar, faça um teste real numa conversa antes de ligar o Robô no atendimento. - Prefira {{secret.NOME}} a colar a credencial: é a única forma que sobrevive à viagem. - Nomeie Modelos pelo uso ("Clínica — agendamento"), não pelo cliente. - Editar não muda comportamento: mexe só no rótulo (nome, segmento, descrição). - Duplique antes de experimentar — assim o Modelo que já funciona continua intacto. - O Modelo é uma fotografia: mudar o Robô depois não atualiza o Modelo, e vice-versa. Solução de problemas - "Dupliquei e não apareceu Robô nenhum" — duplicar copia o Modelo, não cria Robô. Para virar Robô, abra o formulário do Robô, aplique o Modelo em Agente por vertical, salve e vincule-o às caixas de entrada. - "Este Modelo não tem Editar nem Excluir" — ele veio da instalação (selo Compartilhado) e é só leitura. Use Duplicar para ter uma cópia editável nesta conta. - "Já existe um Modelo com esta chave" — você está importando um arquivo que já está na biblioteca. Duplique o que você já tem, ou renomeie antes de importar de novo. - "O arquivo foi recusado na importação" — não é um .maestro-template.json válido, ou foi gerado por uma versão que esta instalação não lê. - "O Robô não transfere para o time certo" — o time não existia pelo mesmo nome; o painel marcou como limpo. Crie o time e selecione-o. - "Ele diz que consultou a base e não achou nada" — a base chega desligada e vazia. Reingira o conteúdo e ligue a base. - "As ferramentas HTTP dão erro de autenticação" — as credenciais não viajam. Cadastre os segredos no destino. - "Faltam as mídias" — os arquivos não viajam; reenvie na biblioteca de mídia do destino. - "Apliquei o Modelo e nem tudo mudou" — aplicar mescla só os campos que o Modelo carrega; o aviso mostra quantos ajustes foram trazidos. O resto continua como o formulário já estava. Veja também - O que é o Maestro IA e o Cérebro da Conta - Onde cada Robô é usado - Base de conhecimento e ontologia - DeepSeek como provedor de modelo do Robô - Ferramentas do Maestro por módulo
🧠 Maestro IA & Cérebro da ContaBusca na web: o Robô pesquisando na internet pública
Visão geral A busca na web dá ao Robô duas ferramentas para consultar a internet pública — coisas que ele não sabe e que não estão na sua conta: notícias, preços de mercado, dados públicos de empresas, documentação, qualquer coisa que mudou depois do treinamento do modelo. | Ferramenta | O que faz | |---|---| | web_search | Pesquisa na web e devolve resultados ranqueados com título, URL e um trecho de cada página. | | web_fetch | Lê o texto completo de páginas específicas por URL — depois de uma busca, quando o trecho não basta, ou quando o Robô já tem a URL. | As duas são somente leitura e não enviam nada ao contato: elas devolvem texto para o modelo, que então decide o que (e se) vai dizer. Por isso continuam disponíveis mesmo quando o Robô delega a um subagente. Para o conteúdo da sua conta — contatos, negócios, catálogo, histórico — o Robô tem ferramentas próprias, e a base de conhecimento guarda o seu material. A busca na web é para o que está fora. Pré-requisitos - Maestro habilitado e um Robô configurado. - Uma chave de API da Tavily disponível para o Robô (veja "A chave" abaixo). - As ferramentas web_search e/ou web_fetch habilitadas na grade de ferramentas do Robô — sem elas, nada nesta seção tem efeito. Passo a passo 1. Na configuração do Robô, abra a grade de Ferramentas e habilite Buscar na web e/ou Ler uma página da web (categoria Conhecimento). 2. Desça até a seção Busca na web. Se nenhuma das duas estiver ligada, um aviso avisa que nada ali terá efeito ainda. 3. Ajuste Profundidade da busca e Resultados por busca. 4. Se quiser restringir, preencha Buscar só nestes domínios e/ou Nunca nestes domínios. 5. Salve. Para desligar a busca por completo, desabilite as duas ferramentas na grade. As configurações ficam guardadas para quando você voltar a ligá-las. Configurações & opções | Opção | O que faz | Padrão | |---|---|---| | Profundidade da busca | Básica ou Avançada. A avançada lê mais de cada página e acerta mais, mas consome mais créditos por chamada. Vale também para o web_fetch ao ler uma página. | Básica | | Resultados por busca | Teto de 1 a 20. Vazio = o padrão da ferramenta (5). | Vazio (5) | | Buscar só nestes domínios | Restringe a busca a esses domínios. Vazio = a web inteira. | Vazio | | Nunca nestes domínios | Bloqueia esses domínios sempre. | Vazio | Como as duas listas de domínio se combinam Elas não funcionam do mesmo jeito, e a diferença é proposital: - Buscar só nestes domínios é uma restrição. Quando você preenche, a lista do Robô é ignorada — ele não consegue buscar em outro lugar, nem se pedir. Uma restrição que o modelo pode ampliar não é restrição. - Nunca nestes domínios é uma lista de bloqueio. Os seus domínios valem sempre, e o Robô ainda pode acrescentar outros para uma consulta específica. Digite os domínios separados por vírgula ou por linha. https://, www. e o caminho depois da barra são removidos automaticamente — a Tavily compara hosts, então https://exemplo.com/precos vira exemplo.com. O que fica com o Robô (e não com você) - Quantos resultados pedir naquela consulta: ele pode pedir menos que o seu teto, nunca mais. - O tema da consulta (geral, notícias ou finanças) e a janela de tempo (último dia, semana, mês ou ano), decididos por pergunta. Hoje esses dois não têm campo fixo por Robô — o padrão é geral, sem recorte de tempo. - Quais URLs ler no web_fetch — no máximo 5 por chamada. A chave (Tavily) A busca precisa de uma chave da Tavily. Ela é procurada nesta ordem: 1. A chave do próprio Robô (seção de chaves de API, provedor tavily). 2. A chave da sua conta, em Integrações. 3. A chave da instalação, configurada pelo operador. Sem nenhuma delas, as ferramentas respondem que a busca não está configurada e o Robô segue a conversa com o que já sabe — a conversa não quebra. Casos de uso - Suporte técnico — consultar a documentação pública de um parceiro antes de orientar o cliente. - Pré-venda — checar dados públicos da empresa do contato para qualificar melhor. - Notícias e preços — responder sobre algo que mudou depois do treinamento do modelo. - Base restrita — preencher Buscar só nestes domínios com o seu site e a sua documentação: o Robô pesquisa apenas ali, como uma busca interna sobre conteúdo público. Dicas, limites e boas práticas - Cada busca consome créditos da Tavily. A profundidade avançada e um número alto de resultados multiplicam o consumo — comece em Básica com o padrão de 5. - Resultado a mais também é contexto a mais no turno: 20 resultados podem empurrar para fora informação da própria conversa. - O web_fetch lê no máximo 5 páginas por chamada, e o texto de cada página é truncado para caber no turno. - Uma URL que não pôde ser lida é informada ao Robô, não descartada em silêncio — assim ele não responde como se tivesse conferido. - A web pública não é fonte de verdade sobre a sua operação. Para preço, política e prazo seus, use a base de conhecimento. - Combine com Verificação de turno se quiser reter respostas que afirmem algo que o turno não apurou. Solução de problemas - "Configurei tudo e o Robô nunca busca" — as ferramentas web_search/web_fetch estão habilitadas na grade? O aviso na seção avisa quando não estão. - "A busca não está configurada" — não há chave da Tavily em nenhum dos três níveis. - "A chave da API é inválida" — a chave existe mas foi recusada; gere outra na Tavily. - "O limite do plano foi atingido" — os créditos da conta Tavily acabaram. - "A busca está limitada agora" — excesso de chamadas em pouco tempo; ele tenta de novo depois. - "Ele buscou num site que eu não queria" — acrescente o domínio em Nunca nestes domínios, ou restrinja tudo com Buscar só nestes domínios. - "Os resultados vêm de outro país/idioma" — deixe a consulta mais específica nas instruções do Robô e restrinja por domínio. Veja também - O que é o Maestro IA e o Cérebro da Conta - Ferramentas do Maestro por módulo - Base de conhecimento e ontologia - Verificação do que o Robô afirma
🚀 Primeiros PassosVisão geral da plataforma Conversa Labs
Visão geral A Conversa Labs é uma plataforma de atendimento, vendas e automação omnichannel. Em um único lugar você concentra todas as conversas dos seus canais (WhatsApp, site, e-mail, redes sociais e mais), organiza seus contatos, acompanha negócios no CRM, cobra pagamentos, agenda compromissos, dispara cadências de follow-up e automatiza fluxos — com o apoio da inteligência artificial do Maestro. A plataforma combina os recursos nativos de uma central de conversas moderna com dezenas de módulos adicionais Conversa Labs (WhatsApp Web/Hub, Pagamentos, CRM, Agenda, Follow-ups, Catálogo, Vendas e Gamificação, Contratos, Growth, Flow Builder, entre outros). Você ativa apenas o que precisa. Pré-requisitos - Uma conta Conversa Labs ativa e um usuário com acesso. - Um navegador atualizado (Chrome, Edge, Firefox ou Safari). - Para canais e módulos específicos, as permissões e integrações correspondentes (detalhadas em cada categoria desta Central). Passo a passo 1. Faça login na plataforma com seu e-mail e senha. 2. Conheça a barra lateral à esquerda: é por ela que você navega entre Conversas, Contatos, Relatórios e os módulos habilitados. 3. Conecte sua primeira Caixa de Entrada (por exemplo, um número de WhatsApp). 4. Importe ou crie seus Contatos. 5. Ative os módulos que fazem sentido para o seu negócio (CRM, Pagamentos, Agenda, etc.). 6. Use o Maestro para acelerar o onboarding e o dia a dia da operação. Configurações & opções - Conta: dados da empresa, idioma, fuso horário e identidade visual. - Caixas de entrada: um canal por inbox, com regras próprias de atribuição e horário. - Agentes e equipes: quem atende, com quais permissões e em quais equipes. - Módulos: cada módulo tem sua própria área de configuração, descrita na categoria correspondente desta Central. Casos de uso - Centralizar o atendimento de vários números de WhatsApp e do site em uma só tela. - Transformar conversas em negócios no CRM e cobrá-los com Pagamentos. - Agendar reuniões e serviços com a Agenda e recuperar oportunidades com Follow-ups. - Escalar marketing e vendas com Growth, Campanhas e Gamificação. Dicas, limites e boas práticas - Comece simples: conecte um canal e organize os contatos antes de ativar todos os módulos. - Ative módulos de forma incremental para a equipe absorver cada novidade. - Respeite os limites de cada canal (por exemplo, boas práticas anti-ban do WhatsApp). Solução de problemas - Não consigo acessar: confira e-mail/senha e veja o artigo de login, perfil e 2FA. - Não vejo um módulo: ele pode não estar habilitado para sua conta ou para seu perfil de acesso — fale com um administrador. Veja também - Acesso, perfil e segurança (2FA) - Conhecendo a interface - Conceitos essenciais - Onboarding com o Cérebro Maestro
🚀 Primeiros PassosComo reportar um problema (bug, melhoria ou ideia)
Visão geral Você pode relatar um problema, sugerir uma melhoria ou enviar uma ideia sem sair da plataforma. O botão Relatar um problema (ícone de inseto 🐞) fica na barra lateral, na parte inferior. Ao enviar, o relato chega direto à nossa equipe de produto e você acompanha o andamento na aba Meus relatos. Pré-requisitos - Estar logado na plataforma. Qualquer membro da conta pode enviar um relato. - O recurso precisa estar habilitado para a sua conta (já vem ligado por padrão). Passo a passo 1. Na barra lateral, clique em Relatar um problema (🐞). 2. Escolha o tipo: Bug, Melhoria ou Ideia. 3. Escreva um título curto e uma descrição (o que você esperava e o que aconteceu; passos para reproduzir ajudam muito). 4. Selecione a severidade (Baixa, Média, Alta, Urgente). 5. (Opcional) Use as ferramentas de captura — veja abaixo. 6. (Opcional) Revise o Diagnóstico avançado e marque o consentimento. 7. Clique em Enviar relato. Ferramentas de captura - 📷 Captura de tela — captura a aba atual em alta fidelidade (o navegador pede para compartilhar esta aba — confirme) e abre o editor, onde você pode desenhar retângulos e setas de destaque e ocultar dados sensíveis (tarja sólida — a informação é removida de forma definitiva). - 🎯 Selecionar componente — destaque e clique no elemento com problema; capturamos qual componente é e um recorte nítido da tela, que você ainda pode anotar e ocultar. - ⏺️ Gravar tela — grave um vídeo curto reproduzindo o problema (até 2 minutos). Ao parar, abre o revisor: você pode rever a gravação, aparar o início/fim e ocultar áreas sensíveis antes de anexar. - 📎 Anexar arquivo — anexe imagens, vídeos ou arquivos de log. Toque em qualquer miniatura para reabrir o editor (imagens) ou o revisor (vídeos) e ajustar de novo antes de enviar. Diagnóstico avançado Para acelerar a correção, o relato sempre inclui detalhes técnicos: navegador, dispositivo, desempenho, logs do console e falhas de rede recentes. Sua conta, plano, licença e versão do app são adicionados no servidor. O painel Diagnóstico avançado mostra exatamente o que é coletado — você pode inspecionar os logs — para total transparência. Privacidade e dados coletados (LGPD) Os dados de diagnóstico são tratados com base no seu consentimento (art. 7º, I da LGPD) e usados exclusivamente para diagnosticar e corrigir o problema relatado. Antes de enviar qualquer dado de diagnóstico, você precisa aceitar os termos — o aceite é registrado (data, versão dos termos) para fins de transparência. Mascaramos automaticamente informações sensíveis (tokens, senhas, e-mails, CPF, telefone) nos logs, e você pode ocultar áreas dos prints. Detalhes completos nos Termos de Uso e na Política de Privacidade da plataforma. Acompanhando o status Abra o botão de novo e vá na aba Meus relatos. Cada relato mostra o status atualizado (Enviado → Recebido → Aceito → Em andamento → Resolvido) e, quando disponível, o link da issue. O que cada status quer dizer: | Status | O que aconteceu | |---|---| | Enviado | O relato saiu da sua tela e está a caminho da equipe. | | Recebido | Chegou à equipe e entrou na fila de triagem. | | Aceito | A equipe leu, reconheceu o problema e colocou na fila de trabalho. Ainda não começou. | | Em andamento | Alguém está trabalhando nele agora. | | Resolvido | A correção foi concluída. | | Fechado | O relato foi encerrado sem correção (duplicado, não reproduzível ou fora de escopo). | O status se atualiza sozinho: quando a equipe de suporte conclui o relato, ele passa a Resolvido na sua tela em poucos minutos, sem você precisar perguntar. Ao lado, um selo Fornecedor (somente leitura) mostra em que etapa a equipe da Conversa Labs está na triagem. Conversando sobre o relato Clique no relato para abrir o detalhe. É ali que fica a conversa: as respostas da equipe de suporte e as suas. - Ler a resposta da equipe. Quando o suporte responde, a mensagem aparece na conversa do relato. - Responder de volta. Escreva no campo ao final da conversa e envie — a sua resposta chega à equipe junto do relato original, com todo o diagnóstico já anexado. - Se o envio falhar, a mensagem fica marcada e você pode reenviar com um clique. Nada se perde. Nem todo comentário interno da equipe vira mensagem para você — só o que a equipe escolhe publicar. Avisos Você é avisado no sino da plataforma (e por push, se estiver ativado no seu aparelho) quando: - o seu relato é resolvido; - a equipe responde no relato. Clicar no aviso abre o relato certo, já na conversa. Para ligar ou desligar esses avisos, vá em Perfil → Notificações. Solução de problemas - O botão não aparece: o recurso pode estar desabilitado para a sua conta — fale com o administrador. - A captura/gravação não abre: o navegador pede para compartilhar esta aba — confirme para capturar em alta fidelidade. Alguns navegadores (ou o modo privado) bloqueiam a captura; nesse caso o botão some e você pode anexar um arquivo. - Não consigo enviar: verifique se preencheu o título e marcou o consentimento (obrigatório, pois o relato inclui os dados de diagnóstico). Veja também - Conceitos essenciais da plataforma - Login, perfil e 2FA
📥 Caixas de Entrada & CanaisCanal de site com widget de chat ao vivo
Visão geral O canal de Site adiciona um widget de chat ao vivo ao seu site: uma bolha de conversa no canto da tela por onde os visitantes falam com a sua equipe em tempo real. As conversas chegam na caixa de entrada como qualquer outro canal, com histórico por contato, atribuição e automações. Você instala o widget colando um pequeno script no seu site e personaliza cores, textos e comportamento direto na plataforma. Pré-requisitos - Perfil de administrador para criar a caixa de entrada de site. - Acesso para editar o HTML do seu site (ou um gerenciador de tags) para colar o script do widget. - Um site publicado em um domínio acessível. Passo a passo 1. Em Configurações → Caixas de Entrada, crie uma nova caixa e escolha Site. 2. Informe o nome e o domínio do site e configure a saudação inicial. 3. Conclua a criação — a plataforma gera um trecho de código (script) do widget. 4. Copie o script e cole no HTML do seu site, antes do fechamento do </body>, em todas as páginas onde o chat deve aparecer. 5. Publique o site e abra-o no navegador: a bolha do chat deve aparecer. 6. Envie uma mensagem de teste pelo widget e confira se ela chega na caixa de entrada. Configurações & opções - Aparência: cor principal, posição da bolha, avatar e textos de saudação. - Disponibilidade: mensagens diferentes para quando a equipe está online ou offline. - Pré-atendimento: formulário opcional para coletar nome, e-mail e outras informações antes de iniciar a conversa. - Recursos do visitante: o widget pode mostrar respostas rápidas, artigos da Central de Ajuda e permitir envio de anexos, conforme a configuração. Casos de uso - Atender dúvidas de visitantes em páginas de produto e checkout em tempo real. - Capturar leads pelo formulário de pré-atendimento e transformá-los em contatos no CRM. - Reduzir abandono oferecendo ajuda no momento certo da navegação. Dicas, limites e boas práticas - Instale o script em todas as páginas relevantes para não perder conversas. - Configure mensagens de offline claras, informando quando a equipe retorna. - Mantenha a saudação curta e objetiva; convide o visitante a dizer como pode ser ajudado. Solução de problemas - O widget não aparece: confirme que o script foi colado corretamente e que o domínio configurado bate com o do site. - As mensagens não chegam: verifique se a caixa de entrada está ativa e se há agentes atribuídos. - Aparece em página errada: ajuste em quais páginas o script é carregado. Veja também - Canal de e-mail: encaminhamento e IMAP/SMTP - Canal de API para integrações personalizadas - Configurações de inbox - Visão geral de caixas de entrada e canais