# Criar e configurar equipes no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/account-settings/create-configure-teams Configure equipes no BluBash para organizar conversas por departamento, controlar regras de distribuição e acompanhar métricas de desempenho por grupo. As equipes ajudam você a organizar o atendimento ao cliente dentro do BluBash agrupando agentes em departamentos como Suporte, Vendas ou Financeiro. Cada equipe tem suas próprias regras de distribuição, limites de conversas e pesquisas de satisfação opcionais, facilitando o gerenciamento de altos volumes de mensagens mantendo a qualidade do atendimento. Crie equipes separadas para cada departamento para manter as conversas organizadas mesmo em períodos de pico. No menu à esquerda, clique em **Equipes**. Em seguida, no canto superior direito, selecione **Criar equipe**. Informe um **nome da equipe** (por exemplo, *Suporte* ou *Financeiro*) e uma **descrição** opcional para ajudar outras pessoas a identificar o propósito da equipe. Clique em **Próximo** para continuar. Selecione os usuários já cadastrados na plataforma que farão parte desta equipe e clique em **Próximo**. Escolha o **número de WhatsApp** que esta equipe usará como canal de comunicação. Os agentes da equipe terão acesso a esse número ao lidar com as conversas. Nem toda mensagem recebida no número vinculado aparece automaticamente para todos os membros da equipe. Quais conversas cada agente vê é determinado pelas regras de distribuição da equipe, configuradas no próximo passo. Defina as regras e permissões da equipe. As configurações são agrupadas em quatro áreas: **Configurações de conversa** * **Permitir iniciar conversas** — ative para que os agentes possam iniciar novas conversas com contatos. * **Mostrar o nome do agente ao enviar mensagens** — quando ativado, o nome do agente aparece no WhatsApp do cliente em cada mensagem enviada, aumentando a transparência. **Configurações de distribuição** * **Tipo de distribuição**: * **Round-robin** — distribui as conversas igualmente entre os agentes disponíveis. * **Fila** — mantém as conversas em fila até que um agente as assuma manualmente. * **Máximo de conversas simultâneas** — define o limite de conversas ativas por agente a qualquer momento (recomendado: 10). Quando um agente atinge o limite, nenhuma nova conversa é atribuída a ele. Se todos os agentes estiverem no limite, novas conversas vão para a fila. **Regras de encerramento** * **Exigir notas de resolução** — os agentes precisam adicionar notas antes de poder encerrar uma conversa. * **Ativar mensagem de encerramento** — envia automaticamente uma mensagem predefinida quando uma conversa é encerrada. **Pesquisa de satisfação** * **Ativar pesquisa de satisfação** — envia automaticamente uma pesquisa ao cliente quando uma conversa é encerrada, coletando feedback direto. **Calendário da equipe** * Configure os **dias e horários de trabalho** da equipe, incluindo feriados e exceções, para que o tratamento das conversas reflita a disponibilidade real da equipe. Sua equipe agora está criada e configurada. Você pode associar canais de atendimento a ela e acompanhar suas métricas de desempenho específicas pelo dashboard. # Criar tags de conversas e contatos Source: https://blubash-04458f0b.mintlify.app/pt-BR/account-settings/create-tags Use tags no BluBash para classificar contatos, aplicar filtros e segmentar seu público. As tags continuam vinculadas ao contato mesmo depois que uma conversa termina. As tags no BluBash são usadas para organizar contatos e suas conversas. Elas ajudam a classificar perfis, aplicar filtros e acompanhar o relacionamento com cada pessoa ao longo do tempo. Como as tags estão vinculadas ao **contato** e não a uma conversa individual, elas permanecem aplicadas mesmo depois que uma conversa é encerrada. Você pode atribuir várias tags ao mesmo contato e pode restringir a visibilidade de cada tag a equipes específicas para manter seu workspace organizado. ## Criar uma tag No menu à esquerda, clique em **Tags**. Você verá uma lista de tags existentes ou uma tela vazia se nenhuma tiver sido criada ainda. No canto superior direito da página, clique em **+ Adicionar tag** para abrir o formulário de criação. Complete os seguintes campos: * **Nome** — informe um rótulo claro (por exemplo, *Cliente Ativo*, *Segmento: Saúde* ou *Indicação*). * **Descrição** (opcional) — adicione contexto sobre quando ou como usar esta tag. * **Cor** — escolha uma cor para facilitar a identificação rápida da tag. * **Disponibilidade**: * Para tornar a tag visível para **todas as equipes**, ative a opção correspondente. * Para restringir a tag a **equipes específicas**, ative **Selecionar equipes específicas** e marque as que devem ter acesso (por exemplo, Admin, Vendas, Suporte). Após preencher todos os campos, clique em **Criar tag** para finalizar. ## Ideias de tags para o seu workspace Estas categorias refletem características duradouras dos contatos e são úteis em vendas, suporte e gestão de relacionamento: Pessoa física, Empresa, Distribuidor, Revendedor Varejo, Tecnologia, Saúde, Educação Indicação, Redes sociais, Site, Evento Cliente ativo, Cliente inativo, Ex-cliente, Parceiro em potencial Produto A, Suporte técnico, Consultoria, Licenciamento Lead frio, Prioritário, Oportunidade ## Dicas * Use **cores diferentes** para distinguir visualmente as categorias de tags (por exemplo, por departamento, tipo de cliente ou status). * Crie tags que descrevem **quem é o contato**, para que permaneçam úteis ao longo do tempo. * **Evite criar tags demais** — uma lista lotada dificulta a filtragem e o uso diário. * Revise suas tags periodicamente para remover duplicatas ou termos desatualizados. # Ativar ou desativar um agente de IA Source: https://blubash-04458f0b.mintlify.app/pt-BR/ai-agents/activate-deactivate-agent Aprenda quando e como ativar ou desativar um agente de IA do BluBash, entenda o que acontece com as conversas em andamento e gerencie múltiplos agentes de forma eficaz. Depois de criar, treinar e testar seu agente de IA, você pode ativá-lo para começar a atender clientes automaticamente. Você também pode desativá-lo a qualquer momento — para manutenção, atualizações ou melhorias — sem perder nenhum treinamento ou configuração. ## Quando ativar um agente Ative seu agente quando: * Você tiver concluído o treinamento essencial * Você tiver configurado as habilidades necessárias * Os testes tiverem produzido resultados satisfatórios * Você tiver validado o comportamento e o tom do agente ## Quando desativar um agente Desative seu agente quando: * Você precisar fazer ajustes ou melhorias * Você estiver executando manutenção ou atualizações * Você tiver identificado problemas no comportamento do agente em produção * Você quiser executar testes A/B temporários com diferentes configurações ## Como ativar um agente Na barra lateral esquerda, clique em **Agentes de IA**. Clique no agente que você quer ativar. Na página de detalhes do agente, encontre o interruptor **Ativo** e ligue-o. Certifique-se de que o agente foi treinado e testado a fundo antes de ativá-lo. Um agente mal configurado pode afetar negativamente a experiência do cliente. ## Como desativar um agente Na barra lateral esquerda, clique em **Agentes de IA**. Clique no agente que você quer desativar. Na página de detalhes do agente, encontre o interruptor **Ativo** e desligue-o. O agente imediatamente para de aceitar novas conversas. Quando você desativa um agente: * O agente para de cuidar de **novas** conversas imediatamente. * As conversas já em andamento com o agente **não são afetadas**. * O agente pode ser reativado a qualquer momento. * Todo o treinamento e configuração **são preservados**. ## Como um agente ativo lida com conversas ### Atribuição automática Quando um agente está ativo, novas conversas podem ser encaminhadas automaticamente para ele com base na configuração de roteamento da sua equipe. O agente começa a responder imediatamente após ser atribuído. ### Transferência manual Um agente humano pode transferir qualquer conversa para o agente de IA a qualquer momento. Isso é útil quando o agente identifica que a IA pode resolver a solicitação do cliente de forma mais eficiente. ## Indicadores visuais Quando um agente de IA está cuidando ativamente de uma conversa, a interface mostra: * **Ícone de IA** — Visível no cabeçalho da conversa * **Nome do agente** — Identifica qual agente está respondendo * **Status ativo** — Confirma que o agente está em produção naquela conversa ## Gerenciando múltiplos agentes Se você tiver mais de um agente, é possível: * **Ativar múltiplos agentes ao mesmo tempo** — Cada um cuida da sua especialidade. * **Desativar temporariamente** — Pause um agente sem perder sua configuração. * **Alternar entre agentes** — Ative e desative conforme suas necessidades operacionais mudarem. * **Testar em paralelo** — Compare o desempenho de diferentes agentes antes de se comprometer com um. ## Boas práticas 1. **Ative gradualmente** — Comece com um agente por vez. Monitore seu desempenho antes de ativar outros. 2. **Monitore após a ativação** — Acompanhe de perto as primeiras conversas, verifique se as respostas estão corretas e esteja pronto para intervir se necessário. 3. **Mantenha apoio humano** — Sempre tenha agentes humanos disponíveis. Configure transferências baseadas em habilidades para casos complexos e evite depender totalmente da IA nas fases iniciais. 4. **Desative para manutenção** — Ao fazer alterações significativas, desative o agente primeiro, teste suas mudanças e reative só depois de validá-las. 5. **Documente as mudanças** — Mantenha um registro de quando o agente foi ativado ou desativado e anote os motivos de quaisquer alterações. ## Observações importantes * Agentes inativos não aparecem como opções ao iniciar uma transferência. * Você pode ter vários agentes ativos simultaneamente. * A ativação e a desativação têm efeito instantâneo. * Não há limite para quantas vezes você pode ativar ou desativar um agente. * Agentes desativados mantêm todos os treinamentos, habilidades e configurações. Considere ativar seu agente inicialmente apenas em horários de menor movimento ou para tipos específicos de conversa. Isso permite validar o desempenho de forma controlada antes de uma implantação completa. # Configurar o comportamento e as configurações do agente de IA Source: https://blubash-04458f0b.mintlify.app/pt-BR/ai-agents/configure-agent-settings Personalize o estilo de interação, o fuso horário e as restrições de tópicos do seu agente de IA do BluBash para atender às necessidades do seu negócio e garantir experiências consistentes para os clientes. A aba Configurações permite ajustar finamente como seu agente de IA se comporta durante as conversas. De dividir respostas longas em mensagens mais curtas a restringir os tópicos que o agente pode discutir, essas opções dão a você controle preciso sobre a experiência do cliente que seu agente entrega. ## Como acessar as configurações Na barra lateral esquerda, clique em **Agentes de IA**. Clique no agente que você quer configurar. Clique na aba **Configurações** no topo da página. ## Configurações de interação ### Dividir respostas Quando ativado, o agente divide respostas longas em várias mensagens mais curtas. **Benefícios:** * As mensagens parecem mais naturais e conversacionais * Mais fáceis de ler no WhatsApp * Evita o envio de blocos de texto excessivamente longos e densos **Quando usar:** Esta configuração é recomendada para a maioria dos casos, especialmente quando o agente fornece respostas detalhadas. *** ### Usar emojis Permite que o agente inclua emojis em suas respostas para torná-las mais amigáveis e expressivas. **Benefícios:** * Comunicação mais humanizada * Mensagens mais leves e acessíveis * Conexão emocional mais forte com os clientes **Quando usar:** Recomendado quando o tom do agente está configurado como Normal ou Casual. Evite esta configuração para tons Formais ou corporativos. *** ### Fuso horário Define o fuso horário que o agente usa para referências de data e hora. **Quando configurar:** Defina como o fuso horário local da sua empresa, especialmente se o agente discute agendamentos, horário comercial ou informações sensíveis ao tempo. ## Configurações avançadas ### Restringir tópicos Limita o agente a responder apenas a perguntas relacionadas ao seu negócio. **Benefícios:** * Impede que o agente responda a perguntas fora do tópico * Mantém a conversa focada no atendimento ao cliente * Reduz o risco de respostas inadequadas ou irrelevantes **Exemplo:** * **Com restrição:** O agente responde apenas a perguntas sobre seus produtos e serviços. * **Sem restrição:** O agente pode conversar sobre qualquer assunto. **Quando usar:** Recomendado para agentes especializados e para qualquer cenário em que manter um foco profissional e alinhado à marca seja importante. ## Salvando suas configurações Verifique se todas as configurações estão definidas como pretendido. Suas alterações serão aplicadas imediatamente. As alterações de configuração têm efeito imediato e afetam o comportamento do agente em produção. Se o agente estiver ativo no momento, teste suas alterações antes de aplicá-las em um ambiente de produção. ## Observações importantes * Você pode atualizar as configurações a qualquer momento sem perder outras configurações. * Após fazer alterações significativas, teste o agente para confirmar que o comportamento está conforme o esperado. * Equilibre automação com qualidade — revise periodicamente as configurações com base no feedback dos clientes e no desempenho das conversas. # Configurar habilidades e ações do agente de IA Source: https://blubash-04458f0b.mintlify.app/pt-BR/ai-agents/configure-skills Configure habilidades para que seu agente de IA do BluBash possa adicionar tags, criar notas, transferir conversas e chamar sistemas externos automaticamente. As habilidades definem as ações que seu agente de IA pode executar automaticamente durante as conversas. Em vez de simplesmente responder a mensagens, um agente com habilidades bem configuradas pode transferir conversas para a equipe certa, marcar contatos com tags, registrar notas para sua equipe e até chamar APIs externas — tudo sem intervenção manual. ## O que as habilidades permitem * **Automação de tarefas** — O agente executa ações sem intervenção humana. * **Organização** — Tags e notas mantêm as conversas categorizadas e documentadas. * **Roteamento inteligente** — Transferências automáticas enviam os clientes para a equipe certa. * **Integrações** — Requisições HTTP conectam o agente a sistemas externos. * **Eficiência** — Reduz a carga de trabalho manual da sua equipe. ## Como acessar as habilidades Na barra lateral esquerda, clique em **Agentes de IA**. Clique no agente que você quer configurar. Clique na aba **Habilidades** no topo da página. Clique em **Adicionar primeira habilidade** ou **Adicionar habilidade**. ## Tipos de habilidade disponíveis ### Adicionar Nota Cria uma nota interna na conversa com informações relevantes. **Quando usar:** * Registrar detalhes importantes sobre o cliente * Documentar solicitações específicas * Deixar observações para a equipe humana **Como configurar:** Escolha **Adicionar Nota** na lista de tipos de habilidade. Insira um nome descritivo. Exemplo: *"Registrar interesse no plano Premium"* Descreva a condição que dispara esta habilidade. Exemplo: *"Quando o cliente demonstra interesse no plano Premium"* Informe o que será registrado na nota. Exemplo: *"Cliente interessado no plano Premium. Solicitou mais detalhes sobre os recursos."* Clique em **Salvar**. *** ### Adicionar Tag Aplica uma tag à conversa para organização e filtragem. **Quando usar:** * Categorizar o tipo de solicitação * Marcar interesse em produtos específicos * Identificar nível de prioridade * Segmentar clientes **Como configurar:** Escolha **Adicionar Tag** na lista de tipos de habilidade. Insira um nome descritivo. Exemplo: *"Marcar como Lead Qualificado"* Descreva a condição de gatilho. Exemplo: *"Quando o cliente fornece informações de contato e demonstra interesse genuíno"* Escolha qual tag aplicar entre as opções disponíveis. Clique em **Salvar**. Crie tags específicas para ações disparadas pela IA antes de configurar esta habilidade. Exemplos: "IA - Lead Qualificado", "IA - Suporte Técnico", "IA - Consulta de Preço". *** ### Remover Tag Remove uma tag específica da conversa. **Quando usar:** * Atualizar o status da conversa * Remover marcadores temporários * Corrigir categorizações erradas **Como configurar:** Escolha **Remover Tag** na lista de tipos de habilidade. Insira um nome descritivo. Descreva a condição de gatilho. Escolha qual tag deve ser removida. Clique em **Salvar**. *** ### Transferir para Equipe Transfere a conversa para uma equipe humana específica. **Quando usar:** * Encaminhar para uma equipe especializada * Escalar para suporte técnico * Encaminhar para vendas * Repassar para um agente humano **Como configurar:** Escolha **Transferir para Equipe** na lista de tipos de habilidade. Insira um nome descritivo. Exemplo: *"Transferir para equipe de vendas"* Descreva a condição de gatilho. Exemplo: *"Quando o cliente pergunta sobre preços ou quer fechar negócio"* Escolha qual equipe deve receber a transferência. Explique o motivo da transferência, se necessário. Clique em **Salvar**. Após uma transferência para uma equipe humana, o agente de IA para de responder e a equipe assume a conversa. *** ### Transferir para Agente de IA Transfere a conversa para um agente de IA diferente. **Quando usar:** * Encaminhar para um agente especializado * Migrar de um agente de triagem para um agente de atendimento específico * Escalar para um agente mais avançado **Como configurar:** Escolha **Transferir para Agente de IA** na lista de tipos de habilidade. Insira um nome descritivo. Descreva a condição de gatilho. Escolha qual agente de IA deve receber a transferência. Clique em **Salvar**. *** ### Requisição HTTP Integra com sistemas externos por meio de chamadas de API. **Quando usar:** * Consultar informações em um sistema externo * Criar registros em um CRM * Enviar notificações * Integrar com plataformas de terceiros **Como configurar:** Escolha **Requisição HTTP** na lista de tipos de habilidade. Insira um nome descritivo. Descreva a condição de gatilho. Forneça o endereço do endpoint da API. Selecione GET, POST, PUT ou DELETE. Inclua quaisquer cabeçalhos necessários para a requisição. Para requisições POST ou PUT, informe o corpo da requisição. Clique em **Salvar**. Esta habilidade requer conhecimento técnico de APIs. Certifique-se de ter as credenciais e a documentação da API que você quer integrar antes de configurá-la. ## Boas práticas 1. **Seja específico nas condições** — Defina claramente quando cada habilidade deve ser disparada. Use exemplos concretos e evite descrições ambíguas. 2. **Use nomes descritivos** — Nomes que explicam o que a habilidade faz facilitam muito a manutenção futura. 3. **Teste antes de ativar** — Use o recurso de teste do agente para confirmar que as habilidades são disparadas corretamente e ajustar condições se necessário. 4. **Combine habilidades** — Um agente pode ter várias habilidades. Elas podem ser executadas em sequência — por exemplo, adicionar uma tag e depois transferir para uma equipe. 5. **Mantenha as habilidades organizadas** — Revise periodicamente e documente o propósito de cada habilidade. ## Gerenciando habilidades **Editar uma habilidade:** 1. Encontre a habilidade na lista. 2. Clique no ícone de edição. 3. Faça suas alterações. 4. Clique em **Salvar**. **Excluir uma habilidade:** 1. Encontre a habilidade na lista. 2. Clique no ícone da lixeira. 3. Confirme a exclusão. **Ativar ou desativar uma habilidade:** Use o interruptor ao lado da habilidade para ativá-la ou desativá-la temporariamente sem excluí-la. ## Observações importantes * As habilidades são executadas automaticamente sempre que suas condições de gatilho são atendidas. * Um agente pode ter quantas habilidades você precisar. * As habilidades são executadas na ordem em que foram criadas. * Você pode testar as habilidades usando o recurso de teste do agente. * Habilidades mal configuradas podem causar comportamentos inesperados — sempre teste antes de ativar o agente. # Crie seu primeiro agente de IA no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/ai-agents/create-ai-agent Aprenda a criar um agente de IA no BluBash passo a passo, desde definir o perfil e o propósito do agente até revisar e finalizar a configuração. Criar um agente de IA no BluBash é simples. Uma configuração guiada conduz você por todas as informações obrigatórias em poucos passos, para que você tenha um agente totalmente configurado pronto para treinar e implantar em minutos. ## Antes de começar Navegue até **Agentes de IA** na barra lateral esquerda e clique em **Criar agente** no canto superior direito da tela. ## Etapa 1 — Perfil do agente No primeiro passo, você define a identidade e o comportamento básico do agente. Digite o nome que o agente usará ao se apresentar para os clientes. Exemplo: *"Ana - Suporte BluBash"* Selecione a função principal do agente: * **Vendas** — Qualificação de leads e fechamento de negócios * **Suporte** — Resolução de problemas técnicos * **Atendimento ao cliente** — Assistência geral e roteamento * **Geração de leads** — Captura de clientes em potencial Escolha o estilo de comunicação que o agente deve usar: * **Formal** — Linguagem profissional e corporativa * **Normal** — Um equilíbrio entre formal e casual * **Casual** — Linguagem leve e amigável Escreva uma descrição de como o agente deve agir nas conversas. Exemplo: *"Seja cordial e empático. Faça perguntas para entender as necessidades do cliente e direcione-o para a equipe correta."* Prossiga para o passo de informações da empresa. ## Etapa 2 — Informações da empresa Forneça detalhes sobre sua empresa para que o agente entenda o contexto do negócio. Digite o nome da sua empresa. Adicione uma descrição detalhada do seu negócio, produtos e serviços. Exemplo: *"Empresa de tecnologia especializada em soluções de atendimento ao cliente via WhatsApp, Instagram e outros canais."* Prossiga para o passo de revisão. ## Etapa 3 — Revisar e criar Revise todas as informações configuradas antes de criar o agente. Confira o nome, o propósito e o tom selecionados. Certifique-se de que o nome e a descrição da empresa estão corretos. O agente será criado e você será redirecionado para a página de detalhes dele. A partir da página de detalhes, você pode adicionar treinamento, configurar habilidades e ajustar as configurações antes de ativar o agente. ## Próximos passos recomendados Depois de criar seu agente, conclua os itens a seguir antes de ativá-lo: 1. **Adicionar treinamento** — Ensine o agente com informações específicas do seu negócio. 2. **Configurar habilidades** — Defina ações que o agente pode executar automaticamente. 3. **Ajustar configurações** — Personalize comportamentos como uso de emojis, divisão de respostas e restrição de tópicos. 4. **Testar o agente** — Simule conversas para validar o comportamento. Um agente recém-criado está **inativo** por padrão. Você precisa ativá-lo manualmente após concluir o treinamento e a configuração. # Transferir conversas para um agente de IA Source: https://blubash-04458f0b.mintlify.app/pt-BR/ai-agents/handoff-to-ai Aprenda a repassar uma conversa de um agente humano para um agente de IA do BluBash, monitorar as respostas da IA e retomar a conversa quando necessário. Repassar uma conversa para um agente de IA significa transferi-la de um agente humano para que a IA assuma e continue a interação automaticamente. Isso é útil quando você identifica que a IA pode resolver a solicitação do cliente, liberando sua equipe para focar em casos mais complexos que exigem julgamento humano. ## Quando repassar para um agente de IA Use a transferência para IA quando a conversa envolve: * **Perguntas simples** — Detalhes de produtos, preços, horário comercial * **Informações básicas** — Dados que o agente está treinado para fornecer * **Processos padronizados** — Solicitações que seguem um fluxo definido * **Qualificação de leads** — Coleta inicial de informações * **Perguntas frequentes** — Tópicos que a IA cuida de forma confiável ## Quando não repassar para um agente de IA Mantenha a conversa com um humano quando a situação envolve: * **Casos complexos** — Situações que requerem julgamento ou nuance humana * **Clientes insatisfeitos** — Reclamações que precisam de empatia humana * **Negociações** — Fechamento de negócios ou acordos * **Situações sensíveis** — Questões delicadas ou urgentes * **Preferência do cliente** — Quando o cliente pede especificamente um humano ## Como transferir uma conversa para um agente de IA Acesse a conversa que você quer transferir para a IA. No cabeçalho da conversa, clique no **ícone do robô** ou no botão **Transferir para IA**. Escolha qual agente de IA deve assumir a conversa. Você pode anotar o motivo da transferência para contexto interno. Exemplo: *"Cliente quer informações sobre preços e planos"* Clique em **Transferir para IA** para concluir o repasse. Após a transferência: * O agente de IA assume a conversa imediatamente. * Você não conseguirá mais enviar mensagens, a menos que retome a conversa. * O agente começa a responder automaticamente. * A conversa é marcada com um indicador ativo de IA. ## O que você vê quando a IA está ativa Quando um agente de IA está cuidando de uma conversa, a interface do chat mostra: * **Ícone de robô** — Exibido no cabeçalho da conversa * **Nome do agente** — Identifica qual agente de IA está respondendo * **Mensagens da IA** — Aparecem como mensagens do agente * **Ações registradas** — Quaisquer habilidades que o agente executa ficam registradas na conversa ## Monitorar uma conversa conduzida pela IA Mesmo após repassar, você pode permanecer informado: * **Ver a conversa** — Acompanhe em tempo real na lista de conversas. * **Ler as mensagens** — Veja exatamente o que a IA está dizendo ao cliente. * **Monitorar ações** — Acompanhe as habilidades sendo executadas conforme a conversa avança. * **Intervir a qualquer momento** — Retome a conversa sempre que necessário. ## Como retomar uma conversa (hand on) Se você precisar retomar uma conversa que a IA está conduzindo: Acesse a conversa atualmente conduzida pela IA. Na área de composição de mensagens, na parte inferior, clique no botão **Assumir conversa**. Anote por que você está retomando a conversa, se necessário. A IA para de responder e você assume imediatamente. ## Observações importantes * Apenas agentes **ativos** aparecem como opções ao iniciar uma transferência. * Você pode repassar para diferentes agentes especializados dependendo do contexto. * A transferência é instantânea — a IA responde imediatamente após o repasse. * Todas as mensagens e ações realizadas pela IA ficam registradas no histórico da conversa. * Você pode retomar a conversa a qualquer momento. * Repassar não fecha nem encerra a conversa — apenas muda quem está conduzindo. Use a transferência para IA de forma estratégica. Isso permite que você foque em casos complexos e de alto valor enquanto a IA cuida de solicitações rotineiras — aumentando a eficiência geral da sua equipe sem sacrificar a experiência do cliente. # Teste seu agente de IA antes de colocá-lo no ar Source: https://blubash-04458f0b.mintlify.app/pt-BR/ai-agents/test-ai-agent Simule conversas reais com clientes para validar as respostas do seu agente de IA do BluBash, verificar a execução de habilidades e detectar problemas antes de o agente entrar em produção. Testar seu agente de IA antes de ativá-lo é um passo essencial. O ambiente de teste permite simular conversas reais com clientes, verificar se as habilidades disparam corretamente e detectar quaisquer problemas antes que afetem seus clientes reais. Você pode testar quantas vezes quiser — as conversas de teste não aparecem no seu histórico e não têm impacto nos dados em produção. ## Por que testar é importante * **Validar o treinamento** — Confirme que o agente aprendeu as informações certas. * **Testar habilidades** — Verifique se as ações automáticas são executadas conforme configurado. * **Detectar problemas cedo** — Encontre falhas antes que cheguem aos clientes reais. * **Refinar o comportamento** — Ajuste respostas, tom e condições das habilidades. * **Garantir qualidade** — Entregue uma ótima experiência desde a primeira interação real. ## Como abrir a janela de teste Na barra lateral esquerda, clique em **Agentes de IA**. Clique no agente que você quer testar. Clique no botão **Testar agente** no canto superior direito da tela. Uma janela de chat será aberta onde você pode enviar mensagens e receber as respostas do agente em tempo real. ## Como fazer um teste minucioso ### 1. Simule mensagens reais de clientes Digite mensagens como se você fosse um cliente real entrando em contato com seu negócio. Comece com as perguntas mais comuns que sua equipe atende. **Exemplos de mensagens para testar:** ``` Oi, gostaria de saber mais sobre seus produtos ``` ``` Quanto custa o plano premium? ``` ``` Preciso de ajuda com o meu pedido ``` ``` Quero falar com um atendente humano ``` *** ### 2. Avalie as respostas Analise cada resposta que o agente dá: * A resposta é precisa e relevante? * O tom corresponde ao estilo configurado? * A informação está atualizada e correta? * A resposta é clara e fácil de entender? * O agente é educado e profissional? *** ### 3. Verifique se as habilidades são disparadas Cheque se as habilidades configuradas são executadas corretamente durante o teste. **Como identificar a execução de uma habilidade:** Quando uma habilidade é executada, ela aparece como uma **caixa azul** no chat. A caixa mostra qual ação foi realizada. Essas caixas só são visíveis para você na visão de teste — seus clientes não as verão. **Habilidades para verificar:** * **Transferências** — Envie uma mensagem como *"Quero falar com vendas"* e confirme que o agente direciona para a equipe correta. * **Tags** — Diga algo como *"Tenho interesse no plano premium"* e verifique se a tag é aplicada. * **Notas** — Forneça informações relevantes do cliente e verifique se uma nota é criada com o conteúdo correto. *** ### 4. Teste cenários específicos Trabalhe diferentes situações que podem ocorrer em conversas reais. **Cenário 1: pergunta simples** ``` Cliente: Qual é o horário de atendimento? Esperado: o agente responde com o horário correto ``` **Cenário 2: intenção de compra** ``` Cliente: Quero comprar o plano premium Esperado: o agente qualifica o lead e transfere para a equipe de vendas ``` **Cenário 3: cliente com problema** ``` Cliente: Meu produto não está funcionando Esperado: o agente coleta informações relevantes e transfere para o suporte ``` **Cenário 4: pedido por um agente humano** ``` Cliente: Quero falar com uma pessoa Esperado: o agente transfere imediatamente ``` **Cenário 5: pergunta fora de escopo** ``` Cliente: Como está o tempo hoje? Esperado: o agente redireciona a conversa para tópicos relevantes ``` ## O que observar ### Qualidade das respostas | Critério | O que verificar | | -------------- | --------------------------------------- | | **Precisão** | Os fatos estão corretos? | | **Relevância** | A resposta aborda o que foi perguntado? | | **Completude** | A resposta é suficientemente detalhada? | | **Clareza** | É fácil de entender? | ### Comportamento do agente | Critério | O que verificar | | -------------------- | ----------------------------------------- | | **Tom** | Corresponde ao estilo configurado? | | **Empatia** | O agente reconhece a situação do cliente? | | **Profissionalismo** | Mantém uma postura adequada? | | **Naturalidade** | As respostas parecem humanas? | ## Corrigindo problemas encontrados nos testes Se você identificar um problema, volte para a aba apropriada e faça ajustes antes de testar novamente. Vá para a aba **Treinamento** e adicione a informação que faltava ao agente. Vá para a aba **Habilidades**, ajuste as condições de gatilho e corrija quaisquer ações que não funcionaram como esperado. Vá para a aba **Configurações** e ajuste tom, uso de emojis, divisão de respostas ou restrição de tópicos. Vá para a aba **Perfil** para refinar a descrição do comportamento ou o propósito do agente. Repita o teste após cada ajuste. Continue refinando até que os resultados sejam satisfatórios. Um agente bem testado entrega uma melhor experiência ao cliente e reduz a necessidade de intervenções humanas. Invista tempo no teste antes de ativar — vale a pena rapidamente. # Treine seu agente de IA com conhecimento personalizado Source: https://blubash-04458f0b.mintlify.app/pt-BR/ai-agents/train-ai-agent Aprenda a treinar seu agente de IA do BluBash usando texto, documentos e links da web para que ele responda às perguntas com precisão, com base nas informações do seu negócio. O treinamento é o passo mais importante para que seu agente de IA tenha um desempenho eficaz. Por meio do treinamento, você ensina o agente sobre o seu negócio, produtos, serviços e como interagir com seus clientes. Quanto mais minucioso e específico for o treinamento, mais precisas e úteis serão as respostas do agente. ## Por que o treinamento é importante * **Conhecimento específico do negócio** — O agente aprende sobre sua empresa e o que você oferece. * **Respostas precisas** — Um treinamento melhor leva a respostas mais confiáveis. * **Contexto adequado** — O agente entende o escopo do seu negócio. * **Menos erros** — Reduz a chance de respostas incorretas ou irrelevantes. ## Como acessar o treinamento Na barra lateral esquerda, clique em **Agentes de IA**. Clique no agente que você quer treinar. Clique na aba **Treinamento** no topo da página. ## Métodos de treinamento ### Treinamento por texto Adicione instruções e informações em formato de texto simples. Esta opção é ideal para orientações concisas e específicas. **Quando usar treinamento por texto:** * Instruções comportamentais * Informações curtas e objetivas * Diretrizes de atendimento ao cliente * Respostas a perguntas frequentes **Como adicionar treinamento por texto:** Selecione a aba **Texto** na seção de treinamento. Digite o conteúdo do treinamento no campo de texto. Clique em **Adicionar treinamento** para salvar. **Exemplos:** ``` Comece toda conversa se apresentando e perguntando como pode ajudar o cliente. ``` ``` Quando um cliente perguntar sobre preços, informe que nossos planos começam em R$ 99/mês. ``` ``` Se um cliente pedir para falar com um humano, transfira-o imediatamente para a equipe de suporte. ``` Use frases curtas e objetivas. Evite redundâncias, seja específico nas instruções e use exemplos práticos sempre que possível. *** ### Treinamento por documento Faça upload de arquivos com informações detalhadas sobre sua empresa. Ideal para conteúdos mais longos e estruturados. **Quando usar treinamento por documento:** * Manuais de produtos * Políticas da empresa * Catálogos * Documentação técnica * FAQs extensos **Formatos aceitos:** * PDF (`.pdf`) * Word (`.doc`, `.docx`) * Texto simples (`.txt`) * Markdown (`.md`) * Planilhas (`.xlsx`, `.csv`) **Como adicionar treinamento por documento:** Selecione a aba **Documento** na seção de treinamento. Clique em **Selecionar documento** e escolha o arquivo no seu computador. O documento será processado automaticamente. O tempo de processamento depende do tamanho do arquivo. O processamento de documentos pode levar alguns minutos para arquivos maiores. Você receberá uma notificação quando o treinamento estiver concluído. *** ### Treinamento pela web Adicione URLs do seu site para que o agente possa aprender com seu conteúdo publicado. **Quando usar treinamento pela web:** * Páginas de produtos * Posts de blog * Páginas "Sobre" * Centrais de ajuda * Landing pages **Como adicionar treinamento pela web:** Selecione a aba **Web** na seção de treinamento. Informe a URL da página no campo correspondente. Clique em **Adicionar treinamento** para salvar. Certifique-se de que as páginas que você está vinculando são acessíveis publicamente. Páginas protegidas por login não podem ser processadas. ## Gerenciando suas entradas de treinamento **Visualizar entradas de treinamento:** Todos os itens de treinamento adicionados aparecem em listas organizadas por tipo. Cada entrada mostra seu status atual: Processando, Treinado ou Falhou. **Excluir uma entrada de treinamento:** 1. Encontre a entrada na lista. 2. Clique no ícone da lixeira. 3. Confirme a exclusão. Excluir uma entrada de treinamento é permanente e pode afetar a base de conhecimento do agente. Tenha certeza de que quer removê-la antes de confirmar. ## Boas práticas 1. **Comece pelo básico** — Adicione informações centrais da empresa, principais produtos e serviços e dados de contato ou horário de atendimento. 2. **Seja específico** — Use exemplos concretos, descrições detalhadas e evite ambiguidades. 3. **Mantenha tudo atualizado** — Adicione novos produtos e serviços conforme eles forem lançados, atualize preços e promoções e remova informações desatualizadas. 4. **Teste após cada adição** — Execute o teste do agente depois de adicionar novos treinamentos para verificar se as respostas estão corretas. 5. **Organize por tópico** — Use documentos para conteúdo longo e entradas de texto para instruções rápidas. ## Observações importantes * O agente aprende com **todas** as entradas de treinamento fornecidas. * Treinamentos adicionados mais recentemente têm prioridade sobre entradas mais antigas. * O processamento de documentos e links pode levar alguns minutos. * Não há limite para quantas entradas de treinamento você pode adicionar. * Recomenda-se testar o agente após cada nova adição de treinamento. # O que são agentes de IA no BluBash? Source: https://blubash-04458f0b.mintlify.app/pt-BR/ai-agents/what-are-ai-agents Os agentes de IA no BluBash são assistentes virtuais que automatizam o atendimento ao cliente no WhatsApp, respondendo perguntas e executando ações 24 horas por dia. Os agentes de IA no BluBash são assistentes virtuais inteligentes movidos por inteligência artificial avançada. Eles entendem as mensagens recebidas, respondem a perguntas, executam ações automatizadas e oferecem uma experiência personalizada ao cliente — tudo sem exigir intervenção humana. ## O que os agentes de IA podem fazer por você Respondem aos clientes a qualquer hora, mesmo fora do horário comercial. Cuidam de solicitações rotineiras automaticamente, liberando sua equipe para casos complexos. Fornecem respostas imediatas sobre produtos, serviços e perguntas frequentes. Identificam e qualificam clientes em potencial automaticamente durante a conversa. Adicionam tags, criam notas, transferem conversas e muito mais — sem esforço manual. Adaptam-se ao estilo e à voz de comunicação da sua empresa. ## Como funcionam os agentes de IA Os agentes de IA no BluBash operam por meio de três etapas principais: 1. **Treinamento** — Você fornece informações sobre sua empresa, produtos e serviços por meio de textos, documentos e links. 2. **Configuração** — Você define o comportamento, o tom e as habilidades do agente. 3. **Atendimento** — O agente interage com os clientes automaticamente, executando as ações configuradas. ## Principais recursos * **Treinamento personalizado** — Ensine o agente com dados específicos do seu negócio. * **Habilidades configuráveis** — Configure ações automáticas como transferências, tags e notas. * **Transferência inteligente** — Encaminhe conversas automaticamente para um agente humano quando necessário. * **Múltiplos agentes** — Crie agentes separados para vendas, suporte, atendimento ao cliente e muito mais. * **Testes antes do lançamento** — Simule conversas para validar o comportamento do agente antes de colocá-lo em produção. ## Propósitos de agente disponíveis Você pode configurar cada agente para um propósito específico: | Propósito | Caso de uso | | -------------------------- | ------------------------------------------------------------------------ | | **Vendas** | Qualificação de leads, apresentação de produtos e fechamento de negócios | | **Suporte** | Resolução de problemas técnicos e dúvidas sobre produtos | | **Atendimento ao cliente** | Assistência geral e roteamento para equipes específicas | | **Geração de leads** | Captura e qualificação de clientes em potencial | Quanto mais minucioso e específico for o treinamento, mais precisas e úteis serão as respostas do agente. Você pode executar vários agentes em paralelo, cada um com sua especialidade. * Os agentes podem pedir assistência humana quando não sabem como responder algo. * Todas as conversas dos agentes de IA são salvas no histórico de conversas. * Você pode ativar ou desativar agentes a qualquer momento. # Campanhas no WhatsApp: envie mensagens em massa no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/campaigns/campaigns-introduction Aprenda o que são as campanhas no BluBash, quando usá-las e qual tipo de conexão com o WhatsApp é mais indicado para envios em massa seguros e em alto volume. As campanhas no BluBash permitem enviar mensagens em massa para grupos de contatos de uma vez só. Você pode usá-las para divulgar produtos, compartilhar avisos, enviar lembretes ou transmitir qualquer outra informação para seu público — tudo dentro da plataforma. Se você está usando uma conexão **WhatsApp Lite**, fazer envios em massa grandes **não é recomendado**. Envios em alto volume no WhatsApp Lite trazem risco significativo de suspensão do canal ou banimento permanente. Para envios de campanha seguros e confiáveis, use uma conexão **API do WhatsApp Business**. ## Para que você pode usar campanhas As campanhas são adequadas para qualquer situação em que você precise alcançar muitos contatos com a mesma mensagem, incluindo: * Lançamentos e promoções de produtos * Atualizações e avisos sobre serviços * Lembretes de compromissos ou eventos * Comunicações gerais para sua base de clientes ## Próximos passos Siga um guia passo a passo para montar e enviar sua primeira campanha. Aprenda a visualizar, filtrar e acompanhar o desempenho das suas campanhas. # Criar uma campanha de envio em massa no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/campaigns/create-campaign Guia passo a passo para criar, configurar e disparar uma campanha de envio em massa no BluBash, incluindo agendamento e filtragem de público. Criar uma campanha no BluBash leva você por uma configuração guiada onde você define os detalhes da campanha, escolhe um canal de envio, seleciona o público e compõe a mensagem. Você pode enviar imediatamente ou agendar para uma data e hora futuras. Na barra lateral esquerda, clique em **Campanhas**. Na tela de Campanhas, clique no botão **Nova campanha**. Preencha as informações básicas da sua campanha: * **Nome** — Como sua campanha será identificada na plataforma. * **Descrição** — O objetivo da sua campanha. Este campo é opcional. * **Velocidade de envio** — Quantas mensagens podem ser enviadas por minuto. * **Enviar agora ou agendar** — Escolha **Enviar agora** para iniciar a campanha assim que você concluir o assistente de configuração, ou escolha **Agendar** para definir uma data e hora específicas para alcançar seu público. Taxas de envio muito altas podem resultar em restrições no seu canal. Defina uma velocidade de envio adequada ao seu tipo de conexão. Selecione qual canal conectado será usado para enviar as mensagens da campanha. Se você está usando uma conexão **API do WhatsApp Business**, é necessário usar uma mensagem do tipo **Template** para garantir que todas as mensagens sejam entregues com sucesso. Use os filtros para definir os contatos-alvo da sua campanha. Uma pré-visualização do público em tempo real é exibida no lado direito da tela. * **Tags** — Filtra contatos que têm uma ou mais tags específicas atribuídas. * **Status da conversa** — Inclui contatos com conversas abertas, fechadas ou ambas. * **Última interação** — Filtra contatos com base em quando interagiram pela última vez na plataforma. * **Filtro por campo** — Filtra por campos do contato, como nome, e-mail, número de telefone ou campos personalizados que atendam a uma condição específica. Você pode combinar vários filtros para construir um público definido com mais precisão. Por exemplo, filtre por tag e última interação, ou por status da conversa e valor de um campo personalizado. Escolha e personalize o que será enviado ao seu público. **Templates e Respostas Rápidas** Use templates ou respostas rápidas já salvos na plataforma. Esta opção também permite enviar **imagens** ou **arquivos**. Você pode personalizar variáveis — como nome, número de telefone, e-mail ou campos personalizados — com as informações individuais de cada contato. **Texto simples** Escreva o texto diretamente no editor. Você pode usar variáveis como nome, número de telefone, e-mail ou campos personalizados para personalizar cada mensagem para seu destinatário. Verifique se todas as configurações estão corretas antes de iniciar. Depois de revisar os detalhes: * Clique em **Salvar e iniciar** para disparar a campanha imediatamente. * Clique em **Salvar e agendar** se você selecionou a opção de agendamento — a campanha será executada automaticamente na data e hora especificadas. Após a campanha estar em execução, você pode monitorá-la em tempo real. Veja métricas como quantas mensagens foram enviadas, entregues e lidas, além de outros detalhes de entrega. Veja [Monitorar e gerenciar suas campanhas no BluBash](/pt-BR/campaigns/manage-campaigns) para mais informações. ## Próximos passos Visualize, filtre e acompanhe o desempenho das suas campanhas. Volte para a introdução de campanhas. # Monitorar e gerenciar suas campanhas no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/campaigns/manage-campaigns Aprenda a visualizar, filtrar e acompanhar todas as suas campanhas no BluBash, incluindo métricas de desempenho como taxas de entrega e de leitura. Depois de criar campanhas no BluBash, você pode visualizá-las e gerenciá-las a partir da tela **Campanhas**. Use os filtros disponíveis para encontrar rapidamente uma campanha específica e revisar seus dados de desempenho em detalhes. ## Visualizar e filtrar campanhas A tela Campanhas lista todas as suas campanhas — incluindo rascunhos, envios agendados e concluídos. Use os filtros para refinar a lista: * **Status** — Filtra pelo estado da campanha: rascunho, agendada, em execução, concluída e outros. * **Canal** — Encontra campanhas enviadas por um canal conectado específico. * **Período** — Mostra apenas campanhas criadas dentro de um intervalo de datas selecionado. * **Ordenação** — Escolhe como ordenar os resultados na lista. ## Métricas e desempenho Cada campanha tem uma visão detalhada de desempenho onde você pode acompanhar as seguintes métricas: * Mensagens enviadas * Mensagens entregues * Mensagens lidas * Taxa de sucesso * Status de entrega de cada envio individual Verifique a visão de desempenho regularmente enquanto uma campanha estiver em execução para detectar precocemente quaisquer problemas de entrega e ajustar campanhas futuras conforme necessário. ## Próximos passos Comece a montar uma nova campanha de envio em massa. Volte para a introdução de campanhas. # Ativar ou desativar um canal de WhatsApp Source: https://blubash-04458f0b.mintlify.app/pt-BR/channels/activate-deactivate-channel Pause ou retome um canal do BluBash sem excluí-lo — útil para janelas de manutenção, indisponibilidade da equipe ou pausas operacionais. Você pode parar temporariamente um canal de receber mensagens desativando-o e, em seguida, retomá-lo quando estiver pronto. Isso é útil para manutenção programada, ausências da equipe ou qualquer situação em que você queira pausar o tráfego de entrada sem perder a configuração do canal. ## Ativar um canal * Na barra lateral esquerda, clique em **Canais**. * Clique no canal que você quer ativar. Na página de detalhes do canal, localize o interruptor que mostra o status atual. Se o canal estiver inativo, o interruptor estará na posição desligada. Clique no interruptor para ativar o canal. O status muda para **Ativo** e o canal volta imediatamente a receber mensagens. Quando um canal é ativado, ele começa a receber mensagens na hora. Certifique-se de que a equipe padrão esteja pronta para lidar com as conversas recebidas. ## Desativar um canal * Na barra lateral esquerda, clique em **Canais**. * Clique no canal que você quer desativar. Na página de detalhes do canal, clique no interruptor de status para desativar o canal. O status muda para **Inativo** e o canal para de aceitar novas mensagens. Quando você desativa um canal: * Novas mensagens de entrada não são recebidas. * As conversas existentes continuam acessíveis, mas os clientes não conseguem enviar novas mensagens por esse canal. * Os clientes podem receber um erro ou nenhuma resposta ao tentar entrar em contato com você. ## Lendo o status na lista de canais A lista de canais oferece uma visão rápida do estado de cada canal: | Status | Indicador | Significado | | ----------- | --------- | ------------------------------------------------------- | | **Ativo** | Verde | O canal está conectado e recebendo mensagens. | | **Inativo** | Cinza | O canal está pausado; nenhuma nova mensagem é recebida. | Use a desativação para pausar canais durante manutenção ou quando uma equipe estiver indisponível, em vez de excluir o canal. Isso preserva toda a configuração para que você possa reativá-lo depois sem nenhuma configuração adicional. # Configurar um canal WhatsApp Lite Source: https://blubash-04458f0b.mintlify.app/pt-BR/channels/configure-whatsapp-lite Conecte um número de WhatsApp ao BluBash escaneando um QR code. Ideal para operações pequenas ou testes, sem necessidade de credenciais da Meta. O WhatsApp Lite é o mais simples dos dois tipos de conexão de WhatsApp disponíveis no BluBash. Em vez de credenciais da API do Meta Business, ele conecta seu número de WhatsApp escaneando um QR code — o mesmo método usado para vincular o WhatsApp Web. É um bom ponto de partida para equipes pequenas ou ambientes de teste, mas lembre-se de que ele apresenta maior risco para envios em massa e pode desconectar se o telefone vinculado perder o acesso à internet. * Na barra lateral esquerda, clique em **Canais**. * Clique em **Adicionar canal**. * Selecione **WhatsApp Lite**. * **Nome do canal** — por exemplo, "WhatsApp Lite Vendas". * **Equipe padrão** — selecione a equipe que receberá as conversas deste canal. * **Agente de IA** (opcional) — escolha um agente para respostas automáticas. Depois de salvar os detalhes básicos, um QR code aparece na tela. 1. Abra o **WhatsApp** no seu celular. 2. Toque no menu de três pontos → **Aparelhos conectados** → **Conectar um aparelho**. 3. Aponte a câmera do celular para o QR code exibido no BluBash. O QR code é atualizado automaticamente a cada 30 segundos. Se ele expirar antes de você escanear, aguarde o próximo aparecer ou recarregue a página. Após um escaneamento bem-sucedido, aguarde alguns segundos. O status do canal muda de **Configuração** para **Conectado**, e o número de telefone e o nome de exibição do WhatsApp aparecem na página de detalhes do canal. Na lista de canais, o canal WhatsApp Lite conectado aparece com um indicador verde e um selo de status **Ativo**, confirmando que está pronto para receber mensagens. Se você desconectar o dispositivo do WhatsApp no seu celular, o canal voltará ao status de **Configuração**. Será necessário escanear um novo QR code para reconectar. ## Reconectar um canal desconectado Se o canal perder a conexão: 1. Clique no canal na lista de canais. 2. Se o status for **Configuração** ou **Desconectado**, uma opção de reconexão aparece. 3. Escaneie o novo QR code exibido na tela. Mantenha o WhatsApp aberto e seu celular conectado à internet para evitar desconexões frequentes. Períodos prolongados sem acesso à internet no celular vinculado farão o canal cair. # Configurar a API do WhatsApp Business (Oficial) Source: https://blubash-04458f0b.mintlify.app/pt-BR/channels/configure-whatsapp-official Conecte o BluBash à API do Meta Business para mensagens de WhatsApp em nível de produção, templates de mensagem e suporte a campanhas de alto volume. A API do WhatsApp Business (Oficial) é o método de integração aprovado pela Meta para empresas que precisam de alta confiabilidade, grandes volumes de mensagens e acesso a templates de mensagem aprovados. Diferente do WhatsApp Lite, ela não depende de um celular estar conectado — em vez disso, usa credenciais de API emitidas pela Meta. ## Pré-requisitos * Um Gerenciador de negócios meta ([Clique aqui](https://www.facebook.com/business/tools/meta-business-suite/get-started) para saber mais) - Na barra lateral esquerda, clique em **Canais**. - Clique em **Adicionar canal**. - Selecione **WhatsApp Business (Oficial)**. * **Nome do canal** — por exemplo, "WhatsApp Vendas" ou "WhatsApp Suporte". * **Equipe padrão** — selecione a equipe que receberá as conversas deste canal. * **Agente de IA** (opcional) — escolha um agente para respostas automáticas. Insira suas credenciais para acessar seu Gerenciador de Negócios Meta Após isso verifique as informações solicitadas se estão devidamente preenchidas. Nessa etapa você poderá escolher duas opções. * Conectar um app do WhatsApp Business * Criar nova conta do WhatsApp Business Selecione a opção desejada. Selecione o DDI correspondente ao seu país **(Exemplo: BR +55)** e **insira seu número de telefone** **(Exemplo: (11) 99123-4567)** Abra seu WhatsApp Business e siga esses passos: 1. Vá em Configurações 2. Conta 3. Plataforma do WhatsApp Business 4. Clique em Conectar-se à Plataforma do WhatsApp Business 5. Escaneie com seu celualr o QR Code que esta sendo exibido. Clique em Avançar. Clique em **Conectar** ou **Salvar**. O BluBash valida suas credenciais e testa a conexão. Se as credenciais estiverem corretas, o status do canal muda para **Ativo**. Na lista de canais, o canal deve aparecer como **Ativo**. Na página de detalhes do canal, você pode confirmar o número de telefone verificado e o nome de exibição da empresa. Se o canal exibir o status **Erro**, verifique se todos os valores das credenciais estão corretos e se o Access Token não expirou. Atualize o token e salve novamente, se necessário. * Configure templates de mensagem aprovados pela Meta para iniciar conversas fora da janela de mensagens de 24 horas. * Envie uma mensagem de teste de um número pessoal para o número de WhatsApp Business conectado. * Confirme que as mensagens recebidas aparecem corretamente no BluBash. Se tiver qualquer dificuldade neste processo, entre em contato com o nosso suporte BluBash. # Criar um canal de WhatsApp no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/channels/create-channel Aprenda a adicionar um novo canal de WhatsApp ao seu workspace BluBash, escolher um tipo de conexão e rotear as conversas para a equipe certa. Os canais são as conexões de comunicação que trazem as conversas dos clientes para o BluBash. Ao criar um canal, você escolhe um tipo de conexão de WhatsApp, dá um nome ao canal, atribui uma equipe e, opcionalmente, anexa um agente de IA para responder automaticamente. ## Pré-requisitos Antes de começar, decida qual tipo de conexão se encaixa no seu caso de uso: * **WhatsApp Lite** — conecta via escaneamento de QR code. Mais simples de configurar, mas não recomendado para envios em alto volume ou em massa. * **API do WhatsApp Business (Oficial)** — integração aprovada pela Meta. Necessária para templates de mensagem, campanhas e confiabilidade em nível de produção. Você precisará de credenciais do Meta Business Manager. Na barra lateral esquerda, clique em **Canais**. Você verá uma lista de todos os canais já configurados no seu workspace. No canto superior direito, clique em **Adicionar canal**. Uma caixa de diálogo abre com os tipos de canal disponíveis. Selecione uma das seguintes opções: * **WhatsApp Business (Oficial)** — para integração com a API do Meta Business. * **WhatsApp Lite** — para configuração rápida via QR code. Cada tipo de canal tem requisitos diferentes. O WhatsApp Business (Oficial) requer credenciais da Meta, enquanto o WhatsApp Lite usa um QR code para conectar. Complete o formulário de configuração do canal: * **Nome do canal** — escolha um identificador descritivo, por exemplo, "WhatsApp Vendas" ou "WhatsApp Suporte". * **Equipe padrão** — selecione a equipe que receberá as conversas deste canal. * **Agente de IA** (opcional) — escolha um agente de IA para responder automaticamente ou deixe como "Nenhum" para tratamento manual. O campo **Equipe padrão** é obrigatório. Todas as conversas deste canal serão inicialmente direcionadas para essa equipe. Dependendo do tipo selecionado: * **WhatsApp Business (Oficial)** — insira suas credenciais da Meta: Phone Number ID, WABA ID, Business ID e Access Token. Veja [Configurar a API do WhatsApp Business (Oficial)](/pt-BR/channels/configure-whatsapp-official) para detalhes. * **WhatsApp Lite** — escaneie o QR code exibido na tela. Veja [Configurar um canal WhatsApp Lite](/pt-BR/channels/configure-whatsapp-lite) para detalhes. Após concluir a configuração, o canal é criado. O status será **Ativo** (para canais Oficiais com credenciais válidas) ou **Configuração** (para canais Lite aguardando o escaneamento do QR code). Você é redirecionado para a página de detalhes do canal. Após criar o canal, você pode editar o nome, a equipe padrão e o agente de IA a qualquer momento na página de detalhes do canal. # Excluir um canal do seu workspace Source: https://blubash-04458f0b.mintlify.app/pt-BR/channels/delete-channel Remova permanentemente um canal do BluBash e sua configuração. Esta ação não pode ser desfeita — considere desativar para uma pausa temporária. Excluir um canal o remove permanentemente, junto com todas as suas configurações, do seu workspace. As conversas existentes são preservadas no histórico, mas não receberão mais novas mensagens. Essa ação não pode ser revertida, então só prossiga quando tiver certeza de que o canal não é mais necessário. Se você precisa apenas pausar um canal temporariamente, use a opção [desativar](/pt-BR/channels/activate-deactivate-channel). A desativação preserva toda a configuração para que você possa reativar o canal mais tarde. * Na barra lateral esquerda, clique em **Canais**. * Clique no canal que você quer excluir. * Você é levado à página de detalhes do canal. Na página de detalhes, localize o botão **Excluir canal** ou **Remover** e clique nele. Uma caixa de diálogo de confirmação se abre. A caixa de diálogo exibe os seguintes avisos antes de prosseguir: * Todas as conversas deste canal serão afetadas. * O canal não pode ser restaurado após a exclusão. * Os clientes não conseguirão mais enviar mensagens por este canal. Para confirmar, digite o **nome exato do canal** no campo de confirmação e, em seguida, clique em **Confirmar exclusão** ou **Excluir**. A exclusão é permanente e não pode ser desfeita. Verifique se você selecionou o canal correto antes de confirmar. Após a confirmação, o canal é removido. Você é redirecionado para a lista de canais e uma mensagem de sucesso confirma a exclusão. ## O que acontece após a exclusão * O canal não aparece mais na lista de canais. * O histórico de conversas existentes é mantido, mas essas conversas não receberão novas mensagens de entrada. * Os clientes não conseguem mais entrar em contato com você pelo canal excluído. * Toda a configuração — incluindo credenciais, atribuição da equipe padrão e agente de IA — é removida permanentemente. Se você quiser reconectar o mesmo número de WhatsApp no futuro, precisará criar um novo canal e concluir todo o processo de configuração novamente. # Editar as configurações de um canal no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/channels/edit-channel Atualize o nome de um canal, a equipe padrão ou o agente de IA a qualquer momento na página de detalhes do canal, sem afetar as conversas existentes. Você pode atualizar as configurações básicas de um canal a qualquer momento depois que ele for criado. Os campos editáveis incluem o nome do canal, a equipe padrão que recebe as conversas e o agente de IA atribuído ao canal. As credenciais de conexão — como tokens da API do WhatsApp — não podem ser editadas no local; se você precisar alterá-las, será necessário excluir e recriar o canal. * Na barra lateral esquerda, clique em **Canais**. * Clique no canal que você quer editar. * Você é levado à página de detalhes do canal. Na página de detalhes, você verá um formulário com as configurações atuais do canal. Os campos editáveis são: * **Nome do canal** * **Equipe padrão** * **Agente de IA** As credenciais de conexão (como tokens de API ou links de QR code) não podem ser editadas diretamente. Para alterá-las, exclua o canal e crie um novo. * **Nome** — digite o novo nome do canal. * **Equipe padrão** — selecione uma equipe diferente no menu suspenso. * **Agente de IA** — escolha outro agente ou selecione "Nenhum" para remover o atual. Alterar a **Equipe padrão** afeta apenas novas conversas. As conversas existentes permanecem atribuídas à equipe original. Clique em **Salvar** ou **Atualizar**. Uma mensagem de sucesso confirma as alterações. O nome do canal é atualizado imediatamente em toda a interface. As alterações entram em vigor assim que você clica em Salvar. Não é necessário recarregar a página. # Pesquisar e filtrar canais no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/channels/search-filter-channels Use a barra de busca de Canais para encontrar canais por nome, tipo ou número de telefone, e leia os indicadores de status para monitorar a saúde do canal em um relance. A página Canais inclui uma barra de busca em tempo real que permite localizar rapidamente qualquer canal por nome, tipo ou número de telefone. À medida que seu workspace cresce, isso torna simples encontrar canais específicos sem precisar rolar a lista completa. ## Pesquisar um canal Na página **Canais**, localize a barra de busca no topo da lista. Digite qualquer um dos itens abaixo: * **Nome do canal** — por exemplo, "WhatsApp Vendas" * **Tipo de canal** — por exemplo, "WhatsApp" * **Número de telefone** — para canais de WhatsApp, você pode pesquisar pelo número conectado A lista é filtrada em tempo real conforme você digita. Não é necessário pressionar Enter. Para canais de WhatsApp, a busca também corresponde ao número de telefone verificado e ao nome de exibição do WhatsApp mostrado nos detalhes do canal. Termos parciais funcionam — você não precisa digitar o nome ou número completo para obter resultados correspondentes. ## Atualizar a lista de canais Clique no botão **Atualizar** (ícone de seta circular) no canto superior direito da página para recarregar a lista com os dados mais recentes. Use-o após criar, editar ou excluir um canal para ver o estado atualizado imediatamente. ## Leitura dos indicadores na lista de canais Cada linha na lista de canais oferece informações imediatas: | Indicador | Descrição | | -------------------------- | ----------------------------------------------------------------------------------------------- | | **Ícone de tipo** | Identifica visualmente o tipo do canal (por exemplo, WhatsApp). | | **Nome do canal** | O nome que você atribuiu ao criar o canal. | | **Selo de status** | Um rótulo codificado por cores que mostra o estado atual do canal (veja abaixo). | | **Informações adicionais** | Para canais de WhatsApp, mostra o número de telefone conectado e o nome de exibição verificado. | ### Selos de status | Status | Cor | Significado | | ---------------- | -------- | ---------------------------------------------------------------------------------------------------------- | | **Ativo** | Verde | O canal está conectado e recebendo mensagens. | | **Inativo** | Cinza | O canal está pausado e não está recebendo mensagens. | | **Configuração** | Laranja | O canal foi criado, mas a configuração ainda não foi concluída (por exemplo, QR code ainda não escaneado). | | **Erro** | Vermelho | Há um problema de conexão — verifique as credenciais ou reconecte. | # Adicionar um novo contato ao seu workspace BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/contacts/add-new-contact Aprenda a adicionar manualmente um contato no BluBash preenchendo nome, número de WhatsApp e detalhes opcionais como e-mail, telefone e empresa. O BluBash permite construir sua base de contatos manualmente para que você organize seus clientes e otimize a comunicação. Ao criar um contato, você informa dados básicos como nome e número de WhatsApp, e pode enriquecer o cadastro com detalhes adicionais a qualquer momento. Na barra lateral esquerda, clique em **Contatos**. Clique no botão **+** no canto superior direito da tela. Complete os campos do formulário que aparece: * **Nome** (obrigatório): O nome completo do contato. * **E-mail** (opcional): O endereço de e-mail do contato. * **Telefone** (opcional): Um número de telefone comum. * **WhatsApp** (obrigatório): O número de WhatsApp incluindo o código do país. Clique em **Criar contato**. O BluBash salva o cadastro e redireciona você para a página de detalhes do contato. **Nome** e **WhatsApp** são os únicos campos obrigatórios. Todos os outros são opcionais e podem ser preenchidos depois, ao editar o contato. Depois de criar o contato, você é automaticamente levado até a página de detalhes dele, onde pode adicionar campos personalizados, tags e qualquer outra informação. Se o número de WhatsApp informado já estiver cadastrado em outro contato, o BluBash exibirá um aviso de conflito. # Excluir um contato do BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/contacts/delete-contact Remova permanentemente um contato e todos os seus dados do BluBash, incluindo histórico de conversas, tags e campos personalizados. Esta ação não pode ser desfeita. Você pode excluir contatos que não são mais necessários em sua base. Essa ação é permanente e remove todas as informações associadas ao contato, então certifique-se de não precisar mais do cadastro antes de prosseguir. Excluir um contato é **permanente e não pode ser desfeito**. Todos os dados vinculados ao contato — incluindo histórico de conversas, tags, campos personalizados e linha do tempo de atividades — serão removidos para sempre. Considere exportar ou anotar qualquer informação importante antes de excluir. Na barra lateral esquerda, clique em **Contatos**. Clique no contato que você quer excluir para abrir a página de detalhes. Clique no botão de **menu** (três pontos) no canto superior direito da tela. No menu que aparece, clique em **Excluir** (ícone de lixeira). Uma caixa de diálogo de confirmação aparecerá. Leia o aviso com atenção e clique em **Confirmar exclusão** para prosseguir. Após confirmar, o contato é excluído e você é redirecionado para a lista de contatos. ### O que é removido quando você exclui um contato? Os seguintes dados são removidos permanentemente: * Dados básicos do contato (nome, e-mail, telefone, WhatsApp) * Foto de perfil * Campos personalizados * Tags vinculadas * Histórico de conversas * Linha do tempo de atividades * Todas as mensagens relacionadas * Metadados e informações adicionais **Algumas coisas para ter em mente:** * A exclusão requer **permissão de administrador** ou uma permissão específica para excluir contatos. * A ação **não pode ser revertida** depois de confirmada. * Se o contato tiver **conversas ativas**, elas também serão afetadas. * Recomendamos **fazer backup** de qualquer informação importante antes de excluir. * Se disponível, considere **arquivar** o contato em vez de excluí-lo. # Editar os detalhes de um contato no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/contacts/edit-contact Atualize informações básicas, foto de perfil, campos personalizados e metadados de qualquer contato a qualquer momento diretamente na página de detalhes do contato no BluBash. Você pode atualizar as informações armazenadas em qualquer contato no BluBash a qualquer momento. Isso inclui detalhes básicos como nome, e-mail e telefone, além da foto de perfil, campos personalizados e metadados como empresa e cargo. Na barra lateral esquerda, clique em **Contatos**. Na lista de contatos, clique no contato que você quer editar. Clique no botão **Editar** (ícone de lápis) no canto superior direito da tela. Edite os campos que você precisar: * **Informações básicas**: Nome, e-mail, telefone, número de WhatsApp. * **Foto de perfil**: Clique no ícone de câmera no avatar para adicionar ou alterar a foto. * **Campos personalizados**: Preencha ou atualize quaisquer campos personalizados configurados para a sua conta. * **Metadados**: Empresa, cargo e outras informações complementares. Clique em **Atualizar contato** para confirmar. As alterações são aplicadas imediatamente. Se você alterar o número de WhatsApp para um que já esteja cadastrado em outro contato, o BluBash exibirá um aviso de conflito e deixará você decidir como prosseguir. Você pode cancelar a edição a qualquer momento antes de salvar clicando no botão **Cancelar** (X). Todas as alterações são registradas na linha do tempo de atividades do contato, e todos os campos obrigatórios precisam estar preenchidos antes de você salvar. # Gerenciar tags em um contato Source: https://blubash-04458f0b.mintlify.app/pt-BR/contacts/manage-contact-tags Adicione ou remova tags em qualquer contato do BluBash para categorizar seu público, agilizar buscas e permitir segmentação direcionada para campanhas. As tags ajudam você a organizar e categorizar seus contatos no BluBash. Ao rotular contatos com tags relevantes, você consegue identificar instantaneamente características, status ou tipos — tornando muito mais fácil encontrar grupos específicos e executar campanhas direcionadas. **Por que usar tags?** * **Organização**: Categorize contatos por características, status ou tipo. * **Busca mais rápida**: Localize rapidamente grupos específicos de contatos. * **Segmentação**: Crie grupos para campanhas e ações direcionadas. * **Rastreabilidade**: As tags permanecem vinculadas ao contato ao longo das atualizações, oferecendo um histórico confiável. *** ## Adicionar uma tag a um contato Na barra lateral esquerda, clique em **Contatos**. Clique no contato na lista para abrir a página de detalhes dele. Role a página até encontrar o card **Tags**. Clique no botão **+** ao lado do título Tags. Digite o nome da tag no campo de busca ou escolha uma na lista. A tag é adicionada ao contato imediatamente. *** ## Remover uma tag de um contato Navegue até o contato e abra os detalhes dele. Role até o card **Tags**. Posicione o cursor sobre a tag que você quer remover. Clique no **X** que aparece no lado direito da tag. Ela é removida imediatamente. **Algumas coisas para ter em mente:** * Você pode adicionar **várias tags** ao mesmo contato. * As tags podem ser usadas para **filtrar contatos** na lista principal de contatos. * As tags **permanecem vinculadas** ao contato mesmo após outras atualizações. * Cada tag pode ter uma **cor personalizada** para fácil identificação visual. * Você pode pesquisar tags por nome ao adicioná-las a um contato. # Pesquisar e filtrar sua lista de contatos Source: https://blubash-04458f0b.mintlify.app/pt-BR/contacts/search-filter-contacts Encontre contatos rapidamente no BluBash usando busca de texto em tempo real por nome, e-mail e telefone, ou combine filtros para refinar seus resultados. O BluBash oferece ferramentas de busca e filtragem em tempo real para que você localize qualquer contato em sua base sem precisar rolar listas longas. Você pode pesquisar por texto em vários campos ao mesmo tempo e combinar a busca com filtros para resultados mais precisos. ## Pesquisar por texto Na barra lateral esquerda, clique em **Contatos**. Na barra de busca no topo da página, digite qualquer um dos itens abaixo: * Nome do contato * Endereço de e-mail * Número de telefone * Qualquer outra informação relacionada Os resultados aparecem automaticamente à medida que você digita. A busca é executada em tempo real e exibe um contador mostrando o total de contatos correspondentes. A busca por texto é a forma mais rápida de encontrar um contato. Ela pesquisa por nome, e-mail e telefone simultaneamente, facilitando localizar um cadastro mesmo que você se lembre apenas de parte da informação. ## Dicas para pesquisar e filtrar * A busca é executada em tempo real — não é necessário pressionar Enter. * Os resultados são atualizados automaticamente conforme você digita. * O contador no topo mostra quantos contatos correspondem à sua consulta atual. * Você pode combinar a busca por texto com outros filtros disponíveis para obter resultados mais precisos. # Iniciar uma conversa diretamente a partir de um contato Source: https://blubash-04458f0b.mintlify.app/pt-BR/contacts/start-conversation-from-contact Inicie uma nova conversa de WhatsApp diretamente na página de detalhes de um contato no BluBash, sem precisar ir antes para a caixa de entrada de conversas. O BluBash permite abrir uma nova conversa diretamente da página de detalhes de um contato. Isso facilita entrar em contato proativamente ou fazer um follow-up com um cliente enquanto você já está olhando o cadastro dele — sem precisar navegar até a caixa de entrada de conversas antes. **Quando usar este recurso:** * **Contato proativo**: Quando você precisa falar com um cliente por iniciativa própria. * **Retomada de contato**: Para continuar de onde uma conversa anterior parou. * **Ação rápida**: Quando você já está vendo o contato e precisa começar a enviar mensagens imediatamente. *** ## Iniciar uma conversa a partir de um contato Na barra lateral esquerda, clique em **Contatos**. Clique no contato com quem você quer conversar para abrir a página de detalhes. Clique no botão de **menu** (três pontos) no canto superior direito da tela. No menu que aparece, clique em **Iniciar conversa** (ícone de mensagem). Se você pertence a mais de uma equipe ou departamento, selecione a equipe que deve cuidar dessa conversa. Escolha qual **número de WhatsApp** você quer usar para falar com o cliente. Depois de selecionar a equipe e o canal, você é redirecionado para a caixa de entrada de conversas com a conversa já aberta e pronta para enviar mensagens. Para usar este recurso você precisa de: * O contato precisa ter um **número de WhatsApp cadastrado**. * **Permissão para iniciar conversas** no BluBash. * Pelo menos um **canal de WhatsApp configurado** na sua conta. Se sua empresa usa a API oficial do WhatsApp e o contato não enviou nenhuma mensagem nas últimas 24 horas, sua primeira mensagem de saída precisa ser um **template de mensagem**. **Algumas coisas para ter em mente:** * A opção **Iniciar conversa** só aparece se o contato tiver um número de WhatsApp cadastrado. * Você é **redirecionado automaticamente** para a caixa de entrada de conversas após selecionar o canal. * Se já existe uma conversa ativa com o contato, essa conversa será aberta em vez de uma nova ser criada. * A conversa é **atribuída a você automaticamente**. * Você pode usar este recurso para **contato proativo** e **follow-ups**. # Usar campos personalizados para armazenar dados do contato Source: https://blubash-04458f0b.mintlify.app/pt-BR/contacts/use-custom-fields Preencha campos personalizados em um contato do BluBash para capturar informações específicas do seu negócio além dos campos padrão, como avaliações, datas ou valores em lista. Os campos personalizados permitem anexar informações adicionais e específicas do seu negócio a um contato, além dos campos padrão de nome, e-mail e telefone. Eles são configurados pelos administradores da sua conta e permitem manter dados estruturados e padronizados, relevantes para o seu setor ou fluxo de trabalho. **Por que usar campos personalizados?** * **Informações específicas**: Capture dados que importam para o seu tipo de negócio. * **Organização**: Mantenha as informações de contato estruturadas e consistentes. * **Segmentação**: Use valores de campos para criar grupos e filtros personalizados. * **Histórico**: Os valores dos campos podem ser atualizados a qualquer momento, e as alterações ficam registradas na linha do tempo de atividades. *** ## Tipos de campo disponíveis O BluBash suporta os seguintes tipos de campo personalizado: | Tipo | Descrição | | -------------------- | ------------------------------------------------------------ | | **Texto** | Entrada de texto livre para informações gerais | | **Número** | Valores numéricos inteiros ou decimais | | **Data** | Seletor de data com calendário | | **E-mail** | Campo de texto com validação automática de formato de e-mail | | **Telefone** | Campo de texto com formatação automática de telefone | | **URL** | Links e sites com validação de formato | | **Moeda** | Valores monetários com formatação de moeda | | **Avaliação** | Avaliação por estrelas (por exemplo, 1 a 5 estrelas) | | **Lista única** | Lista suspensa com opções pré-definidas | | **Múltipla escolha** | Permite selecionar várias opções de uma lista | | **Sim / Não** | Campo booleano para respostas verdadeiro/falso | *** ## Preencher campos personalizados em um contato Na barra lateral esquerda, clique em **Contatos**. Clique no contato que você quer atualizar para abrir a página de detalhes. Clique no botão **Editar** (ícone de lápis). Role a página até encontrar a seção **Campos personalizados**. Cada campo tem um estilo de entrada que combina com seu tipo: * **Texto / Número**: Digite diretamente no campo. * **Data**: Use o calendário para selecionar uma data. * **Lista única ou múltipla**: Escolha na lista de opções. * **Avaliação**: Clique nas estrelas para definir um valor. * **Sim / Não**: Marque ou desmarque a opção. Clique em **Salvar** para confirmar. Os campos marcados com um asterisco (\*) são obrigatórios e precisam ser preenchidos antes de salvar. Os campos personalizados são configurados pelos administradores da sua conta — fale com eles se você precisar adicionar um novo campo ou alterar um existente. **Algumas coisas para ter em mente:** * Os campos personalizados são **configurados pelos administradores da conta**. * Alguns campos podem ser **obrigatórios** antes de você salvar o contato. * Os campos podem ter **validações específicas**, como formato de e-mail ou comprimento mínimo/máximo. * As alterações em campos personalizados são registradas na **linha do tempo de atividades** do contato. * Você pode **atualizar os valores dos campos** a qualquer momento editando o contato. # Visualizar o histórico de conversas de um contato Source: https://blubash-04458f0b.mintlify.app/pt-BR/contacts/view-activity-timeline Acesse a linha do tempo de atividades em qualquer contato do BluBash para ver um registro cronológico completo de mensagens, atualizações, tags, automações e outros eventos. A linha do tempo de atividades oferece uma visão completa de cada interação e evento relacionado a um contato. É uma ferramenta poderosa para entender o histórico completo do seu relacionamento com um cliente — desde o momento em que o contato foi criado até a atividade mais recente. **Por que usar a linha do tempo?** * **Histórico completo**: Veja todas as interações com o contato em um só lugar. * **Rastreabilidade**: Acompanhe alterações e atualizações feitas no cadastro do contato. * **Contexto**: Entenda o histórico antes de iniciar uma nova conversa. * **Auditoria**: Veja quem fez cada alteração e quando ela aconteceu. *** ## Eventos registrados na linha do tempo A linha do tempo captura os seguintes tipos de evento: * **Criação do contato**: Quando o contato foi adicionado pela primeira vez. * **Atualizações**: Alterações em informações básicas ou em campos personalizados. * **Mensagens**: Mensagens enviadas e recebidas via WhatsApp, Instagram, Facebook e outros canais. * **Tags**: Tags adicionadas ou removidas do contato. * **Automações**: Automações disparadas para o contato. * **Campanhas**: Envios, aberturas e cliques de campanha. * **Formulários**: Envios de formulário vinculados ao contato. * **Integrações**: Sincronizações com sistemas externos. * **Notas**: Notas internas adicionadas ao contato. *** ## Como visualizar a linha do tempo Na barra lateral esquerda, clique em **Contatos**. Clique no contato cujo histórico você quer revisar. A linha do tempo de atividades aparece no **painel à direita** da página de detalhes do contato. Role pela linha do tempo para ver eventos mais antigos. Os eventos mais recentes aparecem no topo. *** ## Informações exibidas para cada evento Cada entrada na linha do tempo exibe: * **Tipo de evento**: Um ícone e descrição do que aconteceu. * **Data e hora**: Quando o evento ocorreu. * **Responsável**: Quem realizou a ação (quando aplicável). * **Detalhes**: Informações específicas sobre o evento. * **Codificação por cores**: Cada tipo de evento tem uma cor distinta para identificação rápida. **Algumas coisas para ter em mente:** * A linha do tempo é **atualizada em tempo real** conforme novas interações acontecem. * Os eventos são **ordenados cronologicamente**, com os mais recentes no topo. * Role para baixo para ver o **histórico completo**. * Alguns eventos podem ter **detalhes expansíveis** com informações adicionais. * A linha do tempo ajuda você a **manter o contexto** entre conversas e interações de suporte. # Encerrar e resolver uma conversa Source: https://blubash-04458f0b.mintlify.app/pt-BR/conversations/close-attendance Aprenda quando e como encerrar uma conversa resolvida no BluBash para manter sua fila organizada e sua equipe focada nas interações ativas. Assim que você terminar de atender um cliente e não houver mais nada a tratar naquele momento, você deve encerrar a conversa. Encerrar conversas resolvidas mantém sua fila limpa e garante que a atenção da sua equipe permaneça nas interações que ainda estão em andamento. Faça login no BluBash e acesse o menu **Conversas** na barra lateral esquerda. Encontre e abra a conversa que você quer encerrar. Clique no botão **Encerrar** na barra de ferramentas da conversa. Se sua equipe ou departamento tiver motivos de encerramento configurados, selecione ou informe o mais apropriado e, em seguida, clique em **Encerrar** para confirmar. Motivos de encerramento comuns incluem: *Cliente comprou*, *Sem resposta do cliente*, *Ticket resolvido* e rótulos semelhantes. Seu administrador define as opções disponíveis para a sua equipe. # Adicionar notas internas a uma conversa Source: https://blubash-04458f0b.mintlify.app/pt-BR/conversations/internal-notes Use notas internas no BluBash para deixar comentários privados dentro de uma conversa, visíveis apenas para sua equipe e nunca exibidos ao cliente. Notas internas são comentários privados que você pode adicionar a qualquer conversa no BluBash. Elas nunca ficam visíveis para o cliente e servem como uma ferramenta de colaboração para sua equipe — ajudando os agentes a compartilhar contexto, repassar detalhes importantes e manter um registro completo de cada interação. ## Quando usar notas * **Transferência de conversa**: antes de repassar para outro agente, deixe uma nota resumindo o histórico e os pontos principais que ele precisa saber. * **Atendimento híbrido (on-line e presencial)**: registre detalhes de visitas presenciais, como compras feitas, perguntas feitas ou outras informações relevantes. * **Feedback interno**: gerentes e administradores podem deixar observações ou orientações sobre como uma interação foi conduzida. * **Histórico completo**: as notas permanecem anexadas à conversa mesmo depois de ela ser encerrada ou transferida, garantindo rastreabilidade total. ## Como adicionar uma nota Faça login no BluBash e clique em **Conversas** na barra lateral esquerda, depois selecione a conversa onde você quer adicionar uma nota. Clique no botão **Mensagem** e selecione a opção **Nota**. O campo de texto será destacado em **amarelo** com o placeholder *"escreva uma nota interna"*. Digite sua nota e confirme para enviá-la. Uma vez salva, a nota aparece no histórico da conversa e fica visível apenas para sua equipe. Ela nunca é entregue ao WhatsApp do cliente. As notas são uma forma poderosa de manter sua equipe alinhada, preservar informações importantes e garantir continuidade em todas as conversas. # Enviar um template do WhatsApp em uma conversa Source: https://blubash-04458f0b.mintlify.app/pt-BR/conversations/send-templates Entenda quando e como enviar uma mensagem de template do WhatsApp pré-aprovada no BluBash, incluindo como preencher e pré-visualizar variáveis. Templates são formatos de mensagem pré-aprovados exigidos pelas políticas do WhatsApp da Meta em situações específicas. O BluBash avisa quando um template é necessário, então você nunca precisa adivinhar. Os templates são criados e gerenciados pelo administrador da sua conta — se você precisa de uma mensagem que ainda não existe, peça ao seu gerente para criar uma nova. ## Quando templates são obrigatórios Você deve usar um template em duas situações: * **Mais de 24 horas** se passaram desde a última mensagem enviada pelo cliente. * Você está **iniciando uma conversa pela primeira vez** com um cliente que nunca enviou mensagem para sua empresa. ## Como enviar um template Faça login no BluBash e clique em **Conversas** na barra lateral esquerda. Abra a conversa onde você precisa enviar uma mensagem. Se você ainda não iniciou uma conversa, consulte [Iniciar uma nova conversa com um contato](/pt-BR/conversations/start-new-attendance). Quando um template é necessário, o BluBash exibe um aviso e mostra a opção **Escolher um template**. Clique nela e selecione o template desejado na lista ou pesquise pelo nome. Os nomes dos templates são definidos pelo seu administrador quando o template é criado. Alguns templates incluem **variáveis** — espaços reservados como `{{1}}`, `{{2}}` — que permitem personalizar a mensagem para cada cliente. O BluBash sugere valores automaticamente, mas você pode editá-los conforme necessário. **Exemplo de template:** ``` Olá {{1}}, aqui é a {{2}}, tudo bem? Combinamos de conversar novamente hoje — tudo bem se eu te enviar um áudio? ``` **Após preencher as variáveis:** ``` Olá Ana, aqui é a Maria, tudo bem? Combinamos de conversar novamente hoje — tudo bem se eu te enviar um áudio? ``` Revise a mensagem final no campo de **pré-visualização da mensagem**. Quando estiver tudo certo, clique em **Enviar template**. ## Depois de enviar um template * Se o cliente **responder**, a janela de 24 horas é reiniciada e você pode continuar a conversa com mensagens livres. * Se o cliente **não responder**, você precisará enviar um novo template na próxima vez que quiser entrar em contato. Você não pode enviar mensagens livres fora da janela de 24 horas. Use sempre templates nesses casos para se manter em conformidade com as políticas de mensagens da Meta. # Iniciar uma nova conversa com um contato Source: https://blubash-04458f0b.mintlify.app/pt-BR/conversations/start-new-attendance Aprenda a abrir proativamente uma nova conversa com um contato no BluBash, mesmo antes de o cliente ter enviado a primeira mensagem. Você pode iniciar uma conversa com um contato a qualquer momento, mesmo que ele ainda não tenha enviado nenhuma mensagem. Isso é útil quando você precisa entrar em contato proativamente, desde que o contato já esteja cadastrado na plataforma. Se o contato ainda não foi adicionado, cadastre-o primeiro antes de seguir os passos abaixo. Faça login no BluBash e clique em **Conversas** na barra lateral esquerda. Na fila de conversas, clique no botão **+** para abrir uma nova conversa. Digite o **nome, telefone ou e-mail** do contato e selecione-o nos resultados. Se você pertence a mais de uma equipe ou departamento, escolha a equipe que deve ser responsável por essa conversa. Selecione o **número de WhatsApp** que você quer usar para falar com o cliente. Clique em **Iniciar conversa**. A conversa será aberta e aparecerá na sua tela imediatamente. Se sua empresa usa a API oficial do WhatsApp e o cliente não enviou nenhuma mensagem nas últimas 24 horas, sua primeira mensagem **precisa** ser um template. Consulte [Enviar um template do WhatsApp em uma conversa](/pt-BR/conversations/send-templates) para saber como. # Marcar conversas com tags para organização e relatórios Source: https://blubash-04458f0b.mintlify.app/pt-BR/conversations/tags-purpose-usage Aprenda a aplicar e gerenciar tags em conversas no BluBash para categorizar, priorizar, filtrar e acompanhar as interações dos clientes em toda a sua equipe. Tags são rótulos que você pode anexar a conversas para classificá-las e organizá-las sem precisar abrir cada uma individualmente. Ao marcar conversas com tags, você e sua equipe podem entender rapidamente o status, a prioridade ou a categoria de qualquer interação em um relance. ## Para que servem as tags * **Organização**: categorize conversas por status, etapa do processo ou tipo de solicitação. * **Priorização**: identifique rapidamente quais conversas precisam da atenção mais urgente. * **Histórico**: as tags permanecem vinculadas ao contato mesmo após o encerramento da conversa, preservando rastreabilidade total. * **Filtragem inteligente**: pesquise e filtre sua lista de conversas com base nas tags aplicadas, facilitando o gerenciamento de altos volumes. ## Como aplicar tags Faça login no BluBash e clique em **Conversas** na barra lateral esquerda. Encontre e abra a conversa que você quer marcar. Clique em **Detalhes** no canto superior direito da tela da conversa. Role até a seção **Tags** e selecione uma ou mais tags entre as opções disponíveis. ## Observações importantes * Você pode aplicar **múltiplas tags** à mesma conversa. * Use o **filtro de tags** na lista de conversas para ver apenas as conversas com uma tag específica. * **Antes de encerrar uma conversa**, revise as tags aplicadas e atualize-as se a situação tiver mudado. * As tags permanecem vinculadas ao contato após o encerramento da conversa, então o histórico fica sempre preservado para consultas futuras. As tags são configuradas pelo administrador da sua conta. Se você precisar de uma nova tag que ainda não existe, entre em contato com seu gerente ou administrador para que ela seja criada. # Transferir uma conversa para outro agente Source: https://blubash-04458f0b.mintlify.app/pt-BR/conversations/transfer-attendance Redirecione uma conversa em andamento para outra equipe ou agente no BluBash, com um motivo opcional para dar contexto à equipe que receberá. Transferir uma conversa permite repassar uma interação com o cliente para a equipe ou agente certo quando necessário. Isso é comum quando uma conversa começa com uma equipe, mas precisa da expertise ou ação de outra — por exemplo, um cliente conversando com o time de vendas que precisa de ajuda do suporte, ou uma solicitação que pertence ao financeiro. Faça login no BluBash e clique em **Conversas** na barra lateral esquerda para encontrar a conversa que você quer transferir. Abra a conversa desejada e clique no botão de **transferência** (o ícone 🔁 na barra de ferramentas da conversa). Selecione para onde enviar a conversa: * **Equipe**: escolha o departamento ou equipe que deve assumir. * **Agente**: opcionalmente, selecione um agente específico dentro dessa equipe. * **Motivo** (opcional): informe uma breve nota explicando por que você está transferindo a conversa. Isso é interno e nunca é mostrado ao cliente. Use o campo de motivo para dar contexto útil ao agente que receberá a conversa — por exemplo: *"Cliente precisa de uma nota fiscal urgente do time financeiro."* O cliente **não é notificado automaticamente** sobre a transferência. Se for adequado, avise-o de que outro agente ou equipe continuará a conversa em instantes. # Usar respostas rápidas para responder mais rápido Source: https://blubash-04458f0b.mintlify.app/pt-BR/conversations/use-quick-messages Aprenda a usar as mensagens rápidas do BluBash — uma biblioteca de respostas pré-escritas — para responder mais rápido e de forma mais consistente sem precisar redigitar textos comuns. Mensagens rápidas são uma biblioteca de textos pré-escritos que você pode acessar e enviar durante qualquer conversa sem precisar redigitar o mesmo conteúdo para cada cliente. Elas são ideais para respostas padrão que você usa com frequência, ajudando a responder mais rápido e a manter uma comunicação consistente em toda a sua equipe. Exemplos comuns incluem: * Apresentação do agente ou da empresa. * Pergunta de abertura ("Como posso ajudar você hoje?"). * Informações úteis, como formas de pagamento, dados bancários para transferência, endereço ou horário de atendimento. ## Como enviar uma mensagem rápida Faça login no BluBash e clique em **Conversas** na barra lateral esquerda. Selecione a conversa onde você quer enviar uma mensagem rápida. Clique no ícone de **raio** (ao lado do botão de anexar) para abrir o painel de mensagens rápidas. Navegue pela lista ou pesquise pelo nome para encontrar a mensagem que você quer usar. Prefira mensagens destacadas em **laranja** com o rótulo **"mensagem rápida"**. Ao contrário dos templates, as mensagens rápidas **não têm custo de envio**. Algumas mensagens rápidas incluem variáveis — espaços reservados como `{{1}}`, `{{2}}` — que permitem personalizar o texto para cada cliente ou agente. O BluBash sugere valores automaticamente, mas você pode editá-los antes de enviar. **Exemplo salvo como mensagem rápida:** ``` Olá {{1}}, aqui é a {{2}} e vou continuar o seu atendimento. Como posso ajudar você hoje? ``` **Após preencher as variáveis:** ``` Olá Maria, aqui é a Ana e vou continuar o seu atendimento. Como posso ajudar você hoje? ``` Confira o texto final no campo de **pré-visualização da mensagem** e clique em **Enviar** quando estiver pronto. Uma vez enviada, a mensagem aparece na janela da conversa exatamente como qualquer outra mensagem digitada manualmente. # Guia de implementação: configure o BluBash passo a passo Source: https://blubash-04458f0b.mintlify.app/pt-BR/implementation-guide Siga este guia de sete etapas para configurar sua conta BluBash corretamente desde o primeiro dia — desde adicionar membros da equipe até lidar com sua primeira conversa. Para oferecer à sua equipe a melhor experiência desde o início, o BluBash é configurado em uma sequência estruturada. Seguir essas etapas em ordem garante que tudo esteja configurado corretamente antes que sua primeira conversa chegue. Adicione os membros da sua equipe à plataforma e defina o nível de acesso de cada pessoa com base em sua função. [Adicionar um membro →](/pt-BR/members/add-member) Organize sua operação em departamentos e vincule cada membro à equipe certa. Isso controla como as conversas são roteadas e atribuídas. [Criar e configurar equipes →](/pt-BR/account-settings/create-configure-teams) Configure tags para classificar conversas. As tags facilitam organizar sua caixa de entrada, filtrar relatórios e disparar automações. [Criar tags →](/pt-BR/account-settings/create-tags) Configure seu agente de IA com as instruções e o contexto necessários para lidar com as conversas dos clientes. Teste e ajuste o comportamento do agente para atender às necessidades da sua operação. [Criar um agente de IA →](/pt-BR/ai-agents/create-ai-agent) Conecte seu número de WhatsApp ao BluBash. Isso centraliza todas as mensagens recebidas na plataforma e ativa o agente de IA nesse número. [Conectar um canal →](/pt-BR/channels/create-channel) Crie e envie templates de mensagem aprovados pela Meta. Os templates são necessários para iniciar novas conversas com contatos fora da janela de mensagens de 24 horas. [Criar um template →](/pt-BR/templates/create-template) Com tudo configurado, sua equipe pode começar a lidar com conversas e explorar todos os recursos do BluBash. [Iniciar uma conversa →](/pt-BR/conversations/start-new-attendance) Depois de conectar seu número de WhatsApp, envie uma mensagem de teste do seu número pessoal para o número conectado. Atue como um cliente para verificar se o agente de IA responde corretamente e se o roteamento das conversas está funcionando conforme esperado. Sua conta está pronta. Se você tiver dúvidas em qualquer momento da configuração, a equipe de suporte do BluBash está disponível para ajudar via WhatsApp. # BluBash: atendimento ao cliente no WhatsApp com IA Source: https://blubash-04458f0b.mintlify.app/pt-BR/introduction BluBash é uma plataforma SaaS que centraliza o atendimento ao cliente no WhatsApp, combinando agentes de IA, campanhas em massa e gestão de equipes em um só lugar. BluBash é uma plataforma SaaS criada para equipes que gerenciam a comunicação com clientes pelo WhatsApp. Ela reúne automação com IA, gestão de canais, organização de contatos e envio em massa para que sua equipe consiga lidar com conversas em qualquer escala — sem precisar trocar de ferramenta. ## O que você pode fazer com o BluBash Gerencie conversas de WhatsApp recebidas e enviadas em uma caixa de entrada unificada. Atribua, transfira, marque e encerre conversas em um só lugar. Crie agentes de IA que respondem aos clientes 24/7, lidam com perguntas comuns e fazem transferência para agentes humanos quando necessário. Envie mensagens em massa pelo WhatsApp para sua lista de contatos usando templates aprovados pela Meta. Agende, acompanhe e gerencie todas as suas campanhas em uma única visão. Conecte números de WhatsApp ao BluBash usando a integração Lite ou a API oficial do WhatsApp Business. Gerencie múltiplos canais a partir da mesma conta. Crie e envie templates de mensagem aprovados pela Meta para conversas de saída. Crie respostas rápidas para agilizar as respostas mais comuns. Integre o BluBash aos seus sistemas usando a API REST. Gerencie canais, dispare campanhas e muito mais de forma programática. ## Para quem é o BluBash O BluBash foi pensado para equipes de atendimento ao cliente, equipes de vendas e equipes de operações que usam o WhatsApp como canal principal de comunicação. Seja uma equipe de suporte pequena lidando com dezenas de conversas por dia ou uma operação maior gerenciando milhares, o BluBash escala junto com você. O BluBash oferece dois tipos de conexão com o WhatsApp: **WhatsApp Lite** para configuração rápida usando um número existente, e **API oficial do WhatsApp** para empresas que precisam da integração completa verificada pela Meta. ## Principais recursos * **Agentes de IA** — Configure agentes que respondem automaticamente às mensagens recebidas, seguem instruções personalizadas e encaminham para agentes humanos quando necessário. * **Gestão de equipes** — Convide membros da equipe, atribua papéis e organize agentes em equipes mapeadas para os seus departamentos. * **Gestão de contatos** — Armazene e organize contatos de clientes com tags, campos personalizados e histórico completo de atividades. * **Campanhas em massa** — Alcance toda a sua lista de contatos ou um segmento filtrado com uma única campanha de WhatsApp. * **Templates de mensagem** — Crie e gerencie templates aprovados pela Meta necessários para iniciar conversas fora da janela de mensagens de 24 horas. * **API REST** — Conecte o BluBash às suas ferramentas e fluxos de trabalho existentes usando a API de desenvolvedor. ## Por onde começar Se você está configurando o BluBash pela primeira vez, siga o [guia de implementação](/pt-BR/implementation-guide) para passar por cada etapa de configuração na ordem certa. # Adicionar um novo membro ao BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/members/add-member Convide um novo usuário para o seu workspace BluBash informando nome, endereço de e-mail e papel. Apenas administradores podem enviar convites. Convidar alguém para o BluBash leva poucos passos. Depois que você envia o convite, o novo membro recebe um e-mail para definir a senha e fazer login. Até ele concluir o processo, aparece na lista com o status **Convidado**. Apenas administradores podem adicionar novos membros ao workspace. No menu à esquerda, clique em **Membros**. A página exibe todos os usuários já cadastrados no seu workspace. Selecione o botão **Adicionar membro** no canto superior direito da página. Complete os seguintes campos: * **Nome completo** — o nome da pessoa que você está convidando. * **E-mail** — use um endereço válido ao qual o convidado tenha acesso. * **Papel** — escolha entre Administrador, Gerente ou Membro. Selecione o papel que corresponde às responsabilidades da pessoa. Papéis mais restritivos melhoram a segurança e reduzem o risco de alterações não intencionais. Clique em **Adicionar membro** para confirmar. O convidado recebe um e-mail com instruções para criar a senha e acessar a plataforma. ## Boas práticas * Mantenha o papel de **Administrador** restrito a um pequeno número de pessoas de confiança. * Se você convidou a pessoa errada, pode editar o papel dela ou removê-la totalmente — veja [Editar o papel de um membro](/pt-BR/members/edit-member-permissions) e [Remover um membro](/pt-BR/members/remove-member). # Editar o papel e as permissões de um membro Source: https://blubash-04458f0b.mintlify.app/pt-BR/members/edit-member-permissions Atualize o nome ou o papel de acesso de qualquer membro existente no seu workspace BluBash. As mudanças de papel têm efeito imediato. Apenas administradores podem fazer isso. Você pode atualizar o nome ou o papel de um membro a qualquer momento pela página de Membros. As mudanças de papel têm efeito imediato, então o membro notará a diferença assim que interagir com a plataforma novamente. Apenas administradores podem editar detalhes e papéis dos membros. Abra **Membros** no menu à esquerda. Use a barra de busca para encontrar a pessoa por nome, e-mail ou papel. Selecione o ícone de lápis na linha do membro. Se você clicar no ícone de edição no seu próprio usuário, será redirecionado para a página de perfil para atualizar seus dados pessoais. Edite o **Nome** e/ou o **Papel** (Administrador, Gerente ou Membro) e confirme para salvar. Alterar um papel expande ou restringe imediatamente as permissões do membro. Confirme com sua equipe antes de fazer mudanças críticas. ## Dicas rápidas * Promova alguém para **Gerente** se essa pessoa precisar monitorar equipes e relatórios, mas não deve acessar configurações no nível da conta. * Mantenha o número de **Administradores** no mínimo para proteger seu workspace. # Gerencie os membros da sua equipe no BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/members/members-introduction Aprenda a convidar, editar e remover usuários no BluBash, entenda os papéis disponíveis e veja o que cada nível de permissão pode acessar. A área de Membros oferece controle total sobre quem tem acesso à sua conta BluBash. A partir daqui você pode convidar novos usuários, ajustar seus papéis, remover acessos que não são mais necessários e verificar rapidamente o status de cada pessoa no seu workspace. ## Papéis disponíveis O BluBash oferece três papéis, cada um pensado para um nível diferente de responsabilidade: Controle total sobre a conta, incluindo configurações, equipes e todos os membros. Pode monitorar operações e equipes, mas não tem acesso a configurações críticas da conta. Pensado para agentes de atendimento do dia a dia que precisam ver apenas o próprio trabalho. Atribua o papel de **Administrador** apenas a usuários de confiança e revise as permissões de acesso periodicamente. ## O que você pode fazer na página de Membros * **Convidar** novos usuários informando nome, endereço de e-mail e papel. * **Editar** o nome ou o papel de membros existentes. * **Remover** membros com segurança — a plataforma impede a exclusão acidental do dono da conta ou do último usuário restante. * **Pesquisar** rapidamente por nome, e-mail ou papel. * **Verificar o status** de cada pessoa, como se o convite dela ainda está pendente ou se ela é o dono da conta. # Remover um membro do seu workspace Source: https://blubash-04458f0b.mintlify.app/pt-BR/members/remove-member Revogue o acesso de um usuário ao seu workspace BluBash. Apenas administradores podem remover membros, e regras de segurança evitam bloqueios acidentais. Quando alguém não precisa mais ter acesso ao seu workspace BluBash, você pode removê-lo na página de Membros. A ação é instantânea — o usuário perde o acesso assim que você confirma a remoção, e quaisquer convites pendentes que ele tenha também são cancelados. Apenas administradores podem remover membros. No menu à esquerda, clique em **Membros** e localize o usuário que você quer remover. Selecione o ícone de lixeira na linha do membro e, em seguida, confirme a ação na caixa de diálogo que aparece. ## Regras de segurança O BluBash aplica as seguintes restrições para evitar bloqueios acidentais: * **Você não pode remover a si mesmo.** * **Você não pode remover o dono da conta.** * **Você não pode remover o último membro restante do workspace.** Se você ver uma mensagem de bloqueio, verifique se está tentando remover o último usuário ou o dono da conta. Adicione outro administrador primeiro e tente a remoção novamente. ## Após remover um membro * O usuário perde o acesso ao workspace imediatamente. * Quaisquer convites pendentes para esse usuário também são invalidados. # Pesquisar e filtrar membros da equipe Source: https://blubash-04458f0b.mintlify.app/pt-BR/members/search-filter-members Encontre membros da equipe rapidamente usando a barra de busca no BluBash e aprenda a ler os indicadores de status que mostram o estado atual de cada membro. A página de Membros inclui uma barra de busca e indicadores de status que ajudam você a manter sua lista de equipe precisa e fácil de navegar. Use esses controles sempre que precisar localizar um usuário específico ou verificar o estado atual de um convite. ## Pesquisar por nome, e-mail ou papel Digite na barra de busca no topo da página. Os resultados são atualizados imediatamente e filtram simultaneamente nos campos **Nome**, **E-mail** e **Papel**. Se você não encontrar alguém, verifique se há um termo de busca ativo na barra ou se o convite dessa pessoa ainda está pendente de confirmação. ## Atualizar a lista Clique no botão **Atualizar** (ícone de seta circular) para recarregar a lista de membros com os dados mais recentes. Use-o após adicionar, editar ou remover um membro para confirmar que suas alterações estão refletidas corretamente. ## Entendendo os indicadores de status Cada linha na lista de Membros pode exibir um ou mais dos seguintes rótulos: | Indicador | Significado | | ----------------------- | ------------------------------------------------------------------------------------ | | **Você** | Identifica sua própria conta de usuário na lista. | | **Dono** | Marca o dono da conta, que não pode ser removido. | | **Convidado** | O e-mail de convite foi enviado, mas o usuário ainda não definiu a senha. | | **Contagem de membros** | Mostra o número total de membros exibidos no momento, após quaisquer filtros ativos. | # Criar atalhos de resposta rápida para sua equipe Source: https://blubash-04458f0b.mintlify.app/pt-BR/templates/create-quick-reply Aprenda a criar mensagens de resposta rápida no BluBash para que seus agentes possam enviar respostas padronizadas instantaneamente durante conversas ativas no WhatsApp. Respostas rápidas são mensagens pré-escritas que os agentes podem enviar imediatamente durante conversas ativas, sem necessidade de aprovação. Elas ajudam sua equipe a responder mais rápido e a manter a comunicação consistente. Apenas **administradores e gerentes** podem criar respostas rápidas. ## Começando No menu à esquerda, clique em **"Templates"**. Clique no botão **"+ Criar template"**. Selecione **"Resposta rápida"** (marcada com o selo "Pronto para uso"). ## Passo 1: selecionar uma categoria Escolha a categoria que melhor se encaixa na sua mensagem: * **Saudação** — mensagens de boas-vindas e apresentações * **Perguntas frequentes** — respostas a dúvidas comuns * **Informações de contato** — detalhes da empresa * **Informações do produto** — detalhes sobre seus produtos ou serviços * **Preços** — informações sobre preços e planos ## Passo 2: configurar a resposta rápida ### Nome Informe um nome descritivo para que os agentes encontrem a mensagem rapidamente. **Exemplo:** `Apresentação do agente` ### Tipo de conteúdo Escolha o formato que se ajusta à sua mensagem: * **Texto** — uma mensagem de texto simples * **Imagem** — uma imagem com legenda opcional * **Vídeo** — um vídeo com legenda opcional * **Documento** — um arquivo PDF ou DOC * **Áudio** — uma mensagem de áudio pré-gravada * **Contatos** — um cartão de contato compartilhado **Exemplo de texto:** ``` Olá {{1}}! Aqui é a {{2}} e vou ajudar você hoje. Como posso te ajudar? ``` ## Passo 3: atribuir equipes Selecione quais equipes terão acesso a esta resposta rápida. Apenas membros das equipes selecionadas verão essa resposta rápida em suas listas. ## Passo 4: revisar e criar Revise suas configurações e clique em **"Criar resposta rápida"**. A resposta rápida estará **disponível imediatamente** — sem necessidade de aprovação. # Criar um template de mensagem do WhatsApp aprovado pela Meta Source: https://blubash-04458f0b.mintlify.app/pt-BR/templates/create-template Guia passo a passo para criar um template de mensagem do WhatsApp no BluBash, desde a escolha da categoria certa até o envio do template para aprovação pela Meta. Templates de mensagem são mensagens estruturadas que precisam ser aprovadas pela Meta antes de serem enviadas. Eles são essenciais para iniciar ou retomar conversas no WhatsApp quando a janela de 24 horas expirou. Apenas **administradores e gerentes** podem criar templates. Se você não tem essa permissão, entre em contato com o administrador da sua conta. ## Começando No menu à esquerda, clique em **"Templates"**. Clique no botão **"+ Criar template"** no canto superior direito. Selecione **"Template de mensagem"** (marcado com o selo "Requer aprovação"). ## Passo 1: selecionar uma categoria Escolha a categoria que melhor descreve o propósito da sua mensagem: * **Marketing** — promoções, ofertas especiais, newsletters * **Utilidade** — confirmações de pedidos, status de entrega, lembretes * **Autenticação** — códigos de verificação, confirmações de login * **Atendimento ao cliente** — suporte, agendamento, retomada de conversas * **Vendas** — apresentação de produtos, orçamentos, follow-ups Para mensagens que retomam o contato com um cliente ou reiniciam uma conversa de suporte, use a categoria **"Atendimento ao cliente"**. ## Passo 2: configurar o template ### Nome do template Informe um nome único para identificar o template. **Regras:** * Não use acentos ou caracteres especiais * Espaços são permitidos * Use nomes descritivos * Exemplo: `ola retomar conversa` ### Cabeçalho (opcional) O cabeçalho aparece no topo da mensagem. Você pode escolher: * **Sem cabeçalho** — deixe o cabeçalho vazio * **Texto** — uma linha curta de texto (máximo de 60 caracteres, suporta 1 variável) * **Imagem** — uma imagem JPG ou PNG * **Vídeo** — um vídeo MP4 * **Documento** — um arquivo PDF ### Corpo (obrigatório) O corpo é o texto principal da mensagem. **Exemplo com variáveis:** ``` Olá {{1}}, tudo bem? Vi que não terminamos nossa conversa sobre {{2}}. Gostaria de continuar agora? ``` **Dicas:** * Seja claro e direto * Use variáveis para personalização (`{{1}}`, `{{2}}` etc.) * Máximo de 1.024 caracteres * Até 10 variáveis ### Rodapé (opcional) O rodapé aparece na parte inferior da mensagem em texto menor (máximo de 60 caracteres). **Exemplo:** ``` Equipe BluBash — Suporte 24/7 ``` ### Botões (opcional) Adicione até 10 botões interativos: * **Resposta rápida** — o contato toca no botão e uma resposta é enviada automaticamente * **URL** — abre um link externo * **Telefone** — inicia uma chamada telefônica ## Passo 3: atribuir canais Selecione em quais números de WhatsApp esse template estará disponível. O template é enviado para aprovação da Meta em **cada canal selecionado** individualmente. Cada canal pode ter um status de aprovação diferente. ## Passo 4: revisar e criar Revise todos os detalhes e clique em **"Criar template"**. ## Processo de aprovação da Meta Após criar o template: O template é enviado para a Meta para análise automaticamente. A aprovação pode levar de alguns minutos até 24 horas. Acompanhe o status na sua lista de templates: * **Pendente** — aguardando decisão da Meta * **Aprovado** — pronto para uso * **Rejeitado** — não aprovado (verifique o motivo informado) ## Boas práticas para aprovação 1. **Use linguagem neutra e profissional** 2. **Seja claro e conciso** 3. **Use variáveis adequadamente** 4. **Termine com uma pergunta ou chamada para ação clara** 5. **Evite conteúdo proibido** (spam, alegações enganosas, conteúdo adulto) # Editar ou excluir templates e respostas rápidas Source: https://blubash-04458f0b.mintlify.app/pt-BR/templates/edit-delete Aprenda a atualizar ou remover templates de mensagem e respostas rápidas no BluBash, e entenda o que acontece com templates que exigem nova aprovação. Você pode editar templates e respostas rápidas para atualizar o conteúdo, ou excluí-los quando não forem mais necessários. O processo é o mesmo para ambos os tipos, mas o resultado é diferente dependendo se o item exige aprovação da Meta. Apenas **administradores e gerentes** podem editar e excluir templates e respostas rápidas. ## Editar um template ou resposta rápida No menu à esquerda, clique em **"Templates"**. Use o campo de busca ou role pela lista para localizar o template ou a resposta rápida. Clique no **ícone de três pontos** (⋮) ao lado do item. Clique na opção Editar no menu suspenso. Você pode atualizar qualquer um dos itens abaixo: * Nome e descrição * Conteúdo (cabeçalho, corpo, rodapé) * Botões e mídia * Variáveis * Canais ou equipes associados Clique no botão de salvar para aplicar as atualizações. ## O que acontece após a edição O efeito de uma edição depende do tipo de mensagem: * Editar um template **requer nova aprovação da Meta** * O status muda de volta para **Pendente** * A versão anterior continua disponível para envio até que a nova versão seja aprovada * As alterações têm efeito **imediato** * Não é necessária aprovação * A mensagem atualizada fica disponível para sua equipe na hora ## Excluir um template ou resposta rápida No menu à esquerda, clique em **"Templates"**. Pesquise ou role para localizar o item que você quer remover. Clique no **ícone de três pontos** (⋮) ao lado do item. Clique na opção Excluir. Confirme que você quer excluir permanentemente o item. A exclusão é **permanente e irreversível**. O template ou a resposta rápida será completamente removido e não poderá ser recuperado. ## Quando editar vs. quando criar um novo **Edite o item existente quando você quer:** * Corrigir um erro de digitação ou redação * Atualizar informações como preços ou horário de atendimento * Adicionar ou remover variáveis **Crie um novo item quando:** * O conteúdo é completamente diferente do original * Você quer manter a versão atual disponível enquanto adiciona uma nova * Você precisa de aprovação com urgência e não pode esperar a nova aprovação da versão editada ## Observações importantes * Edições em templates de mensagem exigem **nova aprovação da Meta** e podem levar até 24 horas * Edições em respostas rápidas são **imediatas** * A exclusão é **permanente** — não há desfazer * Mensagens já enviadas **não são afetadas** por edições ou exclusões * Após editar um template, teste-o antes de usá-lo em conversas reais # Enviar templates e respostas rápidas em conversas Source: https://blubash-04458f0b.mintlify.app/pt-BR/templates/send-templates-quick-replies Aprenda a enviar templates aprovados pela Meta e mensagens de resposta rápida na visão de conversa do BluBash, incluindo como preencher variáveis. O BluBash torna simples enviar o tipo certo de mensagem no momento certo. Dependendo do estado da conversa, você usará um template de mensagem ou uma resposta rápida. Esta página explica os dois fluxos. ## Quando usar cada tipo Use um template quando: * Você está enviando a **primeira mensagem** para um contato com quem nunca conversou * A **janela de 24 horas expirou** — mais de 24 horas se passaram desde a última mensagem recebida do contato O WhatsApp permite mensagens livres apenas dentro de 24 horas após a última mensagem do contato. Fora dessa janela, é necessário usar um template aprovado. Use uma resposta rápida quando: * A conversa está **ativa** (dentro da janela de 24 horas) * Você quer enviar uma **resposta padronizada** rapidamente * Você está compartilhando **informações frequentemente solicitadas** ## Enviar um template de mensagem Quando um template é necessário, o BluBash indica isso na conversa: * Um **aviso amarelo** aparece na área de entrada de mensagem * Um botão **"Escolher template"** é exibido Toque no botão mostrado na área de entrada da mensagem. Use o campo de busca ou navegue pela lista. Os templates aparecem com um selo verde "Template". Clique no template que você quer enviar. Se o template contém variáveis (`{{1}}`, `{{2}}` etc.): * O BluBash sugere valores automaticamente com base nos dados do contato * Você pode editar qualquer valor manualmente * Todos os campos precisam ser preenchidos antes de enviar Verifique como a mensagem aparecerá para o contato. Confirme e envie a mensagem. Depois que o contato responder, você pode enviar mensagens livres pelas próximas 24 horas sem precisar de um template. ## Enviar uma resposta rápida Encontre o ícone na área de entrada da mensagem, ao lado do botão de anexo. Use o campo de busca ou role pela lista. As respostas rápidas aparecem com um selo laranja. O processo é o mesmo dos templates — o BluBash sugere valores e você pode editá-los. Confirme se a mensagem parece correta. Envie a mensagem. Prefira mensagens com o **selo laranja** ("resposta rápida") sempre que possível. Elas **não têm custo por envio**. ## Atalho de teclado Abra rapidamente o seletor de template e resposta rápida com: * **Windows / Linux**: `Ctrl + T` * **Mac**: `⌘ + T` ## Como funciona o preenchimento de variáveis Quando um template ou resposta rápida contém variáveis, você verá um campo de entrada para cada uma. **Template salvo:** ``` Olá {{1}}, aqui é {{2}} da {{3}}. ``` **Você preenche:** * `{{1}}` = Nome do contato (por exemplo, "Maria") * `{{2}}` = Seu nome (por exemplo, "Ana") * `{{3}}` = Nome da empresa (por exemplo, "BluBash") **Mensagem enviada:** ``` Olá Maria, aqui é Ana da BluBash. ``` O BluBash sugere valores automaticamente, mas você sempre pode editá-los antes de enviar. ## Observações importantes * Você só pode enviar templates quando o BluBash **solicitar** — não é possível forçar o envio de um template em uma conversa ativa * Respostas rápidas só funcionam em **conversas ativas** (dentro da janela de 24 horas) * Todas as variáveis **precisam** ser preenchidas antes do envio * A pré-visualização mostra exatamente como a mensagem aparecerá para o contato * Após enviadas, as mensagens **não podem ser editadas nem revogadas** # Usar variáveis em templates de mensagem do WhatsApp Source: https://blubash-04458f0b.mintlify.app/pt-BR/templates/use-variables Entenda como funcionam as variáveis dinâmicas nos templates e respostas rápidas do BluBash, com exemplos práticos e boas práticas de personalização. Variáveis são espaços reservados dinâmicos que permitem personalizar templates e respostas rápidas com informações específicas de cada contato. Em vez de enviar uma mensagem genérica, você pode inserir automaticamente nomes, números de pedido, datas e outros detalhes. ## Como as variáveis funcionam As variáveis usam um formato numerado entre chaves duplas: * `{{1}}` — primeira variável * `{{2}}` — segunda variável * `{{3}}` — terceira variável * E assim por diante, até `{{10}}` Ao enviar uma mensagem, você preenche cada variável com o valor apropriado para aquele contato. O BluBash pode sugerir valores automaticamente com base nos dados do contato. ## Onde você pode usar variáveis | Local | Variáveis suportadas | | ---------------------- | ------------------------------ | | **Cabeçalho de texto** | Máximo de 1 variável (`{{1}}`) | | **Corpo da mensagem** | Até 10 variáveis | | **Rodapé** | Não suportado | ## Exemplos práticos ### Exemplo 1: retomar uma conversa **Template:** ``` Olá {{1}}, tudo bem? Vi que não terminamos nossa conversa sobre {{2}}. Gostaria de continuar agora? ``` **Valores preenchidos:** * `{{1}}` = "Maria" (nome do contato) * `{{2}}` = "Plano Premium" (assunto) **Mensagem enviada:** ``` Olá Maria, tudo bem? Vi que não terminamos nossa conversa sobre Plano Premium. Gostaria de continuar agora? ``` ### Exemplo 2: confirmação de pedido **Template:** ``` {{1}}, seu pedido foi confirmado! Pedido: #{{2}} Total: {{3}} Entrega estimada: {{4}} ``` **Variáveis:** * `{{1}}` = Nome do contato * `{{2}}` = Número do pedido * `{{3}}` = Valor total * `{{4}}` = Data de entrega ## Sugestões automáticas de valores Ao enviar um template, o BluBash sugere valores para cada variável com base em: * **Dados do contato** — nome, e-mail, número de telefone, empresa * **Dados do agente** — seu nome * **Campos personalizados** — quaisquer campos personalizados configurados para o contato * **Data e hora atuais** — a data e a hora do envio Você pode aceitar as sugestões ou editá-las manualmente antes do envio. ## Boas práticas Atribua variáveis em uma ordem consistente entre seus templates para reduzir confusão: * `{{1}}` = Nome do contato * `{{2}}` = Nome do agente * `{{3}}` = Nome da empresa Ao configurar variáveis, adicione valores de exemplo realistas. Isso ajuda na aprovação da Meta e facilita o preenchimento correto pela sua equipe. Use apenas o número de variáveis que você realmente precisa. Recomenda-se de 2 a 4 variáveis; evite criar templates com muitas variáveis desnecessariamente. Verifique se todos os valores estão corretos e revise a pré-visualização da mensagem antes de confirmar o envio. ## Regras importantes * Todas as variáveis em um template são **obrigatórias** — você não pode deixar nenhuma em branco * As variáveis precisam seguir o formato `{{número}}` exatamente * Cabeçalhos de texto suportam no máximo **1 variável** * O corpo da mensagem suporta no máximo **10 variáveis** * Os números das variáveis devem ser **sequenciais** — não pule números (por exemplo, não use `{{1}}` e `{{3}}` sem `{{2}}`) # Templates e respostas rápidas: visão geral Source: https://blubash-04458f0b.mintlify.app/pt-BR/templates/what-are-templates-quick-replies Aprenda a diferença entre templates de mensagem aprovados pela Meta e atalhos de resposta rápida, e quando usar cada um no seu workspace BluBash. O BluBash oferece dois tipos de mensagens pré-configuradas para agilizar e padronizar como sua equipe se comunica com os clientes: **templates de mensagem** e **respostas rápidas**. Cada um cumpre um propósito específico e tem suas próprias regras de quando e como pode ser usado. ## Templates de mensagem Templates de mensagem são mensagens estruturadas que **exigem aprovação da Meta** antes de serem enviadas. Eles só são obrigatórios se você usa a **API oficial do WhatsApp Business**. **Use templates para:** * **Iniciar conversas** — quando você precisa enviar a primeira mensagem para um contato * **Retomar conversas** — quando mais de 24 horas se passaram desde a última mensagem do contato * **Enviar notificações** — atualizações de pedidos, confirmações e lembretes * **Executar campanhas** — promoções, ofertas especiais e newsletters * **Fazer follow-up** — follow-ups de vendas ou suporte **Os templates são obrigatórios em duas situações:** 1. **Primeira mensagem** — você nunca trocou mensagens com o contato antes 2. **Janela de 24 horas expirou** — mais de 24 horas se passaram desde a última mensagem recebida do contato O WhatsApp permite mensagens livres apenas dentro de uma janela de 24 horas após a última mensagem do contato. Fora dessa janela, é necessário usar um template aprovado. ## Respostas rápidas Respostas rápidas são mensagens prontas para uso disponíveis para **uso imediato**, sem necessidade de aprovação. Elas funcionam como um banco de mensagens pré-escritas que os agentes podem inserir durante conversas ativas. **Use respostas rápidas para:** * **Saudações** — mensagens de boas-vindas e apresentações do agente * **Perguntas frequentes** — respostas padrão a dúvidas comuns * **Informações úteis** — horário de atendimento, endereço, formas de pagamento * **Instruções** — orientação passo a passo para questões comuns * **Encerramentos** — mensagens padronizadas de despedida Diferente dos templates, as respostas rápidas **não têm custo por envio** e estão disponíveis instantaneamente, sem processo de aprovação. ## Principais diferenças | Característica | Template de mensagem | Resposta rápida | | ---------------------- | ----------------------------------- | ---------------------------- | | **Aprovação** | Requer aprovação da Meta | Uso imediato | | **Quando usar** | Iniciar ou retomar conversas | Durante conversas ativas | | **Janela de 24 horas** | Funciona fora da janela | Só funciona dentro da janela | | **Custo** | Pode ter custo por envio | Sem custo adicional | | **Estrutura** | Cabeçalho + Corpo + Rodapé + Botões | Formato livre | | **Mídia** | Imagem, vídeo, documento | Todos os tipos | | **Disponibilidade** | Por canal (WhatsApp) | Por equipe | | **Variáveis** | Sim (`{{1}}`, `{{2}}` etc.) | Sim (`{{1}}`, `{{2}}` etc.) | ## Observações importantes * Templates e respostas rápidas são criados por **administradores e gerentes** da conta * Todos os membros da equipe podem **usar** os templates e respostas rápidas disponíveis para eles * Templates aprovados ficam disponíveis para uso **imediatamente** após a aprovação * Respostas rápidas são **específicas de cada equipe** — os agentes veem apenas as respostas atribuídas à sua equipe * Ambos os tipos suportam **variáveis dinâmicas** para personalização # Adicionar usuários ao seu workspace BluBash Source: https://blubash-04458f0b.mintlify.app/pt-BR/account-settings/add-users Cadastre os membros da sua equipe no BluBash e atribua a cada pessoa o papel certo para que ela acesse a plataforma de acordo com suas responsabilidades. Adicionar sua equipe ao BluBash é o primeiro passo para colocar todos trabalhando juntos nas conversas com os clientes. Cada usuário recebe um nível específico de permissão que controla o que pode ver e fazer dentro da plataforma, mantendo seu workspace seguro e bem organizado. No menu à esquerda do BluBash, clique em **Membros**. Você verá uma lista de todos os usuários já cadastrados no seu workspace. No canto superior direito da página, selecione **Adicionar membro**. Complete os seguintes campos: * **Nome completo** — o nome da pessoa que você está adicionando. * **E-mail** — informe um endereço válido ao qual a pessoa tenha acesso. Ela receberá o convite nesse endereço. * **Papel** — escolha o nível de permissão que corresponde às responsabilidades dela: | Papel | Descrição | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | **Administrador** | Acesso total à plataforma, incluindo configurações avançadas e gestão de equipes. | | **Gerente** | Pode gerenciar equipes, ver relatórios e monitorar conversas em seu departamento. Não tem acesso a todas as funções administrativas. | | **Membro** | Perfil básico para agentes que cuidam do atendimento do dia a dia e veem apenas as próprias conversas. | Clique em **Adicionar membro**. O usuário receberá um e-mail com instruções para criar a senha e fazer login na plataforma. O novo membro agora tem acesso ao BluBash com as permissões que você atribuiu. ## Dicas importantes * Use o papel de **Administrador** apenas para usuários de confiança. * Atribua o papel de **Gerente** a líderes de equipe ou a quem precisa de acesso a relatórios. * Use o papel de **Membro** para agentes focados em tarefas diárias de atendimento e que não precisam de visibilidade sobre outras conversas. * Revise as permissões de acesso periodicamente para manter seu workspace seguro. # Campaigns API: gerencie públicos e mensagens Source: https://blubash-04458f0b.mintlify.app/pt-BR/developers/api/campaigns Adicione contatos a campanhas evergreen, agende envios por contato, cancele mensagens em fila e inspecione o status das mensagens da campanha pela API do BluBash. A Campaigns API permite gerenciar programaticamente o público e a entrega de mensagens de campanhas **evergreen** (contínuas) no seu workspace BluBash. Você pode adicionar contatos individualmente ou em massa com agendamento por contato, cancelar mensagens em fila antes de serem enviadas e inspecionar o status das mensagens em qualquer ponto do ciclo de entrega. O recurso de Campanhas precisa estar habilitado na assinatura do seu workspace para usar os endpoints de escrita. Endpoints de leitura (listar e obter mensagens) podem funcionar mesmo sem o recurso habilitado. Se você tentar uma operação de escrita sem o recurso, receberá uma resposta `403 Forbidden`. ## URL base ```text theme={null} https://api.blubash.io/api/v1/campaigns ``` ## Autenticação Todas as requisições exigem sua Workspace API Key no cabeçalho `X-API-Key`. ```http theme={null} X-API-Key: your_workspace_api_key Content-Type: application/json ``` Para obter sua chave de API, vá até **Configurações → API Keys** no painel de administração do seu workspace. ## Pré-requisitos As campanhas evergreen precisam ser criadas e configuradas na plataforma BluBash antes de você usar essa API. A API cobre apenas a ingestão de público e o disparo de mensagens. No painel de administração do BluBash, crie uma nova campanha com `kind = EVERGREEN`. Configure o canal, o template de mensagem e as regras de rate limit da campanha. Salve a campanha e copie o `campaignId` mostrado na plataforma. Você usará esse ID em todas as chamadas de API abaixo. *** ## Adicionar contatos ao público ```http theme={null} POST /api/v1/campaigns/:campaignId/audience ``` Adiciona um ou mais contatos a uma campanha e define o agendamento de envio por contato. Cada entrada no array `items` representa um contato e sua configuração de agendamento. Para adicionar um único contato, envie o array `items` com um único elemento — o endpoint é o mesmo para operações individuais e em lote. ### Corpo da requisição Um nome de fuso horário IANA (por exemplo, `America/New_York`) aplicado a todos os itens cujo `datetime` não tem offset UTC e nenhum `schedule.timezone` foi especificado. Um array de objetos de contato + agendamento. Pelo menos um item é obrigatório. O ID de um contato existente no seu workspace. Obrigatório se `identifier` não for fornecido. O identificador de canal do contato (por exemplo, um número de telefone do WhatsApp). Obrigatório se `contact_id` não for fornecido. Usado para localizar ou criar o contato. Nome de exibição do contato. Usado ao criar um novo registro de contato. Endereço de e-mail do contato. Usado para localização e criação do contato. Valores de campos personalizados como um objeto chave-valor. As chaves precisam ter o prefixo `cf_` (por exemplo, `{ "cf_plan": "pro" }`). Tags a aplicar ao contato. As tags são normalizadas automaticamente (com trim, lowercase e deduplicação) e aplicadas de forma aditiva — tags existentes não são removidas. Agendamento de envio para este contato. Padrão é `immediate` se omitido. `immediate` para enviar o quanto antes ou `absolute` para agendar para uma data e hora específicas. Datetime no formato ISO 8601. Obrigatório quando `type` for `absolute`. Se o valor incluir um offset UTC ou `Z`, o campo `timezone` é ignorado. Se não houver offset, você precisa informar `schedule.timezone` ou `default_schedule_timezone`. Nome de fuso horário IANA para converter um `datetime` sem offset UTC para UTC. ### Resolução de contato Quando você fornece `identifier` em vez de `contact_id`, a plataforma resolve o contato nesta ordem: 1. Procura o contato pelo identificador do canal (por exemplo, número de WhatsApp normalizado). 2. Se não encontrar e `email` for fornecido, busca por e-mail (sem diferenciar maiúsculas e minúsculas). * Se encontrar sem identificador de canal, vincula o `identifier` ao contato. * Se encontrar com um identificador de canal **diferente**, retorna um erro `400` para evitar fusão silenciosa de identidades. 3. Se ainda não encontrar, cria um novo contato usando `name`, `email` e `identifier`. ### Regras de agendamento | Formato do `datetime` | Comportamento | | ----------------------------------------------------------- | --------------------------------------------------------------------------------- | | Com `Z` ou offset numérico (por exemplo, `+03:00`, `-0500`) | Tratado como instante absoluto; `timezone` é ignorado | | Sem offset (por exemplo, `2026-03-11T09:00:00`) | Requer `schedule.timezone` ou `default_schedule_timezone` para conversão para UTC | Se `datetime` não tem offset UTC e nenhum fuso horário foi fornecido (em `schedule.timezone` ou `default_schedule_timezone`), a requisição retorna um erro `400`. ### Exemplo de requisição ```json theme={null} { "default_schedule_timezone": "America/New_York", "items": [ { "contact_id": "", "schedule": { "type": "immediate" } }, { "identifier": "5511999999999", "name": "Jane Smith", "email": "jane@example.com", "custom_fields": { "cf_plan": "pro", "cf_source": "api" }, "tags": ["Hot Lead", "VIP Customer"], "schedule": { "type": "absolute", "datetime": "2026-03-10T14:30:00.000Z" } }, { "contact_id": "", "schedule": { "type": "absolute", "datetime": "2026-03-11T09:00:00", "timezone": "America/New_York" } } ] } ``` ### Campos da resposta Uma entrada por item de entrada, na mesma ordem da requisição. ID da mensagem de campanha criada para este contato. ID do contato resolvido ou criado. O horário de envio agendado formatado no fuso horário IANA ou no offset fornecido. `null` para envios imediatos. O horário de envio canônico em UTC (sempre termina em `Z`). `null` para envios imediatos. O nome de fuso horário IANA (por exemplo, `America/New_York`) ou offset numérico (por exemplo, `-05:00`) usado para o agendamento. `null` para envios imediatos. ### Exemplo de resposta ```json theme={null} { "items": [ { "messageId": "", "contactId": "", "scheduled_at": null, "scheduled_at_utc": null, "timezone": null }, { "messageId": "", "contactId": "", "scheduled_at": "2026-03-10T14:30:00.000Z", "scheduled_at_utc": "2026-03-10T14:30:00.000Z", "timezone": null }, { "messageId": "", "contactId": "", "scheduled_at": "2026-03-11T09:00:00.000-05:00", "scheduled_at_utc": "2026-03-11T14:00:00.000Z", "timezone": "America/New_York" } ] } ``` *** ## Cancelar uma mensagem em fila ```http theme={null} POST /api/v1/campaigns/:campaignId/messages/:messageId/cancel ``` Cancela a entrega de uma mensagem específica de campanha que ainda está na fila. Cancelar uma mensagem não afeta nenhuma outra mensagem da campanha. Apenas mensagens com status `QUEUED` podem ser canceladas. Mensagens que já estão `SENDING`, `SENT` ou `FAILED` não podem ser canceladas. ### Resposta ```json theme={null} { "id": "", "status": "CANCELLED" } ``` *** ## Listar mensagens da campanha ```http theme={null} GET /api/v1/campaigns/:campaignId/messages?limit=50&offset=0 ``` Retorna uma lista paginada de mensagens da campanha, cada uma com seu status atual. ### Parâmetros de query Número de resultados a retornar por página. Número de resultados a pular para paginação. *** ## Obter uma mensagem específica ```http theme={null} GET /api/v1/campaigns/:campaignId/messages/:messageId ``` Retorna os detalhes e o status atual de uma única mensagem da campanha. *** ## Status das mensagens | Status | Descrição | | ----------- | ----------------------------------------- | | `PENDING` | Aguardando processamento | | `QUEUED` | Em fila para entrega — pode ser cancelada | | `SENDING` | Sendo enviada no momento | | `SENT` | Entregue com sucesso | | `FAILED` | Falha na entrega | | `CANCELLED` | Cancelada via API | *** ## Fluxo recomendado Crie uma campanha evergreen no painel de administração do BluBash e copie o `campaignId`. Chame `POST /api/v1/campaigns/:campaignId/audience` com seu array `items`. Use `schedule.type = immediate` para entrega instantânea, ou `schedule.type = absolute` com um datetime para entrega agendada. Se você precisar parar uma mensagem em fila, chame `POST /api/v1/campaigns/:campaignId/messages/:messageId/cancel`. Use `GET /api/v1/campaigns/:campaignId/messages` para inspecionar o status de entrega ao longo da campanha. *** ## Exemplos de código ```bash Immediate send (cURL) theme={null} curl -X POST https://api.blubash.io/api/v1/campaigns/{campaignId}/audience \ -H "X-API-Key: your_api_key" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "identifier": "5511999999999", "name": "Jane Smith", "tags": ["Hot Lead"], "schedule": { "type": "immediate" } } ] }' ``` ```bash Scheduled send (cURL) theme={null} curl -X POST https://api.blubash.io/api/v1/campaigns/{campaignId}/audience \ -H "X-API-Key: your_api_key" \ -H "Content-Type: application/json" \ -d '{ "default_schedule_timezone": "America/New_York", "items": [ { "contact_id": "contact_abc123", "schedule": { "type": "absolute", "datetime": "2026-04-01T10:00:00" } } ] }' ``` ```bash Batch with mixed schedules (cURL) theme={null} curl -X POST https://api.blubash.io/api/v1/campaigns/{campaignId}/audience \ -H "X-API-Key: your_api_key" \ -H "Content-Type: application/json" \ -d '{ "default_schedule_timezone": "America/New_York", "items": [ { "contact_id": "contact_001", "schedule": { "type": "immediate" } }, { "identifier": "5511888887777", "name": "Pedro Lima", "custom_fields": { "cf_plan": "enterprise" }, "tags": ["VIP Customer", "Hot Lead"], "schedule": { "type": "absolute", "datetime": "2026-04-05T09:00:00", "timezone": "America/New_York" } }, { "contact_id": "contact_003", "schedule": { "type": "absolute", "datetime": "2026-04-06T12:00:00.000Z" } } ] }' ``` ```bash Cancel a message (cURL) theme={null} curl -X POST https://api.blubash.io/api/v1/campaigns/{campaignId}/messages/{messageId}/cancel \ -H "X-API-Key: your_api_key" ``` ```bash List messages (cURL) theme={null} curl -X GET "https://api.blubash.io/api/v1/campaigns/{campaignId}/messages?limit=50&offset=0" \ -H "X-API-Key: your_api_key" ``` *** ## Referência de erros | Status | Mensagem | Causa | | ------ | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | | `400` | `Each item must provide contact_id or identifier` | Um item não tem nem `contact_id` nem `identifier` | | `400` | `Identifier is invalid` | `identifier` está vazio ou é inválido após normalização | | `400` | `schedule.timezone (IANA) is required when datetime has no UTC offset` | `datetime` não tem offset e nenhum fuso horário foi fornecido | | `400` | `Campaign is not an evergreen campaign` | O `campaignId` pertence a uma campanha não evergreen | | `400` | `Cannot add contacts to cancelled or failed campaigns` | O status da campanha é `CANCELLED` ou `FAILED` | | `400` | `Cannot add contacts while the campaign is paused. Resume the campaign first.` | O status da campanha é `PAUSED` | | `400` | `Contact found by email already has a different identifier for this campaign channel` | A busca por e-mail encontrou um contato com um identificador de canal conflitante | | `400` | `Contact does not have a valid channel identifier for this campaign channel` | O contato resolvido não tem identificador válido para o canal da campanha | | `401` | — | Chave de API ausente ou inválida | | `403` | `Campaigns feature is not available in your current plan` | O recurso de Campanhas não está habilitado na sua assinatura | | `404` | `Campaign not found` | O `campaignId` não existe no seu workspace | # POST /api/v1/channels/{channelId}/messages Source: https://blubash-04458f0b.mintlify.app/pt-BR/developers/api/channels Envie mensagens de texto, imagem, áudio, vídeo ou documento por um canal de API do BluBash. As respostas são geradas pelo agente de IA do seu workspace. A Channels API permite enviar mensagens a contatos por meio de um canal de API configurado no seu workspace. Quando você envia uma mensagem, a plataforma cria ou localiza o contato pelo `contactIdentifier`, roteia a mensagem para o seu agente de IA e retorna a resposta do agente de forma síncrona na mesma chamada de API. As conversas por um canal de API são tratadas exclusivamente por agentes de IA. Não há interface para agentes humanos participarem dessas conversas, portanto, a transferência para um humano não é suportada. ## Endpoint ```http theme={null} POST /api/v1/channels/{channelId}/messages ``` ## Autenticação Inclua sua Workspace API Key e, opcionalmente, uma chave de idempotência nos cabeçalhos da requisição. ```http theme={null} X-API-Key: your_workspace_api_key Content-Type: application/json X-Idempotency-Key: optional_key_to_prevent_duplicates ``` ## Parâmetros de path O ID do canal de API configurado no seu workspace. ## Parâmetros do corpo da requisição O tipo de mensagem. Um de: `TEXT`, `IMAGE`, `AUDIO`, `VIDEO`, `DOCUMENT`. Um identificador único para o contato. Usado para criar ou localizar o contato entre requisições. Recomendamos usar o endereço de e-mail do contato. Nome de exibição do contato. Usado ao criar um novo registro de contato. O payload da mensagem. O formato deste objeto depende do campo `type` — veja os exemplos de tipo de mensagem abaixo. Use sempre o mesmo valor de `contactIdentifier` para a mesma pessoa. Usar identificadores diferentes para o mesmo contato (por exemplo, `joao@example.com` em uma requisição e `user@example.com` em outra) cria registros de contato separados e quebra o histórico da conversa. ## Tipos de mensagem ### Texto ```json request theme={null} { "content": { "text": { "body": "Hello, how can I help you?" } }, "type": "TEXT", "contactIdentifier": "user@example.com", "contactName": "User Name" } ``` ```json response theme={null} { "success": true, "contactId": "cmg5gdkb60000sb75h4yu6mam", "conversationId": "cmg6etn5u000dsbx2htkjot8r", "messageId": "cmg6zqegm0001sbw9ip35juiq", "conversation": { "status": "ACTIVE", "assignedToHuman": false, "aiAgentId": "cmdi03x0z0003sbz6ubwtdrml", "aiAgentName": "Aurora", "teamId": "0fb043a2-75f7-42d7-b542-1ffcc1f75ccf", "teamName": "Technical Support" }, "aiMessages": [ { "content": { "text": { "body": "Hello! How can I help you today?" }, "type": "text" }, "type": "TEXT", "sender_type": "AI", "sender_name": "Aurora", "channel_message_id": null } ], "usage": { "credits": 1 } } ``` ### Imagem ```json request theme={null} { "content": { "image": { "url": "https://example.com/image.jpg", "caption": "Image caption" } }, "type": "IMAGE", "contactIdentifier": "user@example.com" } ``` ```json response theme={null} { "success": true, "contactId": "cmg5gdkb60000sb75h4yu6mam", "conversationId": "cmg6etn5u000dsbx2htkjot8r", "messageId": "cmg6zqegm0001sbw9ip35juiq", "conversation": { "status": "ACTIVE", "assignedToHuman": false, "aiAgentId": "cmdi03x0z0003sbz6ubwtdrml", "aiAgentName": "Aurora", "teamId": "0fb043a2-75f7-42d7-b542-1ffcc1f75ccf", "teamName": "Technical Support" }, "aiMessages": [ { "content": { "text": { "body": "I see an interesting image! How can I help you with that?" }, "type": "text" }, "type": "TEXT", "sender_type": "AI", "sender_name": "Aurora", "channel_message_id": null } ], "usage": { "credits": 1 } } ``` ### Áudio ```json request theme={null} { "content": { "audio": { "url": "https://example.com/audio.mp3" } }, "type": "AUDIO", "contactIdentifier": "user@example.com" } ``` ```json response theme={null} { "success": true, "contactId": "cmg5gdkb60000sb75h4yu6mam", "conversationId": "cmg6etn5u000dsbx2htkjot8r", "messageId": "cmg6zqegm0001sbw9ip35juiq", "conversation": { "status": "ACTIVE", "assignedToHuman": false, "aiAgentId": "cmdi03x0z0003sbz6ubwtdrml", "aiAgentName": "Aurora", "teamId": "0fb043a2-75f7-42d7-b542-1ffcc1f75ccf", "teamName": "Technical Support" }, "aiMessages": [ { "content": { "text": { "body": "Audio transcription: Hello, I need help with my order" }, "type": "text" }, "type": "TEXT", "sender_type": "AI", "sender_name": "Aurora", "channel_message_id": null } ], "usage": { "credits": 1 } } ``` ### Vídeo ```json request theme={null} { "content": { "video": { "url": "https://example.com/video.mp4", "caption": "Video caption" } }, "type": "VIDEO", "contactIdentifier": "user@example.com" } ``` ```json response theme={null} { "success": true, "contactId": "cmg5gdkb60000sb75h4yu6mam", "conversationId": "cmg6etn5u000dsbx2htkjot8r", "messageId": "cmg6zqegm0001sbw9ip35juiq", "conversation": { "status": "ACTIVE", "assignedToHuman": false, "aiAgentId": "cmdi03x0z0003sbz6ubwtdrml", "aiAgentName": "Aurora", "teamId": "0fb043a2-75f7-42d7-b542-1ffcc1f75ccf", "teamName": "Technical Support" }, "aiMessages": [ { "content": { "text": { "body": "I received your video! How can I help you with that?" }, "type": "text" }, "type": "TEXT", "sender_type": "AI", "sender_name": "Aurora", "channel_message_id": null } ], "usage": { "credits": 1 } } ``` ### Documento ```json request theme={null} { "content": { "document": { "url": "https://example.com/document.pdf", "filename": "document.pdf", "caption": "Document description" } }, "type": "DOCUMENT", "contactIdentifier": "user@example.com" } ``` ```json response theme={null} { "success": true, "contactId": "cmg5gdkb60000sb75h4yu6mam", "conversationId": "cmg6etn5u000dsbx2htkjot8r", "messageId": "cmg6zqegm0001sbw9ip35juiq", "conversation": { "status": "ACTIVE", "assignedToHuman": false, "aiAgentId": "cmdi03x0z0003sbz6ubwtdrml", "aiAgentName": "Aurora", "teamId": "0fb043a2-75f7-42d7-b542-1ffcc1f75ccf", "teamName": "Technical Support" }, "aiMessages": [ { "content": { "text": { "body": "I received your document! How can I help you with that?" }, "type": "text" }, "type": "TEXT", "sender_type": "AI", "sender_name": "Aurora", "channel_message_id": null } ], "usage": { "credits": 1 } } ``` ## Campos da resposta Indica se a operação foi bem-sucedida. O ID único do contato criado ou correspondido pelo `contactIdentifier`. O ID único da conversa. O ID único da mensagem que foi enviada. Detalhes sobre a conversa e sua atribuição. Status atual da conversa (por exemplo, `ACTIVE`). Se a conversa está atribuída a um agente humano. ID do agente de IA que está cuidando da conversa. Nome de exibição do agente de IA. ID da equipe à qual a conversa pertence. Nome de exibição da equipe. As mensagens de resposta do agente de IA, ordenadas de forma ascendente (primeiro as mais antigas). Trata-se de um array porque a IA pode dividir sua resposta em várias mensagens sequenciais. Informações de consumo de créditos. Número de créditos consumidos por esta requisição. ## Códigos de status HTTP | Código | Descrição | | ------ | ----------------------------------------------------- | | `200` | Sucesso — mensagem processada | | `400` | Dados inválidos da requisição ou canal não encontrado | | `401` | Chave de API ausente ou inválida | | `404` | Canal não encontrado | | `500` | Erro interno do servidor | ## Exemplos de integração ```javascript JavaScript (Fetch) theme={null} async function sendMessage(channelId, apiKey, message) { const response = await fetch(`/api/v1/channels/${channelId}/messages`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-API-Key': apiKey }, body: JSON.stringify({ content: { text: { body: message } }, type: 'TEXT', contactIdentifier: 'user@example.com' }) }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${response.statusText}`); } return await response.json(); } try { const result = await sendMessage('channel_123', 'your_api_key', 'Hello!'); console.log('Message sent:', result); } catch (error) { console.error('Error:', error); } ``` ```python Python theme={null} import requests def send_message(channel_id, api_key, message_data): url = f"https://your-domain.com/api/v1/channels/{channel_id}/messages" headers = { 'Content-Type': 'application/json', 'X-API-Key': api_key } response = requests.post(url, headers=headers, json=message_data) if response.status_code == 200: return response.json() else: raise Exception(f"HTTP {response.status_code}: {response.text}") message_data = { "content": { "text": { "body": "Hello, I need help!" } }, "type": "TEXT", "contactIdentifier": "customer@example.com", "contactName": "John Smith" } try: result = send_message('channel_123', 'your_api_key', message_data) print('Message sent:', result) except Exception as e: print('Error:', e) ``` ```bash cURL theme={null} curl -X POST "https://your-domain.com/api/v1/channels/channel_123/messages" \ -H "Content-Type: application/json" \ -H "X-API-Key: your_api_key" \ -d '{ "content": { "text": { "body": "Hello, I need help!" } }, "type": "TEXT", "contactIdentifier": "customer@example.com", "contactName": "John Smith" }' ``` ## Limitações * **Apenas IA**: As conversas são exclusivas dos agentes de IA — a transferência para agente humano não está disponível. * **`contactIdentifier` consistente**: Use sempre o mesmo valor para o mesmo contato. Recomendamos usar o endereço de e-mail do contato. * **URLs de mídia públicas**: As URLs de imagem, áudio, vídeo e documento precisam estar acessíveis publicamente. * **Limite de tamanho de arquivo**: Máximo de 10 MB por arquivo. * **Timeout de download**: Downloads de mídia têm timeout de 30 segundos. * **Idempotência**: Use `X-Idempotency-Key` para evitar mensagens duplicadas em requisições reenviadas. # API do BluBash: autenticação e primeiros passos Source: https://blubash-04458f0b.mintlify.app/pt-BR/developers/introduction Tudo o que você precisa para integrar sua aplicação ao BluBash — autenticação, APIs disponíveis e dicas práticas para desenvolvedores. A API do BluBash permite conectar sua aplicação diretamente à plataforma para enviar mensagens por meio de canais, gerenciar públicos de campanha e automatizar fluxos de comunicação com clientes. Todo acesso à API é autenticado com uma Workspace API Key obtida no painel de administração. ## APIs disponíveis Envie mensagens de texto, imagem, áudio, vídeo e documento por um canal de API configurado. As respostas são tratadas pelo agente de IA do seu workspace. Adicione contatos a campanhas evergreen individualmente ou em massa, agende envios por contato, cancele mensagens em fila e inspecione o status das mensagens. ## Autenticação Toda requisição à API do BluBash precisa incluir sua **Workspace API Key** no cabeçalho `X-API-Key`. ```http theme={null} X-API-Key: your_workspace_api_key Content-Type: application/json ``` Mantenha sua chave de API em segredo. Nunca a exponha em código no cliente ou em repositórios públicos. Trate-a com o mesmo cuidado de uma senha. ### Obter sua chave de API Faça login no BluBash e navegue até o seu workspace. Encontre a seção API Keys dentro das configurações do workspace. Crie uma nova chave ou copie uma existente para usar nas suas requisições. ## Idempotência Para evitar mensagens duplicadas ao reenviar requisições com falha, inclua o cabeçalho opcional `X-Idempotency-Key` com um valor único por requisição. ```http theme={null} X-Idempotency-Key: your_unique_idempotency_key ``` Use um UUID ou um hash derivado do payload da requisição como chave de idempotência, para que a mesma operação lógica nunca seja processada duas vezes. ## Dicas para desenvolvedores * Use sempre o mesmo valor de `contactIdentifier` para o mesmo contato, para evitar criar duplicatas. * Implemente um tratamento adequado de erros para respostas HTTP de erro (`400`, `401`, `404`, `500`). * Teste integrações em um ambiente de desenvolvimento antes de apontar tráfego para produção. * Respeite os limites de taxa da API — configure sua lógica de retry com backoff exponencial. ## Suporte Se precisar de ajuda, entre em contato com a equipe de suporte do BluBash em [suporte@blubash.io](mailto:suporte@blubash.io).