# Bem-vindo Seja bem-vindo à **Hablla Docs**! Este é o seu ponto de referência para explorar e maximizar todas as funcionalidades que o Hablla oferece. Nossa documentação foi cuidadosamente elaborada para guiá-lo desde as configurações iniciais até a implementação de soluções avançadas, garantindo que você aproveite ao máximo nossa plataforma.​ **O que você encontrará aqui:** * **Configurações:** Aprenda a criar sua conta, verificar sua Business Manager na Meta e configurar seu workspace, equipe, setores e integrações com diversas plataformas como WhatsApp, Facebook, Telegram, E-mail e Instagram.​ * **Marketing:** Descubra como utilizar ferramentas de SEO, criar formulários, construir páginas personalizadas, gerenciar links curtos, segmentar seu público e realizar disparos em massa.​ * **Atendimento:** Gerencie históricos de atendimentos e construa uma base de conhecimento sólida para sua equipe.​ * **Vendas:** Organize e gerencie seus produtos de forma eficiente.​ * **CS/CX:** Melhore a experiência do cliente com estratégias eficazes de sucesso do cliente.​ * **Desempenho:** Defina metas e acompanhe o desempenho de sua equipe e operações.​ * **Chat:** Comunique-se de forma eficaz com atendimentos, usuários e grupos.​ * **Dados:** Gerencie informações de pessoas, organizações, tarefas e cartões.​ * **Fluxos de Automações:** Aprofunde-se no **Hablla Studio** e descubra como os componentes podem automatizar e otimizar seus processos.​ * **Relatórios:** Acesse relatórios detalhados para insights aprofundados.​ * **API:** Integre e expanda as funcionalidades do Hablla conforme suas necessidades específicas.​ Estamos comprometidos em fornecer a você um serviço excepcional e personalizado. Nossa equipe está pronta para atender às suas necessidades e ajudá-lo a alcançar seus objetivos. Explore nossa documentação e descubra como o Hablla pode transformar a maneira como você se comunica e gerencia suas operações.​ Caso tenha dúvidas ou precise de suporte adicional, não hesite em nos contatar. Estamos aqui para ajudar! # Contribua conosco Na Hablla acreditamos que a construção de conhecimento é colaborativa. Se você sentiu falta de alguma explicação, caso de uso ou deseja sugerir melhorias na nossa documentação, utilize o formulário abaixo para enviar sua solicitação. A documentação da **Hablla** está em constante evolução. Nosso ecossistema é **abrangente** e está sempre em expansão, e nem todas as funcionalidades e casos de uso estão documentados ainda. Para nos ajudar a priorizar as áreas mais relevantes, disponibilizamos um formulário onde você pode solicitar **novos conteúdos, melhorias em materiais existentes ou exemplos de casos de uso**.\ Sua contribuição orienta nosso roadmap editorial e garante que os temas mais demandados recebam prioridade na documentação. Sua contribuição nos ajuda a manter a **Documentação Hablla** sempre atualizado, prático e alinhado às necessidades reais do ecossistema. > 💡 **Ajude a melhorar nossa documentação**\ > Clique no botão abaixo para abrir o formulário de solicitações: > > [![Abrir formulário](https://img.shields.io/badge/Hablla-Formul%C3%A1rio-blue?style=for-the-badge)](https://forms.hablla.com/68aaeb0866eab34182c38700/) # Configurações # Criando Sua Conta Crie sua conta gratuita na Hablla e acesse o Studio. Preencha seus dados, verifique o e-mail e comece a explorar todos os módulos disponíveis. {% embed url="" %} O primeiro passo para começar a usar a Hablla é criar sua conta. Mesmo que você já tenha contratado um plano, o processo inicial é sempre o mesmo: **você começa criando uma conta gratuita (free)** e, a partir dela, pode migrar para o plano contratado. O fluxo de criação é simples, intuitivo e foi desenhado para garantir segurança e padronização no acesso. *** ### Como criar sua conta 1. **Acesse a tela de criação de conta** * Clique no botão **“Criar sua conta grátis”** disponível no site da Hablla. * Você será direcionado para o endereço do **Hablla Studio**: ``` https://studio.hablla.com ``` 2. **Escolha o método de login** * Você pode optar por diferentes formas de autenticação (ex.: login com Google ou criação manual). * No exemplo do vídeo, o login foi feito de forma manual, utilizando um e-mail novo. 3. **Preencha os dados de cadastro** * Informe um endereço de e-mail válido. * Crie uma senha seguindo os critérios de segurança: * Pelo menos **1 letra maiúscula** * Pelo menos **1 letra minúscula** * Pelo menos **1 número** * Pelo menos **1 caractere especial** (ex.: @, #, !) * Mínimo de **8 caracteres** > Se a senha atender a todos os requisitos, o sistema permitirá avançar. 4. **Configuração inicial** * Após confirmar o cadastro, o sistema cria automaticamente sua conta. * Você receberá um e-mail de verificação. É necessário acessá-lo e confirmar para validar sua conta. 5. **Primeiro acesso** * Com a conta criada e verificada, você pode acessar o **Hablla Studio** e começar a configurar seu workspace. * A partir daí, já é possível explorar os módulos de Marketing, Atendimento, Vendas, CS/CX e Desempenho. *** ### Resumo Criar uma conta na Hablla é rápido e seguro. Em poucos minutos você terá acesso ao **Hablla Studio**, com todas as funcionalidades disponíveis em sua versão gratuita. Esse processo garante que todos os usuários — novos ou de planos contratados — tenham um ponto de partida comum, simplificando a jornada de onboarding e a experiência com a plataforma. # Verificando sua BM na Meta A verificação da BM da Meta é obrigatória para usar o WhatsApp Oficial. Saiba como iniciar e concluir o processo dentro do Business Manager. {% embed url="" %} ## Verificar a BM (Business Manager) da Meta A verificação da **Business Manager (BM) da Meta** é um passo essencial para configurar o **WhatsApp Oficial** na Hablla.\ Sem uma BM verificada, não é possível habilitar e operar o WhatsApp dentro da plataforma. *** ### O que é a BM da Meta? A **Business Manager (BM)** é a central de negócios da Meta (Facebook), onde você gerencia ativos como: * Contas de anúncios * Páginas do Facebook * Perfis comerciais do Instagram * Contas de WhatsApp Business Somente com uma BM verificada você pode ativar o **WhatsApp Business API Oficial** usado pela Hablla. *** ### Passo a passo para verificar a BM 1. **Acesse o Business Manager** * Vá até [business.facebook.com](https://business.facebook.com). * Se você já possui uma BM, ela aparecerá no painel do lado direito, listando suas contas. 2. **Verifique o status da sua BM** * Entre em **Configurações** > **Central de Segurança**. * Verifique a seção de **Verificação da Empresa**. * O sistema pode mostrar três status possíveis: * **Não se qualifica para verificação** * **Iniciar verificação** * **Verificada** 3. **Se não se qualificar para verificação** * Abra uma nova aba e acesse [developers.facebook.com](https://developers.facebook.com). * Faça login com o seu perfil do Facebook. * Crie uma conta de desenvolvedor, caso ainda não tenha. * Após ativar a conta de desenvolvedor, volte ao **Business Manager**: a opção de iniciar a verificação deve aparecer. 4. **Iniciar o processo de verificação** * Clique em **Iniciar verificação**. * Será necessário fornecer informações da sua empresa: * Nome legal da empresa * CNPJ ou documento oficial de registro * Endereço completo * Telefone comercial válido > A Meta pode enviar um código de validação por telefone ou e-mail corporativo. 5. **Aguardar a análise da Meta** * O processo de análise pode levar alguns dias. * Assim que concluído, o status será atualizado para **Verificada**. *** ### Resumo * A verificação da BM é **obrigatória** para usar o WhatsApp Oficial dentro da Hablla. * Se sua conta mostrar **“não se qualifica para verificação”**, crie primeiro uma conta no **Facebook Developers**. * Somente após a BM estar **Verificada**, você poderá conectar seu número de WhatsApp na Hablla. *** 📌 **Dica prática**: recomendamos que a verificação seja feita com **e-mail corporativo** (ex.: ) para acelerar a aprovação junto à Meta. # Workspace Visualize tarefas, atendimentos, oportunidades e tickets em um só lugar. O Dashboard da Hablla centraliza indicadores e prioridades do dia. {% embed url="" %} ## Configurar o Workspace na Hablla Depois de verificar (ou iniciar o processo de verificação) da sua **BM da Meta**, o próximo passo é configurar o seu **Workspace na Hablla**.\ O Workspace é o **ambiente principal de trabalho da sua empresa dentro da plataforma**, reunindo identidade visual, dados básicos e preferências globais. *** ### Acessando as configurações do Workspace 1. No menu superior, clique no ícone da **engrenagem** ⚙️. 2. Você será direcionado para a tela de configurações do seu **Workspace**. *** ### Personalizando o Workspace Na tela de configuração, você pode preencher ou alterar os seguintes campos: * **Logotipo da empresa**: personalize com a identidade visual do seu negócio. * **Nome da empresa**: título oficial que será exibido. * **Descrição**: breve apresentação da sua empresa. * **Site oficial**: URL principal do seu negócio. * **Redes sociais**: links para os perfis corporativos (Facebook, Instagram, LinkedIn etc.). * **Moeda padrão**: escolha a moeda que será utilizada para relatórios e indicadores. > Mesmo que alguns dados já tenham sido configurados na criação da conta, você pode alterá-los ou atualizar sempre que necessário. Após preencher os campos, clique em **Salvar** para aplicar as alterações. *** ### Editando seu perfil de usuário Além das informações gerais da empresa, é possível configurar o **perfil de cada usuário** do Workspace: 1. Clique no ícone de perfil no canto da tela. 2. Edite informações como: * **Nome do usuário** * **Imagem de perfil** (foto ou avatar) Essas informações ficam disponíveis para todos dentro do Workspace, ajudando na identificação dos membros da equipe. *** ### Resumo O **Workspace da Hablla** é a base de identidade e organização da sua operação.\ Com ele você: * Define a identidade visual da sua empresa dentro da plataforma. * Mantém informações institucionais sempre atualizadas. * Configura preferências globais, como moeda padrão. * Personaliza o perfil de cada usuário para fortalecer a colaboração. *** 📌 **Dica prática**: recomendamos subir o **logotipo em alta resolução** e preencher todos os campos institucionais, pois isso facilita integrações, relatórios e a consistência da comunicação da sua empresa. # Time Adicione membros ao seu Workspace na Hablla, convide por e-mail, defina permissões e garanta acesso seguro e colaborativo para sua equipe. {% embed url="" %} ## Adicionar seu Time na Hablla Para que sua empresa utilize a Hablla de forma colaborativa, é essencial adicionar os membros do seu **time** ao Workspace. Cada pessoa convidada terá um login próprio e poderá acessar a plataforma de acordo com as permissões atribuídas. *** ### Acessando a área de Time 1. No topo do **Workspace**, clique na aba **Time**. 2. Essa área é destinada à gestão de usuários da sua empresa dentro da Hablla. *** ### Convidando um novo membro 1. Clique em **Adicionar novo membro**. 2. Preencha os seguintes campos: * **E-mail** do colaborador (necessário para o convite). * **Nome** completo. * **Telefone** (opcional, mas recomendado). 3. Defina o nível de acesso: * **Administrador**: tem acesso total às configurações e gestão da conta. * **Usuário comum**: acesso restrito apenas às funções operacionais. 4. Clique em **Enviar convite**. * O sistema confirmará com a mensagem: *“Convite enviado com sucesso”*. *** ### Aceitando o convite 1. O convidado receberá um e-mail da Hablla. 2. Nesse e-mail haverá um link de **verificação**. 3. O usuário deve clicar no link para validar o e-mail e ativar a conta. 4. Após a confirmação, a pessoa poderá acessar normalmente a Hablla com seu login. *** ### Resumo O recurso de **Time na Hablla** permite: * Adicionar e gerenciar membros da sua empresa. * Definir permissões e papéis (administrador ou usuário comum). * Garantir que cada colaborador tenha acesso seguro e individualizado à plataforma. *** 📌 **Dica prática**: use e-mails corporativos para os convites, garantindo maior segurança e padronização no ambiente de trabalho. # Setores Organize o atendimento na Hablla com Setores: defina equipes, horários, SLAs e transfira conversas para humanos de forma eficiente e estruturada. {% embed url="" %} ## Setores na Hablla Os **Setores** organizam o atendimento da sua empresa dentro da Hablla.\ Eles definem **quem atende, quando atende e como o atendimento deve ser transferido entre pessoas e equipes**. Criar setores é fundamental para estruturar fluxos, distribuir responsabilidades e configurar regras de transbordo para atendimentos humanos. *** ### O que são Setores? Um **Setor** é uma área funcional da sua empresa dentro da Hablla.\ Exemplos comuns de setores: * Atendimento * Comercial * Financeiro * Suporte Técnico Cada setor pode ter usuários atribuídos, horários de funcionamento e regras próprias de SLA (Acordo de Nível de Serviço). *** ### Funções principais dos Setores 1. **Definir equipe de atendimento** * Cada setor reúne os usuários responsáveis por responder e acompanhar os atendimentos daquela área. * Isso garante que o cliente sempre fale com a equipe correta. 2. **Configurar transferências para humanos** * O componente **Transfer** direciona a conversa para um atendente humano. * Esse direcionamento só funciona corretamente quando está associado a um setor. 3. **Organizar horários de atendimento** * Cada setor pode ter um **horário comercial** definido. * Exemplo: o setor Comercial pode atender apenas de segunda a sexta, das 9h às 18h. * Fora desse horário, os fluxos podem direcionar mensagens automáticas ou filas de espera. 4. **Gerenciar SLAs** * Configure prazos de resposta e de resolução para cada setor. * Exemplo: o setor Financeiro pode ter SLA de 24h para responder solicitações, enquanto o Suporte Técnico pode ter SLA de 4h. *** ### Como criar um Setor 1. No menu superior do Workspace, clique em **Setores**. 2. Clique em **Criar novo setor**. 3. Preencha as informações: * **Nome do setor** (ex.: Comercial, Atendimento, Financeiro). * **Descrição** (breve explicação da função do setor). * **Usuários atribuídos** (quem fará parte desse setor). * **Horário de funcionamento** (opcional no momento da criação, pode ser configurado depois). * **Regras de SLA** (se aplicável). 4. Clique em **Salvar** para concluir. *** ### Resumo Os setores são a base para organizar atendimentos e fluxos humanos na Hablla.\ Com eles você pode: * Direcionar conversas para as equipes corretas. * Garantir transferências eficientes para humanos. * Definir horários de atendimento e SLAs específicos. * Estruturar melhor a operação de Marketing, Vendas, CS e Suporte. *** 📌 **Dica prática**: crie setores alinhados com a estrutura real da sua empresa. Isso facilita a gestão e melhora a experiência do cliente, já que cada área terá regras e responsáveis bem definidos. # Como configurar Setores dentro da Hablla Os setores no Hablla são essenciais para organizar o atendimento e direcionar interações para as equipes mais apropriadas, garantindo uma categorização especializada que torna o atendimento mais ágil e preciso. Abaixo está o passo a passo para configurar setores de maneira eficiente. \ Importante: para essa ação você precisa ter um usuário com acesso Administrador.
1. Já conectado em sua conta, acesse o [Studio](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de Configurações (engrenagem). Clique nele para abrir o menu de configurações.

2\. No menu de configurações à esquerda, selecione Setores para acessar as opções de configuração.\ \ 3\. Selecione o Setor para Configurar
Escolha o setor que foi criado, mas ainda não configurado, para iniciar as personalizações.\ \ \ 4\. Personalize Nome, Descrição, Cor e Horário Comercial
* A partir deste ponto, você pode editar o nome e a descrição do setor, além de definir uma cor para identificação visual. * Defina o Horário Comercial pré-definido, que pode ser ajustado conforme as necessidades do seu setor (saiba mais sobre a configuração de horários aqui).\ \ 4.1 Adicionar E-mail do Setor * Configure o e-mail para que, ao enviar mensagens, o atendimento utilize um endereço de e-mail específico do setor. * Exemplo: .
6 Identificação do Atendente * Defina se o nome do atendente será exibido nas conversas com o cliente, personalizando ainda mais a comunicação.\
6.1 Configurações de Algoritmo de Transbordo * Configure o encaminhamento automático para garantir que o atendimento siga uma lógica eficaz e contínua. ### Algoritmos de transbordo O algoritmo de transbordo define **como a fila de distribuição escolhe o próximo atendente** que receberá um novo item. Cada algoritmo possui uma estratégia diferente de balanceamento, permitindo adaptar a distribuição de acordo com a necessidade da operação.
AlgoritmoComo funcionaQuando utilizar
Fila SequencialDistribui os itens em ordem fixa entre os atendentes da fila. Após o último atendente receber um item, a distribuição reinicia pelo primeiro da lista.Ideal quando todos os atendentes possuem a mesma capacidade e você deseja uma distribuição previsível e equilibrada.
Menor quantidade de atendimentos no diaDireciona o próximo item para o atendente que recebeu menos atendimentos durante o dia, equilibrando o volume distribuído diariamente.Recomendado para operações que desejam manter uma divisão justa da carga diária entre todos os atendentes.
Menor quantidade de atendimentos abertosEncaminha o item para o atendente que possui menos atendimentos em aberto no momento da distribuição.Indicado quando o objetivo é distribuir a carga de trabalho considerando apenas os atendimentos ainda em andamento.
Menor quantidade de atendimentos abertos com limiteFunciona da mesma forma que o algoritmo anterior, porém respeita um limite máximo de atendimentos simultâneos por atendente. Quando o limite é atingido, o atendente deixa de participar da distribuição até que volte a ficar abaixo do limite.Ideal para evitar sobrecarga dos atendentes e controlar a quantidade máxima de atendimentos simultâneos.

⚠️ Importante: Este algoritmo funciona apenas para usuários que utilizam Permissões Personalizadas, pois o limite de atendimentos é configurado na permissão do usuário. Consulte a documentação de Permissões Personalizadas para configurar esse limite.
AleatórioSeleciona aleatoriamente um dos atendentes disponíveis na fila para receber o próximo item.Recomendado quando não há necessidade de seguir uma ordem específica ou balanceamento baseado em carga.
Peso por AtendentesDistribui os itens considerando o peso configurado para cada atendente. Quanto maior o peso, maior será a probabilidade de aquele atendente receber novos itens.Indicado para equipes onde alguns atendentes possuem maior capacidade, experiência ou disponibilidade e, por isso, devem receber um volume maior de atendimentos.
6.2 Configurações de SLA * Personalize o SLA (Acordo de Nível de Serviço) para atender às expectativas do cliente e garantir respostas rápidas e eficazes. (Saiba mais sobre as configurações de SLA aqui).
7\. Definir Regras de Motivos de Finalização * Especifique regras para registrar o motivo de cada atendimento encerrado, arquivado ou transferido: * Atendimento Encerrado: Selecione o motivo para encerrar o atendimento. * Atendimento Arquivado: Defina o motivo ao arquivar. * Atendimento Transferido: Motivo ao transferir para outro agente. * Manter Dono: Escolha se o agente atual permanecerá responsável pelo cliente após o encerramento do atendimento. * Notificação de Status: Configure notificações para que o cliente seja informado sobre mudanças de status, como mensagens lidas.\ \ 8\. Adicionar sua Equipe ao Setor
* Volte ao topo da tela e clique em Equipe de Atendimento para associar sua equipe ao setor.\ \ 9\. Clique em adicionar um novo usuário\ \ 10\. Adicionar Novo Usuário ao Setor
* Selecione Adicionar novo usuário para incluir membros que terão acesso ao setor. Escolha entre: * Permissão de Acesso: Usuários com acesso às informações do setor. * Atendentes: Usuários que estarão na fila de atendimento e lidarão diretamente com as interações.\ \ 11 . Após personalizar as configurações, clique em Salvar.
### Configurando o Peso de Atendentes do setor O peso do atendente é utilizado pelo algoritmo **Peso por Atendentes** para definir a prioridade de cada usuário na distribuição de novos atendimentos. Quanto maior o peso configurado, maior será a probabilidade de aquele atendente receber novos atendimentos. #### 1. Selecione o atendente Na tela de **Equipe de Atendimento**, clique sobre o nome do atendente que deseja configurar.
#### 2. Defina a prioridade {% hint style="info" %} :warning: **Observação:** O peso é utilizado apenas pelo algoritmo **Peso por Atendentes**. Quanto maior o peso configurado, maior será a prioridade do atendente na distribuição de novos atendimentos. {% endhint %} Ao selecionar o atendente, será exibido um painel lateral com suas configurações. Localize o campo **Prioridade** e informe um **valor inteiro entre 1 e 5**, conforme a tabela abaixo:
#### Níveis de Pesos por Atendentes disponíveis:
PesoComportamento
1Menor prioridade de distribuição. O atendente receberá menos atendimentos.
2Prioridade baixa. O atendente receberá uma quantidade menor de atendimentos em relação aos usuários com pesos superiores.
3Prioridade intermediária. A distribuição ocorrerá de forma equilibrada em relação aos demais atendentes.
4Prioridade alta. O atendente receberá mais atendimentos do que aqueles com pesos inferiores.
5Maior prioridade de distribuição. O atendente receberá a maior quantidade de atendimentos em relação aos demais usuários da fila.
#### 3. Salve a configuração Após definir a prioridade desejada, clique no botão **Salvar**, localizado no canto superior direito da tela. {% hint style="info" %} O peso **não representa um limite de atendimentos**. Ele apenas influencia a prioridade na distribuição quando o algoritmo **Peso por Atendentes** estiver configurado na fila. {% endhint %} # Conexões e Integrações # WhatsApp Configure o WhatsApp Oficial na Hablla com BM verificada, nome de exibição correto e site validado para garantir integração segura e aprovada pela Meta. {% embed url="" %} ## Configurar o WhatsApp na Hablla Após verificar sua **Business Manager (BM) da Meta**, você pode configurar o **WhatsApp Oficial** na Hablla.\ Essa integração é essencial para que sua empresa utilize o **WhatsApp Business API** de forma oficial e segura. *** ### Pré-requisitos Antes de iniciar a configuração, certifique-se de que: * Sua **BM está verificada** ou em processo de verificação. * Você possui acesso ao site oficial da sua empresa com CNPJ no rodapé. * O **nome de exibição do WhatsApp** corresponde exatamente ao nome da empresa verificado na BM. > ⚠️ Se o nome for diferente, será necessário ter um site que comprove a relação entre o nome exibido e o nome legal da empresa. *** ### Passo a passo para configurar 1. **Acesse o painel do WhatsApp na Hablla** * No menu de configurações, clique em **WhatsApp**. * Escolha a opção **Criar nova conta**. 2. **Crie um novo perfil** * Informe o **nome da conta** (esse nome será usado apenas dentro da sua BM). * Defina o **nome de exibição do WhatsApp**: * Esse nome deve representar exatamente sua empresa. * Se a BM estiver em nome de “Hablla Serviços Digitais Ltda”, o WhatsApp deve seguir a mesma regra. 3. **Validação do site** * Para confirmar a verificação, é necessário ter um **site da empresa ativo**. * O rodapé do site deve conter: * Nome da empresa completo. * CNPJ válido. * Exemplo: ``` Este site pertence à Empresa X Serviços Digitais Ltda. | CNPJ: 00.000.000/0000-00 ``` 4. **Avançar para a verificação da Meta** * A Hablla conectará automaticamente sua conta ao **Business Manager da Meta**. * A Meta verificará se o nome, CNPJ e domínio estão consistentes. *** ### Nome de Exibição (Display Name) O nome exibido no WhatsApp deve: * Representar claramente sua empresa. * Estar alinhado ao nome legal da empresa registrado na BM. * Estar visível em seu site oficial. > Exemplo: se sua empresa legal é **Hablla Serviços Digitais Ltda**, o display name pode ser “Hablla”.\ > Se deseja usar “Habllando”, precisa ter um site h**abllando.com.br** vinculado e validado. *** ### Resumo Configurar o WhatsApp Oficial na Hablla garante: * Integração direta com a API oficial da Meta. * Validação do nome e da marca da empresa. * Segurança e confiabilidade no uso do WhatsApp Business. *** 📌 **Dica prática**: garanta que seu site contenha o nome legal da empresa e CNPJ no rodapé. Isso acelera a aprovação junto à Meta e evita rejeições no processo. # Passo a Passo Configurar o WhatsApp no Hablla é um processo simples e eficaz que permitirá à sua empresa se conectar com os clientes de forma ágil e profissional. Para facilitar a sua compreensão, dividimos o processo em três etapas principais: * Primeira etapa- Conexão no Hablla * Segunda etapa- Conexão na Meta * Terceira etapa- Ativando o número no Hablla ### **O que você precisa antes de começar?** Antes de iniciar o processo de configuração, é fundamental garantir que alguns pré-requisitos estejam atendidos para evitar erros e atrasos. Para facilitar esse processo, criamos um checklist detalhado (veja a seguir), que abrange tudo o que é necessário para a integração ser bem-sucedida: 1. **Criar um** [**Setor**](https://docs.google.com/document/d/1aq2mB02UO2RsT9YMalaXGEMrEV-RN1V2AtvNfseUw0M/edit?fbp=fb.1.1750773282927.8266088573585080\&sck=a62d3376-49e7-43d6-a994-af1e2bb75c92\&external_id=a62d3376-49e7-43d6-a994-af1e2bb75c92) **no Hablla:** criar um setor no Hablla é fundamental para organizar e categorizar as interações da sua empresa com os clientes.
2. **Número de Telefone Ativo:** o número de telefone que você planeja usar para o WhatsApp Business deve estar **ativo**, pronto para receber **chamadas** e **SMS**. isso é essencial, pois o WhatsApp envia mensagens de confirmação durante a configuração. **Por que é importante**: se o número não estiver ativo ou configurado para receber mensagens, você não conseguirá concluir o processo de verificação do WhatsApp. 3. **Gerenciador de Negócios da Meta:** sua empresa deve ter uma **conta ativa no Gerenciador de Negócios da Meta (Facebook)**. Se ainda não tiver, será necessário criá-la. Certifique-se de que você tem **acesso como administrador** a essa conta. **Por que é importante**: o WhatsApp Business API utiliza a infraestrutura da Meta para funcionar. Sem um Gerenciador de Negócios configurado corretamente, não será possível concluir a integração com o Hablla. 4. **Perfil Pessoal no Facebook:** certifique-se de que você possui um **perfil pessoal no Facebook** e que esse perfil tem **permissões de administrador** dentro do Gerenciador de Negócios da Meta. **Por que é importante**: apenas administradores do Gerenciador de Negócios podem concluir a integração com o WhatsApp Business API. Um perfil sem as permissões adequadas não poderá finalizar o processo. 5. **Número Exclusivo para WhatsApp Business:** o número que você pretende usar para o WhatsApp Business não pode estar vinculado a nenhuma outra conta do WhatsApp (incluindo o aplicativo comum de WhatsApp ou WhatsApp Web). Se estiver, você precisará **desvincular ou excluir** a conta antes de continuar. **Por que é importante**: um número de telefone pode ser associado a apenas uma instância do WhatsApp. Usar o mesmo número em múltiplas plataformas pode resultar em erros de conexão e falhas na comunicação. 6. **Site da Empresa Ativo**: certifique-se de que o **site da sua empresa está ativo**, contendo todas as informações relevantes e acessível. O site pode ser necessário para a validação de sua empresa junto à Meta. **Por que é importante**: Empresas que usam o WhatsApp Business API devem ter uma presença online estabelecida para que a Meta possa validar a autenticidade do negócio. Um site desatualizado ou inacessível pode atrasar esse processo. 7. **URA/PABX (Unidade de Resposta Audível/Central Telefônica)**: caso o número de telefone que você vai usar esteja associado a um sistema de **URA ou PABX**, será necessário **desativar temporariamente** essa funcionalidade durante a configuração. A URA pode impedir que o WhatsApp envie o código de verificação necessário para ativar o número. **Por que é importante**: a URA/PABX pode interferir na recepção das chamadas e mensagens SMS necessárias para verificar o número de telefone. Desativar temporariamente esses serviços garante que você receba o código de ativação sem problemas. 8. **Verificação de Ativação em Outras Plataformas**: verifique se o número de telefone que será usado **não está ativo** em outras plataformas de mensageria, como outros provedores de API de WhatsApp. **Por que é importante**: um número de telefone vinculado a múltiplas plataformas pode gerar conflitos e impedir a ativação correta do WhatsApp no Hablla. ### Primeira etapa - Conexão no Hablla Para conectar o WhatsApp Business ao Hablla, você precisa de uma **conta de Administrador** no Hablla e um **número de WhatsApp Business** ativo. 1. Já conectado em sua conta, acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1750773282927.8266088573585080\&sck=a62d3376-49e7-43d6-a994-af1e2bb75c92\&external_id=a62d3376-49e7-43d6-a994-af1e2bb75c92). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações.
2. No lado esquerdo da tela no menu das Configurações, localize a seção **Conexões e Integrações**.
3. Nessa mesma tela você vai encontrar a integração de Whatsapp, basta clicar no **+Adicionar** no ícone do **Whatsapp**.
4. Você será direcionado para a tela de configuração do Whatsapp. Para seguir, clique em **Iniciar**. 5\. Selecione o setor de atendimento que deseja, de acordo com a área desejada, e em seguida clique no botão **Ok**. Por exemplo, se você é do setor Comercial, clique nesta opção. Se ela não existir, crie o setor no Hablla, antes de iniciar o procedimento de integração 6\. Clique em **Conectar ao WhatsApp** para dar o próximo passo rumo à integração!
### Segunda etapa - Conexão na Meta 1\. Uma nova guia em formato de pop-up do **Facebook** aparecerá na sua tela. Basta fazer login com suas credenciais e seguir em frente.
2\. Em seguida, selecione o perfil desejado e clique em **Continuar como \[seu nome de usuário]**.
3\. Clique em **Começar.**
4\. Escolha os dados da sua empresa em **Portfólio empresarial** ou, preencha as informações necessárias, caso ainda não tenha criado o portfólio. Em seguida, clique em **Avançar**.
5. Você deve selecionar ou criar sua conta do WhatsApp Business e escolher um perfil. Em seguida, clique em **Avançar**. 6. Se precisar criar um novo perfil do WhatsApp Business, preencha os campos com o *nome da conta*, o *nome para exibição* e escolha a *categoria* que melhor representa a sua empresa. Em seguida, clique em **Avançar**. 7. Adicione um número de telefone para ser utilizado no WhatsApp. Importante: ele não pode estar conectado ao WhatsApp. Então, escolha a forma de verificação que preferir. Em seguida, clique em **Avançar**.
8. Você receberá um código de verificação, na qual deve inserir no campo disponível e clique em **Avançar**. 9. Se a verificação do número foi bem-sucedida, você verá a tela seguinte. Clique em **Continuar** para avançar.
10. Tudo pronto! Sua configuração está finalizada! Clique em **Concluir.** ### Terceira e última etapa - Ativando o número no Hablla 1. Após concluir o processo na Meta, volte ao [Studio Hablla](https://studio.hablla.com/workspace/65c52bdca5eddbc1df810374/marketing?fbp=fb.1.1750773282927.8266088573585080\&sck=a62d3376-49e7-43d6-a994-af1e2bb75c92\&external_id=a62d3376-49e7-43d6-a994-af1e2bb75c92) e clique na **engrenagem** no menu superior esquerdo. Isso abrirá o menu de configurações, onde você poderá prosseguir com a configuração do WhatsApp
2. Acesse novamente no lado esquerdo da tela o menu das configurações a seção **Conexões e Integrações**.
3. Clique no menu WhatsApp
4. Você verá que a conexão foi criada, mas ainda está inativa, pois esse número não recebeu nenhuma mensagem até agora. O próximo passo é enviar um "oi" para esse número de qualquer conta do WhatsApp para ativá-lo.
5. Acesse o [App Hablla](https://app.hablla.com/workspace/643d802021b6aa9234eb9797/services/all?fbp=fb.1.1750773282927.8266088573585080\&sck=a62d3376-49e7-43d6-a994-af1e2bb75c92\&external_id=a62d3376-49e7-43d6-a994-af1e2bb75c92) e observe que, no lado esquerdo da tela, haverá uma seção chamada **Atendimentos em Fila**. Clique na barra roxa para acessá-la.
6. Aqui, você pode responder à mensagem para testar a janela de atendimento do WhatsApp e garantir que a integração está funcionando corretamente.
7. Volte ao Studio Hablla e acesse a seção **Conexões e Integrações**. Selecione o WhatsApp e verifique se agora o ícone está ativo, indicando que a integração foi concluída com sucesso.
8. Pronto! Agora você já pode começar a atender seus clientes pela plataforma Hablla! Aproveite essa nova conexão para oferecer um atendimento ainda mais ágil e eficaz. # Como fazer templates de WhatsApp Um **template de WhatsApp** é uma mensagem pré-formatada que precisa ser **aprovada pela Meta** antes de ser utilizada. Ele é ideal para comunicações automáticas ou notificações enviadas fora da janela padrão de 24 horas de atendimento. ### O que você precisa antes de começar? Ter um usuário com perfil **administrador**. ### Como criar templates de WhatsApp na Hablla 1\. Já conectado em sua conta, acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações. 1.
2\. No lado esquerdo da tela no menu das Configurações, localize a seção **Conexões e integrações**.
3\. Clique em **+ Adicionar** para entrar na interface de templates, o qual serão disponibilizados os seus números já cadastrados e criar novos.
4\. Clique em uma caixa de mensagens para visualizar as informações referentes ao seu número adicionado, bem como visualizar e personalizar modelos de mensagem.
5\. Clique em **Modelos de mensagem** para visualizar os templates
6\. Nessa interface, é possível observar a lista de templates criados, bem como informações referentes a cada uma, como seu nome, status, categoria. Clique em **+ Adicionar modelo** iniciar o processo de criação do seu template
7\. Existem três estruturas de modelo: **Marketing, Utilitário e Autenticação**. **Marketing:** Envio de mensagens promocionais e de engajamento para seus clientes. Pode incluir ofertas, descontos, novidades e convites para eventos. **Utilitário:** Mensagens relacionadas a serviços prestados, como confirmações de agendamentos, atualizações de status de pedidos e notificações de suporte. **Autenticação:** Mensagens de segurança e verificação, como códigos de autenticação, confirmações de login, avisos de atividades suspeitas\ e redefinições de senha. Para dar continuação, vamos iniciar a criação de um template com a categoria Marketing. Clique em **Próxima etapa.**
8\. Essa é nossa interface de criação do modelo. Com ela, há diversos campos a serem preenchidos.\ \ **Nome do modelo:** O nome do seu modelo a ser salvo, para gerenciá-lo. **Cabeçalho:** O topo da mensagem. Pode ser um texto, Imagem, Vídeo ou Documento. **Corpo:** O conteúdo central do seu template. **Variáveis:** Variáveis são importantes para personalizar palavras-chave que são utilizadas no template, como o nome do cliente, setor da empresa, entre outras possibilidades cabíveis a sua necessidade. **Rodapé:** O fim da sua mensagem. **Botões:** Os botões podem ser utilizados para dar continuidade à sua conversa ou redirecionar a links.
9\. Ao salvar seu modelo de mensagem (template) ele será enviado para aprovação pela Meta e aparecerá como status **Pendente.** Aguarde alguns instantes e seu template aparecerá como aprovado e estará pronto e pode ser utilizado! Pronto! Agora que você conhece os modelos de templates de WhatsApp e como eles podem transformar sua comunicação, é hora de colocar isso em prática. Com templates bem estruturados e estratégicos, você pode engajar seus clientes, oferecer suporte ágil e aumentar suas conversões. Não perca tempo! Comece a criar seus templates agora mesmo e dê um passo à frente na sua estratégia de marketing conversacional. 🚀 Se precisar de ajuda, estamos aqui para te apoiar! **ℹ️ Observação:** Esta documentação aborda apenas o funcionamento da funcionalidade. Para informações sobre cobranças, custos ou condições comerciais, consulte o contrato vigente ou entre em contato com o setor responsável. # Como criar um fluxo receptivo no WhatsApp Um fluxo receptivo do WhatsApp é uma automação essencial para definir como seus clientes serão recebidos ao entrarem em contato com sua empresa pelo seu número. Na Hablla, essa configuração simples permite que você personalize a experiência inicial, garantindo que as interações com seu público comecem de forma eficiente e profissional. Para facilitar o entendimento, dividimos este passo a passo em **três etapas**, guiando você de maneira prática na criação do seu **primeiro fluxo de automação**: * **Primeira etapa- Criação do fluxo dentro do Studio** * **Segunda etapa- Componentes de WhatsApp** * **Terceira etapa- Adicionar a transferência e publicar o fluxo** ### **O que você precisa antes de começar?** Antes de configurar seu fluxo de automação, é importante garantir que alguns pré-requisitos estejam em ordem para que o processo seja rápido e sem complicações. Confira nosso checklist: * [**Criar um Setor no Hablla:**](https://hablla.com/como-criar-setores-dentro-do-hablla/) organize e categorize as interações da sua empresa com os clientes para facilitar o gerenciamento. * [**Ter uma conexão de WhatsApp ativa:**](https://hablla.com/como-configurar-o-whatsapp-no-hablla/) como cadastrar o seu número de whatsapp na plataforma Hablla. * [**Usuário atendente configurado**](https://hablla.com/como-adicionar-novos-usuarios-ao-time/)**:** cadastre pelo menos um usuário como atendente e envie o convite para o workspace ### Primeira etapa - Criação do fluxo dentro do Studio 1. Já conectado em sua conta, acesse o menu **Atendimento**. Na parte superior da tela. Clique nele para o próximo passo.
2. Dentro de **Atendimento** encontre o menu **Bot de qualificação de Lead** e clique nele, em seguida.
3. No canto superior direito da tela, você vai encontrar o botão **+Adicionar fluxo**, clique nele.
4. Dê um nome para o fluxo e uma breve descrição sobre ele. Em seguida, clique em salvar.
5. A primeira etapa está concluída e seu fluxo está criado. Agora, vamos seguir para a próxima etapa e deixar sua automação ainda mais completa!
### Segunda etapa - Componentes de WhatsApp 1. Ao acessar o fluxo, você verá a tela inicial. O ícone **Start** permite configurar diferentes automações; porém, para este fluxo, vamos começar com o componente de **Receptivo do WhatsApp**, que dará início ao atendimento dos seus clientes.
2. No menu inferior, localize e clique no ícone do WhatsApp. Ao selecionar o componente, você verá as opções de ações disponíveis para o seu fluxo. Procure pelo componente **Receptivo de WhatsApp** para começar a configuração.
3. Em seguida, arraste a opção **Receptivo do WhatsApp** para o seu fluxo. Isso permitirá que você inicie a configuração do atendimento aos seus clientes de forma eficiente.
4. Ao clicar nesse componente, um pop-up será exibido no lado direito da sua tela. Aqui, você precisará escolher qual canal o fluxo irá atuar. Esses canais correspondem aos números de WhatsApp ativos que você possui na Hablla.
5. Esse canal corresponde ao número de WhatsApp cadastrado na sua conta Hablla. Selecione o canal cadastrado que você utilizará para este fluxo.
6. Com o componente **Receptivo do WhatsApp** configurado, você já pode receber mensagens pelo Hablla. Agora, precisamos enviar uma mensagem inicial aos clientes. Para isso, utilizaremos o componente **Mensagem de WhatsApp.**
7. **Selecione e arraste** o componente **Mensagem de WhatsApp** para o fluxo. Assim que fizer isso, ele aparecerá da seguinte forma:
8. Ao acessar esse componente, você encontrará duas opções: o tipo de mensagem e o conteúdo da mensagem em si. Para começar, selecione o tipo de mensagem como **Texto** e em seguida, escreva a mensagem que deseja enviar aos seus clientes.
9. Ao salvar, a mensagem será exibida dentro do componente, confirmando que sua configuração está completa.
10. Agora podemos conectar o componente anterior à mensagem. Clique no círculo ao lado do componente **Receptivo de WhatsApp**, segure e arraste até o círculo do componente **Mensagem de WhatsApp** para estabelecer a ligação entre eles.
11. No nosso exemplo queremos descobrir com qual setor o cliente deseja falar. Para isso, utilizaremos o componente **Pergunta de WhatsApp**.
12. Arraste o componente **Pergunta de WhatsApp** para a tela, e ele aparecerá da mesma forma que os outros componentes.
13. Clique no componente **Pergunta de WhatsApp** para abrir as configurações. Em **Tipo** o sistema identifica a interação que você deseja criar com o lead. Selecione **Interativo** para ativar a opção de botões. Em seguida, escreva a mensagem introdutória que acompanhará os botões, guiando o cliente na escolha do setor.\ \ 13.1.Selecione o **Tipo de Resposta** como **Botões** e adicione os setores da sua empresa que deseja disponibilizar para os clientes. Lembre-se de que no WhatsApp o tipo de resposta **Botões** permite até **três opções**.
14. Conecte o componente de pergunta ao componente de mensagem de boas-vindas anterior. Isso garantirá que o cliente receba a pergunta logo após a mensagem inicial. Como na imagem abaixo.
### Terceira etapa - Adicionar a transferência e publicar o fluxo 1. Com a pergunta configurada, vamos agora permitir a transferência para os setores que o cliente escolher. Para isso, clique novamente no menu de componentes na parte inferior da tela e selecione o componente **Transferência**. Clique no componente **Hablla** para entrar, conforme a imagem.
2. Arraste o componente **Transferência** para o fluxo e conecte-o a uma das opções de resposta da **Pergunta de WhatsApp**.
3. Clique no componente **Transferência** e selecione o setor para o qual o atendimento será direcionado. Se desejar, você também pode escolher um usuário específico que receberá esses atendimentos.
4. Exemplo: selecione o setor **Suporte** e clique em **Salvar** para concluir a configuração.
5. Repita o processo para os demais setores, conectando cada opção de resposta ao respectivo setor desejado.
6. Pronto! Agora temos um fluxo receptivo básico configurado. Esse é apenas um exemplo. Sinta-se à vontade para adicionar outras mensagens e perguntas, adaptando o fluxo para as necessidades específicas da sua empresa. Para que ele comece a funcionar, é necessário ativá-lo. Para isso, clique no ícone ao lado da opção **Inativo** para deixá-lo **ativo**.
7. Agora é hora de salvar todas as suas alterações! Clique em **Publicar** para confirmar suas modificações. Lembre-se: toda vez que você fizer ajustes no fluxo, é essencial clicar nessa opção para garantir que tudo fique salvo. Vamos deixar tudo pronto para funcionar! 🚀
**E está tudo pronto! Agora, quando você receber mensagens no seu WhatsApp, os clientes passarão pelo fluxo que você acabou de criar. 🎉 Para testar, envie um "oi" para o número cadastrado e veja seu fluxo em ação! Pronto para oferecer uma experiência incrível de atendimento!** **ℹ️ Observação:** Esta documentação aborda apenas o funcionamento da funcionalidade. Para informações sobre cobranças, custos ou condições comerciais, consulte o contrato vigente ou entre em contato com o setor responsável. # Templates - Modelos de Mensagem Crie e gerencie templates de mensagens no WhatsApp: Marketing, Utility e Autenticação. Use modelos aprovados pela Meta para engajar, notificar e autenticar. Os **Templates de Mensagem da Meta** são mensagens pré-aprovadas utilizadas no **WhatsApp Business API**.\ Eles permitem que sua empresa envie comunicações fora da janela de 24 horas de atendimento e garantem consistência em interações recorrentes.
Na Hablla, os templates são organizados em três categorias principais: **Marketing**, **Serviços (Utility)** e **Autenticação**. ### Categorias de Templates #### 📢 Marketing Utilizado para mensagens promocionais e de engajamento com clientes.\ Exemplos de uso: * Divulgação de promoções e ofertas. * Convites para eventos. * Lançamento de novos produtos ou serviços. * Atualizações de novidades da empresa. ⚠️ É importante que a mensagem seja clara e não invasiva. O cliente deve sempre ter a opção de interromper o recebimento. *** #### 🛠️ Serviços (Utility) Essa categoria é usada para mensagens relacionadas a serviços contratados e operações do dia a dia.\ Exemplos de uso: * Confirmação de agendamentos. * Atualizações de status de pedidos. * Notificações de entrega ou suporte. * Lembretes importantes de compromissos. ⚠️ Esse é o template mais usado para comunicações **transacionais**, como alertas de status ou acompanhamento de serviços. *** #### 🔑 Autenticação Essa categoria é destinada a mensagens de **segurança e verificação**.\ Exemplos de uso: * Envio de códigos de autenticação. * Confirmações de login. * Avisos de atividades suspeitas. * Redefinição de senha. ⚠️ Mensagens de autenticação são fundamentais para garantir a proteção da conta e a segurança do usuário final. ***
### Criando um Template de Mensagem 1. No menu **Configurações > Conexões e Integrações > WhatsApp**, acesse a aba **Modelos de Mensagem**. 2. Clique em **Adicionar modelo**. 3. Preencha as informações: * **Nome do modelo** (uso interno para identificação). * **Idioma** da mensagem. * **Categoria**: escolha entre Marketing, Serviços (Utility) ou Autenticação. 4. Configure o conteúdo: * **Cabeçalho**: pode conter texto, imagem, vídeo ou documento (até 60 caracteres no caso de texto). * **Corpo**: mensagem principal, até 1024 caracteres (suporta variáveis dinâmicas e emojis). * **Rodapé**: campo opcional de até 60 caracteres, geralmente usado para notas curtas. * **Botões (opcional)**: inclua ações rápidas como *Sim/Não* ou links externos. 5. Visualize o template na prévia ao lado e clique em **Salvar**. 6. O modelo será enviado para aprovação da Meta. O status pode ser: * **Aprovado** ✅ * **Rejeitado** ❌ * **Pendente** ⏳ ***
### Boas práticas para aprovação * Use **linguagem clara e objetiva**. * Evite mensagens genéricas que possam ser consideradas spam. * Sempre personalize com variáveis (ex.: nome do cliente) para aumentar a relevância. * Inclua informações da sua empresa para transmitir confiança. *** ### Resumo Os templates de mensagem são a base para comunicações proativas no WhatsApp Business. * **Marketing**: engajamento e promoções. * **Serviços (Utility)**: transações e operações. * **Autenticação**: segurança e verificações. Com a Hablla, você pode criar, gerenciar e acompanhar o status dos templates diretamente no painel, garantindo agilidade e conformidade com as regras da Meta. *** 📌 **Dica prática**: crie diferentes templates para cada necessidade do seu negócio e mantenha-os organizados por categoria para facilitar a gestão. **ℹ️ Observação:** Esta documentação aborda apenas o funcionamento da funcionalidade. Para informações sobre cobranças, custos ou condições comerciais, consulte o contrato vigente ou entre em contato com o setor responsável. # Relatórios de Janelas do WhatsApp Exporte relatórios do WhatsApp na Hablla em CSV, XLSX ou JSON. Analise campanhas, integre dados em BI e mantenha registros organizados para auditorias. A Hablla permite acompanhar a performance das mensagens enviadas pelo **WhatsApp Oficial** através de relatórios detalhados.\ Esses relatórios ajudam a entender o desempenho de campanhas, mensagens transacionais e fluxos de atendimento, além de permitir análises por filtros personalizados. *** ### Relatórios de WhatsApp
Na aba **Relatórios**, você encontra um histórico completo das mensagens enviadas pela sua empresa no WhatsApp. As principais informações exibidas incluem: * **Status**: indica se a mensagem foi entregue com sucesso ou se houve erro. * **Categoria**: Marketing, Utility (Serviços), Autenticação, Atendimento ou Referência. * **Tipo**: canal utilizado (ex.: WhatsApp). * **Iniciado por**: mostra se a mensagem foi iniciada pelo usuário ou pelo cliente. * **Two Way ativo**: indica se a conversa estava aberta para interação bidirecional. * **Telefone**: número do cliente que recebeu a mensagem. * **Data de envio**: registro de quando a mensagem foi criada e enviada. Esses relatórios podem ser **exportados** para análise externa e integrados ao seu processo de BI. *** ### Filtros Personalizados
Para refinar sua análise, é possível aplicar filtros que permitem visualizar apenas os dados relevantes. Os filtros disponíveis incluem: * **Categoria**: selecione a categoria do template (Autenticação, Utilitário, Marketing, Atendimento ou Referência). * **Data de início e término**: defina um período específico para análise. * **Iniciado por**: escolha entre mensagens iniciadas pelo **usuário** ou pelo **cliente**. * **Two Way ativo**: filtre mensagens onde a interação bidirecional estava habilitada (Sim/Não). * **Status**: visualize apenas mensagens com **Sucesso** ou **Erro**. Combinando filtros, você pode, por exemplo: * Analisar apenas mensagens **de marketing** enviadas no último mês. * Verificar mensagens **de autenticação** com status de erro. * Avaliar **interações iniciadas pelo cliente** em campanhas específicas. ## Exportação de Relatórios do WhatsApp
A Hablla permite **exportar os relatórios de mensagens do WhatsApp** em diferentes formatos de arquivo.\ Essa função é ideal para análises externas, integrações com sistemas de BI ou armazenamento para auditorias. > ⚠️ A exportação respeita os filtros aplicados no relatório. Sempre defina período, categoria e status antes de exportar. *** ### Como exportar relatórios 1. Vá até **Configurações → Conexões e integrações → WhatsApp**. 2. Clique na aba **Relatórios**. 3. Aplique filtros (categoria, data, status, origem da mensagem, etc.) caso necessário. 4. Clique em **Exportar**. 5. Escolha o formato desejado: **CSV, XLSX ou JSON**. *** ### Formatos disponíveis #### 📄 CSV * Compatível com Excel, Google Sheets e LibreOffice. * Estrutura simples de colunas e linhas separadas por vírgula. * Ótimo para manipulação rápida e análise tabular. **Exemplo de uso**: equipes de marketing analisando disparos em massa. *** #### 🗂 XLSX * Arquivo nativo do **Microsoft Excel**. * Mantém colunas organizadas para uso de filtros, fórmulas e tabelas dinâmicas. * Ideal para relatórios visuais e compartilhamento com equipes não técnicas. **Exemplo de uso**: relatórios de desempenho apresentados à diretoria. *** #### 🔧 JSON * Estrutura em **chave/valor**, ideal para integrações com APIs ou Data Warehouses. * Formato técnico, recomendado para desenvolvedores e analistas de BI. **Exemplo de uso**: importar dados em sistemas internos ou ferramentas de análise. *** ### Fazendo Download dos Relatórios Sempre que exportar um relatório na Hablla, ele estará disponível na aba de notificações (sininho), ao lado da foto do perfil. Dependendo do tamanho, pode demorar alguns minutos para estar disponível para fazer o download.
### Boas práticas * Sempre aplique filtros antes de exportar para reduzir o volume de dados. * Para grandes bases, prefira **CSV** (mais leve) ou **XLSX** (mais organizado). * Use **JSON** apenas em contextos técnicos de integração. *** ### Resumo A exportação de relatórios do WhatsApp na Hablla garante flexibilidade e adaptabilidade. * **CSV/XLSX** → análises operacionais e compartilhamento. * **JSON** → integrações técnicas e automações. 📌 **Dica prática**: defina uma rotina de exportação para acompanhar resultados periodicamente e centralizar dados no seu BI. *** ### Exemplos de uso * **Equipe de Marketing**: validar a taxa de sucesso em campanhas promocionais. * **Suporte Técnico**: analisar erros em mensagens transacionais (Utility). * **Gestão de CX**: acompanhar quais contatos foram iniciados pelo cliente e geraram novas oportunidades. *** ### Resumo Os relatórios de WhatsApp na Hablla oferecem uma visão completa da performance de mensagens enviadas, entregues e respondidas.\ Com os filtros personalizados, é possível transformar dados brutos em **insights acionáveis**, melhorando campanhas, atendimento e operações. *** 📌 **Dica prática**: exporte relatórios com filtros aplicados para cruzar os dados com outras ferramentas de análise (como BI ou planilhas). **ℹ️ Observação:** Esta documentação aborda apenas o funcionamento da funcionalidade. Para informações sobre cobranças, custos ou condições comerciais, consulte o contrato vigente ou entre em contato com o setor responsável. # Com Realizar a migração para BSP {% file src="/files/rLzyV5sdGR9vDa4J7nzK" %}
# Facebook Configurar o Facebook no Hablla é um processo simples e eficaz que permitirá à sua empresa se conectar com os clientes de forma ágil e profissional. Para facilitar a sua compreensão, dividimos o processo em 4 etapas principais: * Primeira etapa- Conexão no Hablla * Segunda etapa- Conexão na Meta * Terceira etapa- Conexão de página * Quarta etapa- Ativando a conta ### **Primeira etapa - Conexão no Hablla** Para conectar o Facebook ao Hablla, você precisa de um **acesso de Administrador** na Hablla e uma **conta no Facebook**. 1. Já conectado em sua conta, acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações.
2. No lado esquerdo da tela no menu das Configurações, localize a seção **Conexões e Integrações**.
3. Nessa mesma tela você vai encontrar a integração de Facebook, basta clicar no **+Adicionar** no ícone do **Facebook**.
4. Você será direcionado para a tela de configuração do Facebook dentro do Hablla. Para seguir, clique em **Iniciar**. 5. Selecione o setor de atendimento que deseja, de acordo com a área desejada, e em seguida clique no botão **Ok**. 6. Clique em **Conectar o Messenger.** ### **Segunda etapa- Conexão na Meta** 1\. Uma nova guia em formato de pop-up do **Facebook** aparecerá na sua tela. Basta fazer login com suas credenciais e seguir em frente. 2\. Em seguida, selecione o perfil desejado e clique em **Continuar como \[seu nome de usuário]**.
3\. Selecione o perfil desejado e clique em **Continuar.**
4\. Caso não tenha uma página existente, será necessário criar uma nova. Após criar e selecionar a página que deseja conectar, clique em **Continuar** para prós. 5\. Selecione a página desejada e clique em **Continuar.** 6\. Caso você não tenha conectado uma conta de Instagram, conecte a sua conta de Instagram a BM. Caso você já tenha, pule para o passo **14**.
7\. Como conectar o instagram: Acesse [https://business.facebook.com/](https://business.facebook.com/?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044) com a sua conta e vá em **Configurações.**
8\. Já em configurações, clique em **Contas do Instagram.**
9\. Em seguida, aparecerá um texto informando que não há nenhuma conta do Instagram conectada. Clique em **+Adicionar**. Que irá abrir um Pop-up.
10\. Prossiga em **Reivindicar conta do Instagram**
11\. Você será então direcionado para entrar na sua conta do Instagram.
12\. Ao entrar na conta, aparecerá a seguinte mensagem, dizendo que sua conta foi adicionada. Clique em **Concluir** para continuar.
13\. Volte na conexão com o Facebook e aperte **Refresh.** A conta do Instagram que foi adicionada deve aparecer como uma opção agora.
14\. Selecione a conta do Instagram que deseja adicionar e clique em **Continuar**.
15\. Confira os dados e dê um nome para o conjunto de dados de evento da sua página. Em seguida, aperte **Criar**.
16\. Agora, confirme novamente a sua página e conta do Instagram que a Hablla estará se conectando e pressione **Continuar**.
17 - Por fim, verifique quais são as permissões que a Hablla terá com essa conexão e clique em **Salvar**.
18 - Sua empresa foi conectada ao Hablla pelo Facebook com sucesso, pressione **Entendi** para continuar.
### **Terceira etapa: Conexão de página** 1 - Voltando ao [Studio](https://studio.hablla.com/?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044), quando a conexão com o facebook for concluída, a Hablla perguntará qual página deseja conectar. Selecione a página e clique em **Ok**.
2 - Sua página do Facebook foi conectada à Hablla com sucesso!
3 - Se você retornar às configurações e em conexões e integrações, verá que o ícone do facebook agora aparece colorido, informando que possui uma conexão.
4 - Essa conexão aparecerá na aba do Facebook e pode ser acessada para conferir os dados e relatórios.
### **Quarta etapa - Ativando a conta** 1. Com a conexão feita, agora precisamos ativar essa conexão. Envie uma mensagem no messenger da página do Facebook que foi conectada ao Hablla. 2. Acesse o [App.hablla](https://app.hablla.com/?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). Lá aparecerá um novo atendimento:
3. Acesse o atendimento e envie uma resposta.
4. Volte no [Studio.hablla](https://studio.hablla.com/?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044), em conexões e integrações, e verifique se o ícone da sua página do facebook agora está ativo.
5. Sucesso! Sua conexão com o Facebook dentro da Hablla está ativa e funcionando. Agora você pode utilizá-la para receber atendimentos e fazer fluxos de automação. **ℹ️ Observação:** Esta documentação aborda apenas o funcionamento da funcionalidade. Para informações sobre cobranças, custos ou condições comerciais, consulte o contrato vigente ou entre em contato com o setor responsável. **Lembre-se:** * Em caso de dúvidas ou dificuldades durante o processo de conexão, a equipe de suporte da Hablla está sempre à disposição para te auxiliar. [Entre em contato](https://api.whatsapp.com/send/?phone=551136701155\&text\&type=phone_number\&app_absent=0\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). * Comece a criar! Com a integração concluída, você está pronto para criar fluxos de automação eficientes e personalizados para o Facebook usando a plataforma Hablla. Explore as diversas funcionalidades e recursos disponíveis para personalizar o seu atendimento pelo messenger. * Ainda não é cliente Hablla? [Fale com um dos nossos consultores](https://api.whatsapp.com/send/?phone=551136701155\&text\&type=phone_number\&app_absent=0\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). # Instagram Configurar o Instagram no Hablla é um processo simples e eficaz que permitirá à sua empresa se conectar com os clientes de forma ágil e profissional. Para facilitar a sua compreensão, dividimos o processo em três etapas principais: * Primeira etapa- Conexão no Hablla * Segunda etapa- Conexão na Meta * Terceira etapa- Conexão de página **Primeira etapa- Conexão Hablla** Para conectar o Instagram ao Hablla, você precisa de um **acesso de Administrador** na Hablla e uma **conta no Instagram**. 1. Já conectado em sua conta, acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações.
2. No lado esquerdo da tela no menu das Configurações, localize a seção **Conexões e Integrações**.
3. Nessa mesma tela você vai encontrar a integração de Instagram, basta clicar no **+Adicionar** no ícone do **Instagram**.
4. Você será direcionado para a tela de configuração do Instagram dentro do Hablla. Para seguir, clique em **Iniciar**. 5. Selecione o setor de atendimento que deseja, de acordo com a área desejada, e em seguida clique no botão **Ok**. 6. Clique em **Conectar o Messenger.** **Segunda etapa- Conexão com o Facebook**
1\. Uma nova guia em formato de pop-up do **Facebook** aparecerá na sua tela. Basta fazer login com suas credenciais e seguir em frente.
2\. Em seguida, selecione o perfil desejado e clique em **Continuar como \[seu nome de usuário]**.
3\. Selecione o perfil desejado e clique em **Continuar.**
4.Se não tiver páginas, você precisará criar uma nova página. Após criar e selecionar a página que deseja conectar, clique em **Continuar**.
5\. Selecione a página desejada e clique em **Continuar.**
6\. Conectar instagram: caso você já tenha, pule para o passo **14**.
7. Como conectar o instagram: Acesse [https://business.facebook.com/](https://business.facebook.com/?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044) com a sua conta e vá em **Configurações.**
8. Já em configurações, clique em **Contas do Instagram.**
9. Em seguida, aparecerá um texto informando que não há nenhuma conta do Instagram conectada. Clique em **+Adicionar**. Que irá abrir um Pop-up.
10. Prossiga em **Reivindicar conta do Instagram**
11. Você será então direcionado para entrar na sua conta do Instagram.
12. Ao entrar na conta, aparecerá a seguinte mensagem, dizendo que sua conta foi adicionada. Clique em **Concluir** para continuar.
13. Volte na conexão com o Facebook e aperte **Refresh.** A conta do Instagram que foi adicionada deve aparecer como uma opção agora.
14. Selecione a conta do Instagram que deseja adicionar e clique em **Continuar**.
15. Confira os dados e dê um nome para o conjunto de dados de evento da sua página. Em seguida, aperte **Criar**.
16. Agora, confirme novamente a sua página e conta do Instagram que a Hablla estará se conectando e pressione **Continuar**.
17. Por fim, verifique quais são as permissões que a Hablla terá com essa conexão e clique em **Salvar**.
18. Sua empresa foi conectada ao Hablla pelo **Instagram** com sucesso, pressione **Entendi** para continuar.
**Terceira etapa- Conexão de página** 1. Voltando ao Studio, quando a conexão com o facebook for concluída, a Hablla perguntará qual página deseja conectar. Selecione a página e clique em **Ok**.
2. Sua página de Instagram foi conectada à Hablla com sucesso!
**ℹ️ Observação:** Esta documentação aborda apenas o funcionamento da funcionalidade. Para informações sobre cobranças, custos ou condições comerciais, consulte o contrato vigente ou entre em contato com o setor responsável. **Lembre-se:** * Em caso de dúvidas ou dificuldades durante o processo de conexão, a equipe de suporte da Hablla está sempre à disposição para te auxiliar. [Entre em contato](https://api.whatsapp.com/send/?phone=551136701155\&text\&type=phone_number\&app_absent=0\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). * Comece a criar! Com a integração concluída, você está pronto para enviar e-mails eficientes e personalizados usando a plataforma Hablla. Explore as diversas funcionalidades e recursos disponíveis para construir campanhas de e-mail que atendam às suas necessidades específicas. * Ainda não é cliente Hablla? [Fale com um dos nossos consultores](https://api.whatsapp.com/send/?phone=551136701155\&text\&type=phone_number\&app_absent=0\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). # Telegram EM BREVE. Precisando dessa documentação? Entre em contato com o nosso suporte e solicite. # E-mail Para realizar essa configuração, vamos dividi-la em duas partes: primeiro, faremos a conexão do seu endereço de e-mail na plataforma Hablla, e em seguida, ajustaremos as entradas de DNS no servidor de domínio da sua empresa. Antes de começar, é importante que você tenha um perfil de Administrador no Hablla e acesso ao servidor do domínio de e-mail da sua empresa. Não esqueça de criar também **um** [**Setor**](https://docs.google.com/document/d/1aq2mB02UO2RsT9YMalaXGEMrEV-RN1V2AtvNfseUw0M/edit?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044) **no Hablla** criar um setor no Hablla é fundamental para organizar e categorizar as interações da sua empresa com os clientes. ### Primeira Parte - Conexão no Hablla: 1. Já conectado em sua conta, acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações.
2. No lado esquerdo da tela no menu das Configurações, localize a seção **Conexões e Integrações**.
3. Nessa mesma tela você vai encontrar a integração de E-mail, basta clicar no **+Adicionar** no ícone do **E-mail**.
4. Você será direcionado para a tela de configuração do E-mail dentro do Hablla. Para seguir, clique em **Iniciar**.
5. Preencha o campo com o nome que deseja identificar essa conexão.\ \ \
6. Selecione o setor de atendimento que deseja, de acordo com a área desejada, e em seguida clique no botão **Ok**. Por exemplo, se você é do setor Comercial, clique nesta opção. Se ela não existir, crie o setor no Hablla, antes de iniciar o procedimento de integração.
7. No campo domínio, insira o endereço principal do seu site (exemplo: meudominio.com.br)
8. Se desejar que os e-mails sejam armazenados no mesmo atendimento, selecione **Sim** e em seguida clique em **Ok**.
9. A primeira etapa da conexão com o e-mail foi concluída com sucesso. Agora, vamos para a segunda parte da configuração: ajustar as entradas DNS no seu servidor de domínio. ### **Por que validar o meu domínio?** A autenticação de domínio é essencial para que o Hablla possa enviar e-mails em nome do seu domínio, garantindo sua legitimidade perante os provedores de e-mail. Para configurar, é necessário ajustar as entradas DNS no painel do seu provedor de domínio ou hospedagem. Isso aumenta as chances de suas mensagens chegarem à caixa de entrada, fortalecendo a reputação da empresa e reduzindo o risco de que os e-mails sejam marcados como spam. ### **Segunda Parte - Ajuste das Entradas DNS no Servidor** 1. Clique em **Iniciar** para continuar. 2. Você precisará fazer login no seu serviço de DNS. Abra uma nova aba no navegador e acesse o painel do seu provedor de hospedagem. Os serviços mais comuns, como [Locaweb](https://www.locaweb.com.br/ajuda/wiki/como-editar-as-entradas-de-dns-na-zona-de-dns-hospedagem-de-sites/?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044),[ UOL Host](https://faq.uolhost.uol.com.br/ajuda/content/como-acesso-a-zona-de-dns-e-as-entradas-do-meu-dominio?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044), [Cpanel](https://docs.cpanel.net/cpanel/domains/zone-editor/?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044) e [Hostinger](https://www.hostinger.com.br/tutoriais/como-usar-editor-de-zona-dns-hostinger?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044), oferecem guias específicos para facilitar esse processo. Siga as instruções adequadas para o seu serviço e acesse as configurações de DNS. 3. Após fazer o login, você precisará localizar e editar a **Zona de DNS**. Essa seção pode ser encontrada sob diferentes nomenclaturas, dependendo do seu provedor de hospedagem. Procure por termos como **Editar DNS**, **Meus Domínios**, **Gerenciamento da Conta** ou **Configurações Avançadas**. Uma vez na seção correta, você poderá acessar as configurações necessárias para realizar as alterações nas entradas de DNS. 4. Ao localizar a zona de DNS, você precisará criar uma nova entrada, seguindo as instruções da tabela abaixo: | **Tipo** | **Host** | **Dado** | | -------- | ------------------------------ | --------------------------------- | | CNAME | **ex:** | **ex:** 1234.exemplo.sendgrid.net | * Caso você veja o campo “TTL”, digite 3600 segundos (uma hora); * O servidor pode utilizar outros nomes para os campos a serem preenchidos como: "Nome", "Host", "Entrada", "Valor" ou "Alias". Você pode inserir o código da mesma forma; 5. Em seguida, salve o registro! Parabéns! Você concluiu essa etapa! Agora é só aguardar que o seu provedor de domínio confirme a propagação das alterações. Em breve, você estará pronto para aproveitar ao máximo a integração com a Hablla! \ Para conferir se a configuração foi bem-sucedida, ela deve ser verificada no site:[ WhatsMyDNS](https://www.whatsmydns.net/#CNAME/).
Adicionalmente, inclua todas as configurações presentes no campo "Host", acessando **Conexões e Integrações > E-mail > Nome da conexão > Configurar DNS**. Utilize as informações disponíveis no campo "Host" para garantir a correta configuração. | **Tipo** | **Host** | **Dado** | | -------- | ------------------------------ | --------------------------------- | | CNAME | **ex:** | **ex:** 1234.exemplo.sendgrid.net | ### Lembre-se: * Em caso de dúvidas ou dificuldades durante o processo de conexão, a equipe de suporte da Hablla está sempre à disposição para te auxiliar. [Entre em contato](https://api.whatsapp.com/send/?phone=551136701155\&text\&type=phone_number\&app_absent=0\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). * Comece a criar! Com a integração concluída, você está pronto para enviar e-mails eficientes e personalizados usando a plataforma Hablla. Explore as diversas funcionalidades e recursos disponíveis para construir campanhas de e-mail que atendam às suas necessidades específicas. * Ainda não é cliente Hablla? [Fale com um dos nossos consultores](https://api.whatsapp.com/send/?phone=551136701155\&text\&type=phone_number\&app_absent=0\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). # Criando Template de E-mail Os templates de e-mail são modelos prontos de mensagens usadas para comunicação eletrônica. Eles são estruturados para facilitar o envio de e-mails recorrentes, mantendo o mesmo layout, estilo e formato de mensagem. **Com eles, é possível personalizar seu template de e-mail**, tornando a comunicação mais eficiente e profissional. Esses templates são amplamente utilizados em marketing, atendimento ao cliente, vendas e outros contextos que exigem uma comunicação consistente. Eles ajudam a economizar tempo, melhorar a eficiência e manter uma aparência profissional, independentemente de quantos e-mails são enviados. ### O que você precisa antes de começar? Antes de criar o seu template de e-mail, é importante garantir que alguns pré-requisitos estejam em ordem para que o processo seja rápido e sem complicações. **Personalize seu template de e-mail** de forma eficiente e prepare tudo para garantir um resultado profissional. Confira nosso checklist: * Ter uma conexão de **DNS ativa**: [como configurar o e-mail na Hablla](https://hablla.com/como-configurar-o-e-mail-no-hablla/); * Ter um usuário com perfil **administrador**.
### Primeiro passo: acessando a área de criação de templates para personalizar seu template de e-mail 1\. Para criar um template de E-mail, conecte sua conta e acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações.
2\. No lado esquerdo da tela no menu das **Configurações**, localize a seção **Conexões e integrações**.
3\. Selecione a conexão de **E-mail**.
4\. Escolha o endereço de e-mail em que o template será criado.
5\. No submenu, selecione a opção **Modelo de Mensagem**.
6\. No lado direito clique no botão **+ Criar novo template**.
7\. Você será direcionado à tela de criação do template de e-mail, onde encontrará campos como **Nome do Modelo** e **Assunto**. Preencha esses campos para iniciar seu template.
### Como adicionar colunas 1\. Para adicionar colunas, clique no elemento de colunas e arraste-o até o local desejado no template.
2\. Para configurar as colunas depois de adiciona-las, acesse a aba lateral direita e selecione **Columns**. Nessa seção, você pode ajustar a divisão das colunas conforme desejar, personalizando o layout do seu template.
3\. Na aba lateral direita, acesse **Blocks** para inserir blocos pré-divididos em colunas, facilitando a organização e estruturação do conteúdo.
4\. Em **Column Properties**, você pode personalizar a quantidade de colunas, ajustar a cor de fundo, o tamanho do preenchimento, além da espessura, cor e estilo da borda.
4\. Em **Row Properties** você pode configurar a linha em que aquela coluna está. É possível definir a cor de fundo da linha, a cor de fundo do conteúdo, adicionar uma imagem de fundo e definir o preenchimento.
5\. Na seção **Responsive Design**, você pode ajustar as configurações para que o layout se adapte automaticamente a diferentes tamanhos de tela, garantindo que seu template tenha uma ótima aparência em dispositivos móveis e desktops.
### Como adicionar botões ao seu e-mail 1\. Para adicionar botões, clique e arraste o elemento, trazendo-o para o campo de edição.
2\. Ao adicionar o botão, configure-o na aba lateral direita. Em **Action**, defina a ação que o botão deve realizar e os detalhes necessários. Por exemplo, se a ação for **Abrir Website**, basta inserir o link do site desejado.
3\. Em **Button Options** é possível alterar a cor e o tamanho do botão, definir a cor, o tamanho e a fonte do texto do botão, o espaçamento das linhas e das letras.
4\. Em **Spacing**, você pode definir o alinhamento e tamanho do botão, a espessura e traço da borda e adicionar bordas arredondadas.
5\. Na aba **General**, ajuste o tamanho do contêiner que abriga o botão.
### Adicionar divisor 1\. Para adicionar divisores, clique e arraste o elemento, trazendo-o para o template.
2\. Uma vez adicionado, você pode configurar o divisor na aba que se encontra na lateral direita. Em **Line** é possível alterar o tamanho, a espessura, o traçado e o alinhamento do divisor.
### Adicionar cabeçalhos 1\. Para adicionar cabeçalhos, clique e arraste o elemento, trazendo-o para o template.
2\. Uma vez adicionado, você pode configurar o cabeçalho na aba que se encontra na lateral direita. Em **Text** é possível definir o tipo de cabeçalho, a fonte, o tamanho, a cor, o alinhamento do texto, a altura da linha e o espaçamento das letras.
3\. Para inserir um link no seu texto, clique e selecione a palavra ou frase onde deseja o link, depois encontre o ícone de link (geralmente uma corrente) na barra de ferramentas, cole o URL desejado e confirme. Pronto! O link estará ativo no texto.
### Adicionar texto 1\. Para adicionar texto, clique e arraste o elemento "Texto" para o template na posição desejada. Depois, é só soltar e começar a escrever!
2\. Uma vez adicionado, você pode configurar o texto na aba que se encontra na lateral direita. As configurações de textos são as mesmas que as configurações de cabeçalho. ### Adicionar imagens 1\. Para adicionar imagens, clique e arraste o elemento, trazendo-o para o template.
2\. Uma vez adicionado, você pode configurar a imagem na aba que se encontra na lateral direita. Em **Imagem** é possível fazer o upload da imagem, adicionar o link da imagem, definir seu tamanho, alinhamento e texto alternativo.
### Adicionar ícones de redes sociais 1\. Para adicionar ícones de redes sociais, clique e arraste o elemento, trazendo-o para o template.
2\. Uma vez adicionado, você pode configurar os ícones na aba que se encontra na lateral direita. Em **Icons**, é possível selecionar os ícones que desejar, alterar seu formato, vincular um link a ele e definir seu tamanho, espaçamento e alinhamento.
### Adicionar menu de navegação 1\. Para adicionar um menu, clique e arraste o elemento, trazendo-o para o template.
2\. Use o Menu para criar opções de navegação no seu template. Você pode adicionar **links** para diferentes páginas, configurar um botão para envio direto de **e-mail** ou até um botão que permite ao usuário chamar para um **número específico**.
3\. Personalize seu Menu em Styles. Na seção **Styles**, você pode ajustar a fonte, tamanho, cor do texto e o espaçamento das letras no seu Menu. Além disso, é possível escolher o alinhamento, definir um separador entre os itens, configurar o layout do menu e personalizar a cor dos links.
### Adicionar código HTML 1\. Clique e arraste o elemento **HTML** para o template na posição desejada. Isso permitirá que você adicione **HTML** personalizado ao design, criando elementos únicos e adaptados ao seu estilo. Depois de soltar, é só colar o código desejado!
2\. Depois de adicionar o elemento **HTML** ao template, vá até a aba lateral direita para fazer ajustes. Nessa seção, você pode inserir o código que desejar, adaptando o design com o conteúdo **HTML** personalizado.
### Configurar corpo do template 1. No Menu lateral **Body** é possível configurar todo o corpo do template. Ao acessar o submenu **General**, é possível definir a cor do texto e do fundo, o tamanho e o alinhamento dos containers, além de personalizar a fonte e o tamanho do texto de toda a estrutura do e-mail.
### Duplicar ou deletar 1\. Para deletar uma linha, clique no primeiro ícone abaixo dela. Para duplicar, clique no segundo ícone. Essas opções facilitam a edição rápida do layout do seu template.
2\. Para criar uma cópia do template, basta selecionar o ícone indicado para duplicação e, em seguida, renomear a cópia conforme desejar. Isso permite que você mantenha o original e faça ajustes na nova versão
**Atenção: uma vez criado, o template não pode ser deletado. Portanto, revise bem antes de finalizar para garantir que tudo está conforme o esperado.** ### Mobile Quer ver como seu template fica no celular? É fácil! Basta clicar na opção **Mobile** na aba à direita ou no ícone de celular no canto esquerdo. Tente agora e veja como o design se adapta para telas menores
### Visualização 1\. Para ver como seu template ficará, é só clicar no ícone indicado. Assim, você pode conferir tudo antes de finalizar.
2\. Para ajustar a visualização, você pode selecionar o tipo de dispositivo (como desktop, tablet ou celular) em que deseja ver o template. Isso ajuda a garantir que o design fique perfeito em qualquer tela.
### **Salvar** Assim que o template estiver pronto, selecione **Salvar** para salvá-lo.
**Comece agora a personalizar seu template de e-mail!** Agora que você conhece todos os submenus disponíveis e como cada um pode ser utilizado, é hora de explorar e colocar sua criatividade em prática. **Personalize seu template de e-mail** com facilidade, fazendo ajustes simples e visualizando as mudanças em tempo real. Lembre-se de salvar seu progresso ao longo do caminho e de testar a versão mobile para garantir que seu template esteja perfeito em todos os dispositivos. Com essas ferramentas, você tem tudo o que precisa para criar um e-mail incrível, funcional e alinhado com a sua marca. Divirta-se e personalize seu template até ele ficar exatamente do jeitinho que você deseja! # Phone Configurar a Telefonia no Hablla é um processo simples e eficaz que permitirá à sua empresa se conectar com os clientes de forma ágil e profissional. Para facilitar a sua compreensão, dividimos o processo em quatro etapas principais: * Primeira etapa - Criar uma conta teste na DirectCall * Segunda etapa - Criar a credencial dentro do Studio Hablla. * Terceira etapa - Criar a conexão * Quarta etapa: Como testar Para conectar uma número de telefone para telefonia na Hablla será necessário ter uma conta de **Administrador** no Hablla. ### Primeira etapa: Criar uma conta teste na [DirectCall](https://teste.directcallsoft.com/hablla?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044) 1\. Crie uma conta no [DirectCall](https://teste.directcallsoft.com/hablla?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). Com essa conta, você terá direito a um teste gratuito até consumir os minutos liberados de forma gratuita.
2\. **Importante!** Você receberá um e-mail com instruções para conectar o tronco SIP. Siga os passos informados no email antes de prosseguir.
⚠️ **Atenção:** Ao finalizar a contratação com a parceira **DirectCall**, é necessário enviar um e-mail para **** solicitando a ativação da conta ou, siga para a próxima etapa. ### Segunda etapa: Criar a credencial dentro do Studio Hablla. 1. Já conectado em sua conta, acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações.
2. No lado esquerdo da tela no menu das Configurações, localize a seção **Credenciais.**
3. Em **Credenciais**, clique em **+ Nova Credencial** para adicionar uma nova.
4. Selecione a opção **Credencial de chamada.**
5. Preencha todos os campos. Ao finalizar, clique em **Salvar.** ### Terceira etapa: Criar a conexão 1. Com a credencial criada, vá para o lado esquerdo da tela e clique em **Conexões e Integrações**.
2. Agora, você verá todas as conexões disponíveis dentro da Hablla. Localize a conexão **Phone** e clique em **+ Adicionar.**
3. Preencha os campos com o **nome**, o **setor responsável**, a **credencial** criada anteriormente e escolha se deseja **fazer e receber ligações**. Por fim, clique em **Salvar**.
4. Pronto! Seu novo número para telefonia foi configurado com sucesso. ### Quarta etapa: Como testar 1. Acesse [studio.hablla.com](https://studio.hablla.com) Faça uma ligação de um número externo para o novo número cadastrado e verifique se está tocando no app.
2. Ligue para algum número externo por dentro do [app.hablla](https://app.hablla.com/login?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044) e verifique se consegue completar a ligação. **ℹ️ Observação:** Esta documentação aborda apenas o funcionamento da funcionalidade. Para informações sobre cobranças, custos ou condições comerciais, consulte o contrato vigente ou entre em contato com o setor responsável. **Lembre-se:** * Em caso de dúvidas ou dificuldades durante o processo de conexão, a equipe de suporte da Hablla está sempre à disposição para te auxiliar. [Entre em contato](https://api.whatsapp.com/send/?phone=551136701155\&text\&type=phone_number\&app_absent=0\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). * Ainda não é cliente Hablla? [Fale com um dos nossos consultores](https://api.whatsapp.com/send/?phone=551136701155\&text\&type=phone_number\&app_absent=0\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). * Se gostou do serviço de telefonia e gostaria de um número permanente, [entre em contato conosco](https://api.whatsapp.com/send/?phone=551136701155\&text\&type=phone_number\&app_absent=0\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). # Resposta Rápidas Crie e utilize Respostas Rápidas na Hablla para agilizar atendimentos humanos, padronizar mensagens, reduzir erros e aumentar a produtividade da equipe. ## Configurando respostas rápidas para atendimento As respostas rápidas são fundamentais para agilizar o atendimento ao cliente, permitindo que sua equipe responda de forma rápida e eficiente. Vamos aprender, passo a passo, como configurar essas respostas na Hablla e transformar a sua experiência de atendimento. ### **O que você precisa antes de começar?** Para criar motivos de atendimento, é necessário ter um usuário perfil **Administrador.**
1\. Já conectado em sua conta, acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1750773282927.8266088573585080\&sck=53bcba93-220f-42e0-98d6-4c25c5e985db\&external_id=53bcba93-220f-42e0-98d6-4c25c5e985db). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações.
\ 2\. No menu **Configurações** à esquerda, selecione **Respostas rápidas**.
3\. No lado esquerdo da tela, clique no botão **+Adicionar resposta rápida.**
4\. **Preencha os campos:** * **Nome:** insira um nome que sirva como identificador rápido para a resposta. * **Descrição:** escreva o corpo da mensagem que você deseja usar como resposta rápida. Após preencher essas informações, clique em **Salvar** para concluir a configuração!
5\. Para visualizar a nova resposta rápida, acesse a lista de respostas salvas. Caso precise fazer ajustes, clique na resposta para editar os detalhes conforme necessário.
6\. Para utilizar suas respostas rápidas, acesse[ app.hablla.com](http://app.hablla.com/?fbp=fb.1.1750773282927.8266088573585080\&sck=53bcba93-220f-42e0-98d6-4c25c5e985db\&external_id=53bcba93-220f-42e0-98d6-4c25c5e985db) e clique no menu superior **Atendimentos**. Lembre-se de que as respostas rápidas estarão disponíveis somente quando uma janela de atendimento estiver aberta, facilitando a interação e ajudando você a economizar tempo.\
7\. Na janela de atendimento, clique no ícone **@** na área de mensagens (como mostra a imagem abaixo). Esse ícone permite que você escolha entre as respostas rápidas salvas para agilizar suas interações com os clientes!
8\. **Escolha a resposta desejada:** depois de clicar no ícone, uma lista com suas respostas rápidas será exibida. Basta selecionar a mensagem desejada, e ela será automaticamente inserida no campo de mensagem, pronta para envio.\
9 . Para enviar uma resposta rápida, aguarde a mensagem aparecer no campo de texto. Em seguida, clique em "Enviar", e ela será enviada diretamente ao cliente.
**Pronto! Agora, com as respostas rápidas em uso, você está tornando o atendimento mais ágil e eficiente. Essa ferramenta ajuda a manter a comunicação consistente, economiza tempo e permite que você ofereça respostas de qualidade aos seus clientes de maneira prática e profissional.**
# Repositório (RPO) Em breve # Permissões Gerencie permissões na Hablla: defina perfis de usuário e administrador ou crie acessos personalizados para garantir segurança, organização e controle. {% embed url="" %} ## Permissões na Hablla As **Permissões** definem quais recursos cada membro do seu time pode acessar dentro da Hablla.\ Elas são fundamentais para garantir **segurança, organização e controle** sobre fluxos, atendimentos e configurações da plataforma. *** ### Tipos de permissões padrão #### 👤 Usuário * Acesso limitado às informações que foram atribuídas a ele. * Pode visualizar e atuar apenas nos atendimentos e pessoas que é responsável. * Ideal para **atendentes, SDRs e membros de equipe operacional**. #### 👨‍💼 Administrador * Acesso total a todas as funcionalidades da Hablla. * Pode visualizar **todas as conversas, atendimentos, pessoas e organizações**. * Tem acesso às **configurações, fluxos, dashboards e relatórios**. * Pode **convidar novos membros** para o Workspace. * Indicado para **gestores, líderes de equipe e responsáveis pelo ambiente**. *** ### Permissões personalizadas Além dos perfis padrão, a Hablla permite criar **perfis de permissão personalizados**, ajustando a experiência conforme a necessidade da sua empresa. Você pode definir: * Acesso a módulos específicos (Ex.: Fluxos, Pessoas, Oportunidades). * Acesso de leitura ou edição em relatórios. * Permissões de criação, edição e exclusão de registros. * Limitar quais setores ou times o usuário pode visualizar. Essa flexibilidade garante que cada colaborador tenha acesso apenas ao que precisa, evitando riscos e mantendo a governança da operação. ### Nível de permissão **Usuário** - O usuário só poderá acessar os registros que for dono ou seguidor. **Setor** - O usuário terá acesso aos registros dos setores relacionados na lista abaixo. Cada setor pode ter um nível de acesso diferente. **Todos** - O usuário terá acesso a todos os registros da área de trabalho. **Setores de usuários** - O usuário terá acesso a todos os registros que estão nos setores que ele tem acesso.
#### Pessoas Nessa seção, você pode ajustar a permissão a nível de **pessoas** de acordo com a sua regra de negócio.
#### Organizações Em organizações, você pode selecionar as permissões de acesso a nível de **Organizações** que melhor se adequem às necessidades da sua equipe.
#### Atendimentos Em atendimentos, você pode selecionar as permissões de acesso a nível de **Atendimentos** que melhor atendem às necessidades da sua equipe.
#### Cartões Na seção de Cartões, você pode alterar as permissões de acesso a nível dos **Cartões** da maneira que melhor atender as suas regras de negócio.
#### Tarefas Selecione aqui o nível de acesso que essa permissão terá no nível de **Tarefas**.
#### Comunicação Interna Nessa seção, você pode selecionar as permissões de acesso a área de **Comunicação Interna** da sua equipe que melhor atendam as suas necessidades.
#### Permissões de Função Nessa seção, você pode selecionar a permissão de acesso à algumas outras funcionalidades de usabilidade da sua área de trabalho.
### Como atribuir permissões 1. No menu **Configurações**, acesse a aba **Time**. 2. Clique no usuário desejado. 3. Selecione o nível de permissão: **Usuário, Administrador ou Personalizado**. 4. Em caso de permissão personalizada, configure os módulos e funções específicas. 5. Salve para aplicar. ### Resumo O sistema de permissões da Hablla garante: * **Segurança**: controle de acesso por perfil. * **Organização**: cada usuário vê apenas o que precisa. * **Flexibilidade**: possibilidade de criar perfis personalizados. *** 📌 **Dica prática**: mantenha administradores apenas para perfis estratégicos. Para equipes operacionais, use permissões limitadas ou personalizadas para reduzir riscos. # Motivos para atendimento Os motivos são utilizados para identificar e padronizar as ações realizadas na plataforma, como finalizações, arquivamentos, transferências, alterações de status e movimentações no CRM. ## ✅ Como criar um motivo 1. Acesse o menu **Configurações**. 2. Clique em **Motivos para atendimento**. 3. Selecione **Adicionar motivo**. 4. Preencha as informações: * **Nome:** Informe um nome claro e objetivo para o motivo. * Descrição do motivo. * Adicione um setor (caso este motivo seja utilizado para um setor especifico) * **Tipo:** Selecione em qual ação esse motivo será utilizado. 5. Clique em **Salvar**. Após salvar, o motivo ficará disponível para utilização conforme o tipo selecionado. ## **📂 Tipos de motivos** Ao criar um motivo, é necessário definir onde ele poderá ser utilizado. ### 🔚 Finalização de atendimento Utilizado quando um atendimento é encerrado. #### Exemplos: * Solicitação concluída * Cliente não respondeu * Problema resolvido * Atendimento duplicado ### 🗄️ Arquivamento de atendimento Utilizado quando um atendimento é arquivado para organização da operação. #### Exemplos: * Atendimento antigo * Conversa sem continuidade * Solicitação encerrada ### 🏆 Ganho de cartão (CRM) Utilizado quando um cartão é marcado como **Ganho**, indicando que o objetivo da negociação foi alcançado. #### Exemplos: * Venda concluída * Contrato assinado * Cliente convertido ### ❌ Perda de cartão (CRM) Utilizado quando um cartão é marcado como **Perdido**, registrando o motivo pelo qual a negociação não foi concluída. #### Exemplos: * Cliente desistiu * Concorrência * Sem retorno * Valor fora do orçamento ### 🚫 Indisponível para atendimento Utilizado quando o atendente altera seu status para indisponível. #### Exemplos: * Almoço * Reunião * Treinamento * Intervalo * Fim de expediente ### 🔄 Transferência de atendimento Utilizado sempre que um atendimento é transferido entre usuários, filas ou setores. #### Exemplos: * Encaminhado ao setor financeiro * Transferência para suporte técnico * Mudança de responsável * Escalonamento de atendimento ## ✏️ Como editar um motivo 1. Acesse **Configurações > Motivos para atendimento**. 2. Localize o motivo desejado. 3. Clique no motivo. 4. Faça as alterações necessárias. 5. Clique em **Salvar**. ## ⚠️ Exclusão e ocultação de motivos Após ser criado, um motivo **não pode ser apagado nem ocultado**. Essa restrição existe para preservar a integridade dos históricos da plataforma, garantindo que todas as ações já realizadas (como finalizações de atendimento, arquivamentos, transferências, alterações de status e movimentações no CRM) continuem exibindo corretamente o motivo utilizado no momento do registro. Caso um motivo não seja mais utilizado pela operação, ele deverá permanecer cadastrado, mesmo que deixe de ser utilizado em novas ações. # Horário Comercial Na Hablla, os horários de atendimento servem para definir o que acontece com cada mensagem recebida, dependendo da hora que ela chega. Isso permite personalizar a experiência do cliente de acordo com o horário em que ele interage com a empresa. **Exemplo:** imagine que o horário de atendimento da empresa é das 08:00 às 12:00 e das 14:00 às 18:00. Esses horários são configurados dentro da Hablla e integrados ao fluxo de atendimento pelo WhatsApp. * Se um cliente mandar uma mensagem **dentro do horário de atendimento** (como às 08:30), o sistema vai reconhecer que há equipe disponível e vai encaminhar a mensagem para um atendente.
* Já se o cliente mandar uma mensagem **fora do horário de atendimento** (por exemplo, às 01:00), o sistema identifica que não há atendimento ao vivo e oferece outras opções: pode enviar uma resposta automática, explicando o horário de atendimento, ou direcionar a mensagem para uma IA que responda no momento. ### O que você precisa antes de começar? Ter um usuário com perfil **administrador**.
### Como configurar horários de atendimento dentro da Hablla? 1\. Já conectado em sua conta, acesse o [Studio](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1712329167332.250162840\&sck=227645b2-b9a6-4863-9ce0-d3ac4e0793cc\&external_id=227645b2-b9a6-4863-9ce0-d3ac4e0793cc\&fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de **configurações**.
2\. No lado esquerdo da tela no menu das **Configurações**, localize a seção **Horário comercial**.
3\. Em seguida, selecione o botão ao lado esquerdo da tela **Novo horário comercial**. 1.
4\. Preencha os campos com o **Nome do horário** e o **Nome do período**, selecione o horário referente ao período criado e escolha os dias da semana em que esse período será aplicado.
5\. Para criar um novo período, escolha a opção **Adicionar Período**
6\. Preencha as informações referente ao novo período. Você pode adicionar o número de períodos que desejar.
7\. Caso queira excluir um período, selecione o ícone correspondente à ação de exclusão.
8\. Assim que finalizar a configuração do Novo horário, selecione **Salvar**.
9\. Confirme a criação do **Novo horário**.
10\. Os horários criados ficarão listados na seção **Horário Comercial**.
Para encerrar o passo a passo de configuração dos horários de atendimento para o time, você pode usar um texto assim: *** **Pronto!** 🎉 Agora você já configurou os horários de atendimento para o seu time na plataforma Hablla. Com isso, seu atendimento estará sempre alinhado com a disponibilidade da equipe, garantindo uma experiência mais organizada e ágil para os clientes. Se precisar ajustar os horários no futuro ou tiver alguma dúvida, é só voltar aqui e seguir este guia. Qualquer dificuldade, nosso suporte está sempre pronto para ajudar. 🚀 Agora, aproveite essa funcionalidade para otimizar ainda mais o atendimento ao seu público! # Fila de distribuição # Etiquetas As etiquetas são utilizadas para classificar e organizar atendimentos, facilitando a identificação de assuntos, segmentação de conversas, criação de filtros e geração de relatórios. ### ✅ Como criar uma etiqueta 1. Acesse o menu **Configurações**. 2. Clique em **Etiquetas**. 3. Selecione a opção **Nova etiqueta**. 4. Preencha as informações da etiqueta: * **Nome:** Informe o nome que identificará a etiqueta. * **Cor:** Escolha uma cor para facilitar a visualização (opcional, caso disponível). 5. Clique em **Salvar**. Pronto! A etiqueta estará disponível para utilização nos atendimentos e demais funcionalidades que utilizam etiquetas. ### ✏️ Como editar uma etiqueta 1. Acesse **Configurações > Etiquetas**. 2. Localize a etiqueta desejada. 3. Clique na etiqueta. 4. Realize as alterações necessárias. 5. Clique em **Salvar**. ### 🗑️ Como excluir uma etiqueta 1. Acesse **Configurações > Etiquetas**. 2. Localize a etiqueta que deseja remover. 3. Clique no icone de lixeira. ### 📌 Como adicionar uma etiqueta a um atendimento 1. Abra o atendimento desejado. 2. Localize o icone de informações do atendimento. 3. Clique em **Adicionar etiqueta**. 4. Selecione a etiqueta desejada. 5. A etiqueta será vinculada imediatamente ao atendimento. > **Atenção:** Caso a etiqueta esteja sendo utilizada em atendimentos, fluxos ou outras configurações, a exclusão pode impactar esses registros. # Domínios ## 🧭 Introdução O sistema permite que o usuário cadastre **domínios personalizados** para criar URLs próprias, amigáveis e fáceis de compartilhar.\ Esses domínios são usados em diversas funcionalidades — como calendários, páginas públicas, links de agendamento, formulários e áreas acessíveis por clientes externos. > 🌟 **Exemplo real:**\ > `https://agendamento.seusistema.com/hablla`\ > Neste caso, **hablla** é o *slug* configurado pelo usuário. **agendamento.seusistema.com** é o *domínio* configurado pelo usuário. *** ## 🎯 Para que serve o Domínio? O domínio permite que o usuário crie URLs personalizadas para: * 📅 Páginas de calendário e agendamentos * 💬 Webchat * 🛠 Serviços públicos da plataforma * 🔗 Links compartilháveis personalizados * 🧭 Identificação pública de recursos sem expor IDs internos > 💡 **Benefício direto:** melhora a identidade visual e facilita a divulgação, permitindo URLs memoráveis e profissionais. *** ## 🔍 O que é um **slug** e qual a diferença de um domínio? Um **slug** é a parte final de uma URL, que identifica de forma única um recurso dentro do sistema. Em um exemplo paralelo, seria a identificação de uma sala em um prédio. #### Exemplos: * `meusite.com/**suporte**` * `meusite.com/**atendente-joao**` * `meusite.com/**central**` #### Principais características: * 🔹 Deve ser **único** * 🔹 Deve ser **curto e amigável** * 🔹 Não pode conter espaços nem caracteres especiais complexos * 🔹 Torna a URL acessível e mais profissional *** ## ❌ Restrições importantes #### 🔸 1. Não é permitido repetir slugs Cada slug precisa ser único para evitar conflitos de URL. > 🛑 **Se dois calendários usassem o mesmo domínio:**\ > `agenda.hablla.com/suporte`\ > → O sistema não saberia qual calendário exibir. O correto é utilizar 2 slugs diferentes (permitido no mesmo dominio) > `agenda.hablla.com/suporte1`\ > `agenda.hablla.com/suporte2` *** ## ⚙️ Como cadastrar 1. Acesse a [Hablla](https://studio.hablla.com/) como administrador, navegue até configurações -> domínios -> +Adicionar domínio 2. Após adicionar seu domínio dentro da Hablla será necessário configurar o DNS para que ele seja ativado com sucesso, para isso clique sobre o domínio que acabou de cadastrar para abrir as informações sobre ele. 3. Com a janela aberta copie as informações e configure o DNS diretamente em seu provedor, após a propagação ele será ativado dentro da Hablla.
*** ## ❓ Perguntas Frequentes #### **Posso mudar o domínio depois?** Sim, desde que o novo domínio não esteja sendo usado. #### **O domínio afeta alguma automação interna?** Não — ele apenas define a URL pública. #### **O que acontece com a URL antiga após mudar o domínio?** Ela deixa de funcionar imediatamente. #### **O domínio pode ter acentos?** Não. Sempre use caracteres simples. # Credenciais As **credenciais** são um conjunto de informações que normalmente incluem um nome de usuário, senha, token ou chave de API. Elas são essenciais para autenticar e estabelecer uma conexão segura entre a plataforma omnichannel e diversos serviços, como e-mail, WhatsApp e CRMs, como o RD Station. Neste guia, você vai aprender **o que são e como usar as credenciais** para facilitar a integração e otimizar a comunicação. ### Como usar credenciais no Studio Hablla para integrar serviços * **Conectar-se ao serviço:** elas garantem que a ferramenta omnichannel tenha acesso autorizado ao serviço externo. * **Troca de dados segura:** com as credenciais corretas, a plataforma pode enviar e receber dados como mensagens, informações de leads e dados de clientes de forma segura. * **Automatização de processos:** ao conectar a plataforma a outros serviços, as credenciais possibilitam a automação de tarefas, como o envio de mensagens automáticas, o registro de interações e o acompanhamento de leads em um CRM. Vale lembrar que cada serviço (como WhatsApp, e-mail e RD Station) geralmente requer diferentes tipos de credenciais, pois cada um possui suas próprias regras de segurança e autenticação. ### Passo a passo para configurar credenciais no Studio Hablla 1\. Já conectado em sua conta, acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações.\
2\. No lado esquerdo da tela no menu das Configurações, localize a seção **Credenciais**.\
3\. No lado esquerdo da tela, clique em **+ Nova Credencial**. Isso permitirá que você configure uma nova conexão externa, possibilitando o envio e recebimento de dados, além da automação de tarefas.\
4\. Selecione o tipo de credencial que deseja criar, com base no serviço que você deseja integrar, como e-mail, WhatsApp, site, entre outros.\ \
4\. Insira as informações necessárias para a credencial que você escolheu e, em seguida, clique em **Salvar**.
**Viu como é fácil? Pronto! Sua credencial foi configurada no Studio Hablla. Agora, você pode gerenciar a conexão com o serviço selecionado, facilitando a comunicação e a automação de processos.** # Campos Personalizados Campos personalizados são campos criados especificamente para armazenar informações adicionais, além dos campos padrão disponíveis. Eles permitem personalizar os dados armazenados para melhor atender às necessidades específicas da empresa. Esses campos personalizados podem ser aplicados em diferentes categorias, como:
* **Pessoas:** adicione informações específicas sobre indivíduos, como "Data de Aniversário", "Cargo" ou "Preferências de Produto". * **Organizações:** armazene dados relevantes sobre empresas e instituições, como "Setor de Atuação", "Número de Funcionários" ou "Faturamento Anual". * **Produtos:** inclua atributos detalhados para cada produto, como "Modelo", "Categoria" ou "Garantia". * **Quadros:** aplique campos para a gestão visual de projetos, com dados como "Data de Entrega", "Prioridade" ou "Status da Tarefa". * **Produtos em Cartões:** quando produtos estão associados a cartões em quadros de tarefas, os campos personalizados permitem adicionar informações como "Preço", "Disponibilidade" ou "Código do Produto". Esses campos tornam a ferramenta mais flexível e adaptável às necessidades de organização e gestão de dados da empresa, facilitando o armazenamento e recuperação de informações relevantes. ### O que você precisa antes de começar? Ter um usuário com perfil **administrador**. ### Como criar e configurar campos personalizados na Hablla? 1\. Já conectado em sua conta, acesse o [**Studio**](https://studio.hablla.com/workspace/643d802021b6aa9234eb9797/marketing?fbp=fb.1.1753742035820.5658395625\&sck=730218fd-da2e-40d1-b6a8-b13deea06044\&external_id=730218fd-da2e-40d1-b6a8-b13deea06044). No canto superior direito da tela, ao lado da inicial do seu nome, você encontrará o ícone de **Configurações** (engrenagem). Clique nele para abrir o menu de configurações.
2\. No lado esquerdo da tela no menu das Configurações, localize a seção **Campos personalizados**.
3\. Selecione a categoria em que o novo campo será criado e clique em **+ Novo campo personalizado** para começar a configurar o seu primeiro campo. Isso permitirá que você organize as interações de forma eficiente dentro do Hablla.
4\. **Configuração do Campo:** 1. * Insira as informações necessárias para o campo: * **Nome**: Dê um nome claro e descritivo ao campo. * **Tipo**: Selecione o tipo de dado (texto, número, data, etc.). * **Valor Padrão** (opcional): Informe o valor padrão se aplicável. * **Descrição**: Escreva uma breve descrição para esclarecer a função do campo. * **Opções de Exibição**: Defina se o campo será obrigatório e visível. * Clique em **Salvar** para concluir.
5\. Os novos campos criados ficarão listados na seção **Campos Personalizados.** 1.
6\. Caso queira excluir um campo, selecione o ícone correspondente à ação de exclusão. 2.
7\. Utilize a barra de pesquisa ou o botão **Filtros** para encontrar campos específicos, filtrando por tipo, data de criação, visibilidade e obrigatoriedade. 3.
8\. Caso escolha a opção **Filtros**, é possível filtrar campos pelo tipo, período de criação, visibilidade e obrigatoriedade. 4.
Esses passos permitem personalizar o armazenamento de dados e tornam a gestão de informações no Hablla mais eficaz e alinhada às necessidades de sua empresa. # Calendário Crie e gerencie calendários para organizar atendimentos, eventos e disponibilidade do time. ## 🗓️Visão geral Os calendários da Hablla permitem criar agendas personalizadas para cada usuário, facilitando a organização de agendamentos internos. Assim como no Google Calendar, cada calendário possui um link exclusivo para que clientes possam agendar eventos diretamente. *** ## ⚙️Como configurar 1. Acesse sua conta dentro de [Studio](https://studio.hablla.com/), navegue até C**onfigurações -> Calendários.** 2. Para configurar um novo calendário clique sobre **Novo calendário.** 3. Será carregada um painel lateral (Drawer) para o preenchimento das informações: ***
CampoDescrição
📝 NomeNome do calendário.
📄 DescriçãoObjetivo, instruções ou detalhes do evento.
👤 UsuárioUsuário responsável pelo calendário.
🕒 Horário comercialHorário disponível para agendamentos.
🔗 SlugNome utilizado na URL do calendário. Ex.: calendar.hablla.io/meu-calendario
⏱️ DuraçãoTempo do evento em minutos.
⏳ IntervaloTempo entre os horários disponíveis.
**Exemplo de preenchimento:**
*** # Configuração de SLA SLA (Service Level Agreement) significa Acordo de Nível de Serviço. No contexto de atendimento, ele representa o compromisso de tempo e qualidade assumido ao abrir um chamado ou solicitar suporte. O SLA ajuda a estabelecer critérios claros e mensuráveis, trazendo mais segurança e organização para o atendimento. Ele contribui para: • Garantir transparência em relação aos prazos de resposta\ • Apoiar a equipe na priorização das demandas\ • Acompanhar e evoluir a eficiência do atendimento Aqui na Hablla, contamos com configurações de SLA pensadas para otimizar o fluxo de atendimento e apoiar a priorização das solicitações, tornando a experiência mais ágil, organizada e alinhada às necessidades do cliente. \ Ao acessar o campo de configurações no canto superior direito da sua tela, você encontrará a opção de gerenciamento de SLA. Nessa área, é possível organizar e definir os prazos para cada canal de atendimento, como WhatsApp, Instagram, e-mail, ligação, Facebook e Telegram. Dentro de cada canal, você poderá configurar os tempos de atendimento de forma personalizada, garantindo que os prazos estejam alinhados com a estratégia da sua operação e contribuindo para um fluxo mais organizado e eficiente. \ Dentro de cada uma dessas configurações, você encontrará opções como definição de tempo e cadastro de mensagens pré-programadas, pensadas para manter a consistência e a qualidade do atendimento em todos os contatos.
Também é possível definir um prazo organizado para o retorno do atendente ao cliente, ajudando a manter o ritmo da operação sem comprometer a experiência e a atenção dedicada em cada interação. \ TPR – Tempo de Primeira Resposta
Com essa funcionalidade, você pode definir um tempo máximo para que o atendente realize o primeiro contato com o cliente após o início do atendimento. Isso ajuda a manter agilidade e alinhar expectativas desde o primeiro momento da conversa. Além de configurar o prazo da primeira resposta, também é possível definir ações automáticas para os casos em que esse tempo não seja cumprido, garantindo que o fluxo continue organizado e que o cliente receba a devida atenção de forma estratégica.
\ • Transferência: após o tempo configurado, o atendimento é direcionado automaticamente para o setor e/ou usuário previamente definido, garantindo continuidade e mantendo o fluxo organizado. • Finalizar: ao atingir o prazo estipulado, o atendimento é encerrado automaticamente, contribuindo para uma gestão mais estruturada das conversas. • Arquivar: depois do tempo definido, o atendimento é arquivado de forma automática, facilitando a organização da fila e do histórico. • Mensagem: É possível programar o envio automático de uma mensagem ao atingir o prazo configurado, dando início ao atendimento e mantendo a comunicação ativa com o cliente. A mesma lógica se aplica ao TMR e ao TMC. A única diferença é que, no tempo de finalização, não há configuração de ações adicionais. Essas regras são válidas para todos os canais, garantindo padronização, clareza nos processos e uma experiência consistente em cada atendimento. As configurações de gerenciamento de SLA podem ser personalizadas para cada setor diretamente na aba de setores, permitindo que cada equipe tenha seus próprios prazos alinhados à sua rotina e estratégia de atendimento. Além disso, essas configurações podem ser acompanhadas pela tela de monitoramento de usuários, facilitando a visualização do desempenho e apoiando uma gestão mais estratégica e organizada do time. \
# Feed O Feed da Hablla reúne comunicação interna e redes sociais. Publique textos, imagens e vídeos, fixe posts, agende conteúdos e responda comentários.
O **Feed da Hablla** é a área central de comunicação interna e integração com redes sociais. É aqui que você acompanha em tempo real as atualizações da sua equipe, setores específicos ou até mesmo das contas conectadas do **Instagram** e **Facebook**. Esse espaço funciona como um mural colaborativo, que pode ser usado tanto para alinhamento interno quanto para gestão de interações externas.\ No Feed, você pode: * Visualizar e interagir com posts internos. * Filtrar conteúdos por setores ou deixar aberto a todos os usuários. * Publicar textos, imagens e vídeos. * Fixar postagens importantes no topo. * Acompanhar e executar **tarefas do dia** diretamente da tela. * Conectar contas de **Instagram** e **Facebook**, para publicar, agendar conteúdos e responder comentários. *** ### Feed da Hablla O **Feed interno** é o canal de comunicação colaborativa dentro da plataforma. Aqui você pode: * **Publicar conteúdo** em formato de texto, imagem ou vídeo. * **Fixar postagens** para destacar avisos importantes. * **Interagir** com publicações curtindo ou reagindo. * **Organizar o feed** por setores (ex.: Marketing, CS, Suporte), ou deixá-lo aberto a todos os usuários da empresa. 👉 Ideal para alinhamentos rápidos, comunicados oficiais e trocas de informação sem precisar de e-mails ou grupos externos. *** ### Feed de Redes Sociais A Hablla também permite integrar suas contas de **Instagram** e **Facebook** diretamente ao Feed. Nessa área, você pode: * **Publicar conteúdos** (texto, imagem e vídeo). * **Agendar publicações** para datas futuras. * **Curtir e responder comentários** das postagens, sem sair da Hablla. 👉 Isso transforma o Feed em uma central de **gestão de redes sociais**, otimizando tempo e garantindo maior proximidade com seu público. *** ### Tarefas do Dia Assim como no Dashboard, no **Feed** você também encontra a área de **Tarefas do Dia**.\ Essa seção mostra de forma objetiva quais atividades estão atribuídas a você no dia atual, com hora e descrição. 👉 Assim, mesmo navegando pelo Feed, você mantém o controle das prioridades do dia a dia. *** ### Resumo O **Feed da Hablla** é um ponto de convergência: * Para dentro da empresa, atua como um mural digital, fortalecendo a comunicação entre setores e equipes. * Para fora, integra suas redes sociais, permitindo centralizar publicações, interações e agendamentos. É a combinação entre **comunicação interna + gestão de redes sociais**, em um só lugar. # Dashboard Visualize tarefas, atendimentos, oportunidades e tickets em um só lugar. O Dashboard da Hablla centraliza indicadores e prioridades do dia.
O **Dashboard da Hablla** é o ponto de partida da sua jornada dentro da plataforma. É a primeira tela exibida ao fazer login e foi projetada para ser um **painel de visão geral da operação**.\ Nele você encontrará um resumo das principais informações que ajudam a acompanhar produtividade, engajamento do time e andamento das atividades, sem precisar navegar por diferentes módulos. No Dashboard, você terá acesso a: * **Feed da equipe** com comunicados e atualizações internas. * **Tarefas do dia**, listando atividades específicas atribuídas a você. * **Indicadores de tarefas**, que mostram andamento, produtividade e eficiência do tempo. * **Indicadores de atendimento**, com métricas de SLA, satisfação e resolutividade. * **Oportunidades comerciais**, detalhando o funil de vendas em tempo real. * **Tickets de suporte**, que apresentam a saúde dos chamados técnicos. Essa tela é constantemente atualizada pela nossa equipe para refletir melhorias na experiência de uso. Por isso, algumas métricas podem mudar de lugar, serem renomeadas ou até descontinuadas. O objetivo é sempre oferecer uma visão clara e útil para sua rotina. *** ### Feed da Equipe O **Feed da Equipe** é uma área de comunicação rápida. Ele concentra: * Avisos e comunicados feitos por gestores ou pela equipe de Hablla. * Atualizações de sistema, como melhorias e manutenções. * Mensagens gerais para manter todos os usuários informados. 👉 Pense nele como um mural digital para garantir alinhamento do time sem depender apenas de e-mails ou grupos externos. *** ### Tarefas do Dia Aqui aparecem as **atividades atribuídas diretamente a você**, com prazos e horários definidos. * Cada tarefa é listada de forma objetiva (ex.: *“Ligar para Marcus às 12h”*). * Ao concluí-la, basta marcar como finalizada para manter seus indicadores atualizados. * Essa seção é essencial para quem quer organizar o dia sem se perder entre múltiplos canais e compromissos. 👉 Essa área é especialmente útil para profissionais que lidam com muitas interações diárias, pois centraliza tudo em um único painel. *** ### Indicadores de Tarefas O bloco de tarefas vai além da simples lista. Ele entrega **métricas de produtividade e eficiência**: * **Tipos de tarefas pendentes e concluídas**: organiza por chamadas, e-mails, reuniões, chats ou outras categorias. * **Resumo geral**: mostra o percentual de tarefas concluídas, pendentes e atrasadas, permitindo entender o status do seu fluxo de trabalho. * **Tempo total gasto x tempo previsto**: ajuda a identificar se o esforço real está alinhado ao planejado. * **Taxa de reprogramação**: calcula o percentual de atividades que precisaram ser reagendadas. * **Eficiência no uso do tempo**: mensura a produtividade geral no cumprimento das tarefas. 👉 Esse conjunto de indicadores é importante para gestores acompanharem performance do time e para cada usuário entender onde pode melhorar sua gestão de tempo. *** ### Indicadores de Atendimento O painel de atendimento mostra como está a **qualidade e velocidade de resposta ao cliente**.\ Aqui você encontra: * **Atendimentos em andamento**: quantos clientes estão sendo atendidos no momento. * **Atendimentos finalizados no período**: total resolvido em um intervalo específico. * **Tempo médio de primeira resposta**: indicador crítico para SLA (Service Level Agreement). * **Tempo médio de atendimento**: ajuda a identificar gargalos em interações mais longas. * **CSAT (Customer Satisfaction Score)**: mede o nível de satisfação do cliente com o atendimento recebido. * **FCR (First Contact Resolution)**: percentual de casos resolvidos no primeiro contato, sem necessidade de retorno. 👉 Esses dados são fundamentais para áreas de Customer Experience (CX) avaliarem a eficiência do suporte e garantirem uma experiência mais fluida para o cliente. *** ### Indicadores de Oportunidades Essa área é voltada para a **gestão do funil de vendas**.\ No Dashboard, você pode visualizar: * **Em progresso**: número e valor financeiro de negociações em andamento. * **Ganhos**: solicitações convertidas com sucesso, indicando novas receitas. * **Perdidos**: solicitações que não se converteram, com valor associado. * **Em atraso**: oportunidades que ultrapassaram o prazo esperado. 👉 Com esses dados, os times comerciais conseguem acompanhar a performance e priorizar negociações que exigem maior atenção. *** ### Indicadores de Tickets Os **Tickets** representam a área de suporte técnico ou atendimento a solicitações mais complexas.\ Aqui são exibidos: * **Tickets em atraso** * **Tickets em andamento** * **Tickets finalizados** * **Tickets cancelados** 👉 Esse painel permite acompanhar a saúde do suporte e identificar gargalos que podem comprometer a experiência do cliente. *** ### Resumo O Dashboard da Hablla não é apenas um painel de números. Ele foi desenhado para oferecer uma **visão panorâmica do seu negócio em tempo real**, ajudando você a: * Organizar o seu dia com clareza. * Medir sua produtividade e da equipe. * Acompanhar atendimentos e satisfação de clientes. * Monitorar oportunidades comerciais e tickets de suporte. Com ele, você sempre começa o dia sabendo exatamente **onde está e o que precisa fazer para avançar**. # Marketing O módulo de Marketing da Hablla integra atração, conversão e relacionamento para gerar crescimento previsível e receita conversacional. A área de **Marketing** da Hablla é o núcleo estratégico para atrair, engajar e converter clientes dentro do ecossistema do **MCI – Marketing Conversacional Integrado**.\ Ela organiza as ações em três grandes frentes — **Atração, Conversão e Relacionamento** — permitindo que equipes de growth, marketing e vendas atuem de forma integrada, escalável e orientada por dados.
### 📌 Principais funcionalidades #### 🔹 Atração Ferramentas voltadas para aumentar a visibilidade da marca e gerar tráfego qualificado: * **SEO**: otimize sua presença nos motores de busca. * **Mídias sociais**: gerencie suas estratégias de conteúdo e relacionamento digital. #### 🔹 Conversão Recursos para transformar visitantes em leads e oportunidades de negócio: * **Formulário**: criação de formulários inteligentes e interativos. * **Landing Page**: desenvolvimento de páginas otimizadas para conversão. * **Short-Link**: links curtos personalizados com rastreamento de performance. * **Conversões**: monitoramento de todas as interações e eventos em tempo real. * **Hablla Tag Manager**: insira um único script em seu site e gerencie eventos e rastreamentos sem esforço técnico. * **Link na bio**: construa uma página única com todos os seus links estratégicos para redes sociais. #### 🔹 Relacionamento Ferramentas para nutrição e engajamento contínuo ao longo da jornada do cliente: * **Segmentação**: direcione comunicações personalizadas com base em critérios avançados. * **Disparo em massa**: alcance sua audiência de forma ampla e estratégica. #### 🔹 Fluxo de Automação * **Régua de comunicação**: crie sequências inteligentes para manter o engajamento ativo. * **Campanha**: planeje, execute e mensure campanhas integradas. ### 🎯 Benefícios estratégicos * **Centralização**: todos os recursos de marketing em um só ambiente. * **Integração nativa**: conectado às áreas de Vendas, CS e Atendimento. * **Escalabilidade**: automações que reduzem esforço manual e aumentam previsibilidade. * **Mensuração em tempo real**: dados consolidados para otimizar investimentos. * **Foco no ROI**: cada ação está ligada diretamente ao impacto em receita e performance. ### 🚀 Por que usar? O módulo de Marketing da Hablla foi desenhado para ser o **hub de crescimento previsível da sua empresa**.\ Com ele, você consegue: * Atrair audiência qualificada. * Converter visitantes em leads e oportunidades. * Nutrir relacionamentos de forma personalizada. * Integrar marketing com vendas e atendimento. * Tomar decisões baseadas em dados em tempo real. Em resumo: o Marketing da Hablla transforma ações isoladas em uma **estratégia conversacional integrada**, onde cada interação contribui para aumentar a **receita recorrente e sustentável** da sua empresa. # SEO Futuro Lançamento ## Funcionalidade de SEO — Score e Diagnóstico de Páginas A funcionalidade de **SEO Score por Página** da Hablla permite que cada página publicada seja analisada em tempo real, recebendo uma pontuação percentual e um diagnóstico detalhado dos pontos fortes e oportunidades de melhoria para otimização nos motores de busca. Essa análise é realizada com base em boas práticas consolidadas de SEO técnico e de conteúdo, permitindo que o usuário corrija problemas antes de publicar ou indexar uma página.
*** ### Visão Geral do Score * **Score Global (%):** Indicador visual (de 0 a 100%) que reflete o nível geral de otimização SEO da página. * **Classificação por Cores:** * **Vermelho:** Score crítico (0–69%) * **Amarelo:** Score intermediário (70–89%) * **Verde:** Score otimizado (90–100%) A pontuação é atualizada automaticamente conforme ajustes são realizados no conteúdo, código ou configurações da página. *** ### Diagnóstico de Problemas Ao lado do score, o sistema apresenta uma lista dos **principais problemas** encontrados na página, priorizando aqueles que têm maior impacto em indexação, ranqueamento e experiência do usuário. **Exemplos de problemas detectados:** * Meta title ausente ou duplicado. * Ausência de microdados (impacta rich snippets). * Proporção de conteúdo textual baixa. * Taxa de legibilidade insuficiente. * Inconsistências de charset. * Falta de texto alternativo em imagens. * Títulos com comprimento inadequado. Cada problema é apresentado com um **título e descrição clara**, permitindo ação imediata para correção. *** ### Bons Resultados Quando uma página cumpre boas práticas, elas são listadas como **Bons Resultados**, reforçando pontos de conformidade já atendidos. #### Configuração Técnica * **Canonical configurada:** evita problemas de conteúdo duplicado. * **Doctype configurado corretamente:** garante renderização otimizada. * **Meta tag de codificação presente:** compatibilidade com todos os navegadores. * **HTTPS ativo e sem links HTTP inseguros:** segurança e confiança. * **Sem redirecionamentos desnecessários:** tempo de resposta mais rápido. * **Configuração de domínio correta:** evita conflitos entre `www` e não-`www`. #### Conteúdo e Estrutura * **Tags HTML atualizadas e sem obsolescência.** * **Meta tags únicas e títulos únicos por página.** * **Descrição meta relevante e alinhada ao conteúdo.** * **Palavras-chave estratégicas na URL e no conteúdo.** * **URL amigável e otimizada.** * **Proporção de conteúdo adequada e sem placeholder.** * **Título com comprimento ideal e presença de tag H1.** #### Performance e Acessibilidade * **Tempo de carregamento e espera adequados.** * **Sem uso de Flash ou frames.** * **Tamanho da página dentro dos limites recomendados.** * **Links válidos e sem erros 4xx ou 5xx.** * **Microdados configurados corretamente.** * **Favicon configurado, melhorando a identidade visual.** *** ### Benefícios para o Usuário * **Correção Proativa:** Identificar e resolver problemas antes da publicação ou indexação. * **Melhoria Contínua:** O score é dinâmico e incentiva ajustes incrementais. * **Padronização:** Garantia de conformidade técnica em todas as páginas. * **Performance de Ranqueamento:** Aumento de relevância e competitividade nos resultados de busca. * **Experiência do Usuário:** Melhoria na usabilidade, acessibilidade e tempo de carregamento. *** ### Fluxo de Uso 1. **Acesse a Página:** No editor Hablla Studio, selecione a página que deseja otimizar. 2. **Verifique o Score:** O painel de SEO exibe a pontuação atual. 3. **Analise os Problemas:** Revise a lista de oportunidades de melhoria e aplique as correções. 4. **Valide os Bons Resultados:** Confirme que boas práticas já estão implementadas. 5. **Atualize e Reavalie:** Salve as alterações e acompanhe a evolução do score. # Formulário Os **Formulários da Hablla** permitem criar interfaces de captura de dados por **arrastar e soltar** (drag-and-drop).\ Você monta o layout, configura cada campo e publica para uso em páginas, fluxos e integrações. > **Como funciona:** escolha os componentes, arraste para a área de edição e ajuste as propriedades nas abas de configuração de cada campo.
### Biblioteca de componentes #### Basic * **Text Field**: campo de texto curto (ex.: nome). * **Text Area**: texto longo (observações). * **Number**: números inteiros/decimais. * **Password**: senha (oculta). * **Checkbox**: verdadeiro/falso. * **Select Boxes**: múltipla seleção por checkboxes. * **Select**: lista suspensa (uma opção). * **Radio**: seleção única por botões de rádio. * **Button**: botões de ação (Enviar, Voltar etc.).
#### Advanced * **Email** • **Url** • **Phone Number** * **Tags**: múltiplos valores com chips. * **Address**: endereço estruturado. * **Date/Time** • **Day** • **Time** * **Currency**: valores monetários. * **Survey**: matriz de perguntas. * **Signature**: assinatura digital.
#### Layout * **HTML Element**: bloco HTML livre. * **Content**: texto estático/MD. * **Columns**: colunas responsivas. * **Field Set** • **Panel**: agrupar campos. * **Table**: grade tabular simples. * **Tabs**: navegação por abas. * **Well**: caixa de destaque.
#### Data * **Hidden**: valor oculto (ex.: UTM). * **Container**: objeto com subcampos. * **Data Map**: pares chave/valor dinâmicos. * **Data Grid / Edit Grid**: listas editáveis (linhas repetíveis).
#### Premium * **File**: upload de arquivos. * **Nested Form**: reaproveitar outro formulário. * **Custom**: componente de lógica própria.
*** ### Configuração de cada campo Cada componente possui abas de configuração. As mais usadas: * **Display (Exibição)**\ Rótulo, placeholder, ajuda (tooltip), posição do rótulo, máscara de entrada e de exibição, CSS de classe, visibilidade. * **Data (Dados)**\ Chave interna (`key`), valor padrão, fonte de dados (estático, remoto), mapa de valor/rótulo, persistência. * **Validation (Validação)**\ Obrigatoriedade, tamanho mínimo/máximo, regex, limites numéricos, mensagens de erro personalizadas. * **API**\ Nome de propriedade, referência para integrações e webhooks. * **Conditional (Condição)**\ Mostrar/ocultar baseado em regras (ex.: “mostrar *Telefone* se *Receber contato por WhatsApp* = Sim”). * **Logic (Lógica)**\ Ações ao mudar o valor (preencher automático, copiar de outro campo, executar expressão). * **Layout**\ Colunas, largura, responsividade e agrupamentos. > **Dica:** defina `Label` (o que o usuário vê) e `Key` (o identificador técnico) com nomes claros. Ex.: `Label: Nome`, `Key: nome`. *** ### Exemplo: campo **Nome** (JSON) Abaixo um exemplo minimalista de um **Text Field** para capturar o nome do contato.\ Você pode copiar, adaptar e reutilizar. ```json { "label": "Nome", "placeholder": "Digite seu nome completo", "description": "Informe como deseja ser chamado.", "tooltip": "Use apenas letras e espaços.", "type": "textfield", "key": "nome", "autocomplete": "name", "input": true, "validate": { "required": true, "minLength": 2, "maxLength": 120, "pattern": "^[A-Za-zÀ-ÖØ-öø-ÿ'\\- ]+$", "customMessage": "Digite um nome válido (apenas letras)." }, "widget": { "type": "input" }, "persistent": true, "clearOnHide": true, "hidden": false } ``` ### Melhores práticas 1. **Padronize chaves (`key`)**\ Use `camelCase` ou `snake_case` e evite espaços (ex.: `telefoneWhatsApp`, `aceiteTermos`). 2. **Valide na borda**\ Aplique validações (regex, min/max, required) para reduzir dados inválidos e retrabalho. 3. **Use máscaras quando fizer sentido**\ Ex.: telefone, CPF/CNPJ, CEP. Máscara orienta o preenchimento e reduz erros. 4. **Agrupe o que pertence junto**\ Use **Panels**, **Field Sets** ou **Tabs** para tornar o formulário escaneável. 5. **Condições deixam o fluxo inteligente**\ Exiba campos apenas quando forem relevantes para reduzir atrito. 6. **Teste em dispositivos reais**\ Verifique responsividade e acessibilidade (teclado, leitores de tela, contraste). *** ### Publicação e uso * **Salvar e pré-visualizar:** confira erros de validação e responsividade. * **Integrar em fluxos:** use o formulário para capturar leads, abrir tickets, alimentar Pessoas/Organizações ou disparar automações. * **Exportar envios:** combine com relatórios para analisar conversões e qualidade de dados. *** ### Resumo * Monte formulários por **arrastar e soltar**. * Configure cada campo pelas abas **Display, Data, Validation, API, Conditional, Logic, Layout**. * Padronize chaves, valide entradas e use condições para **experiências mais rápidas e assertivas**. 📌 **Dica prática:** comece pequeno (Nome, Email, WhatsApp), valide os campos, publique, e só então evolua o formulário com grupos, lógicas e grids conforme o caso de uso. # Landing Page ## Hablla — Landing Page Para que serve: construir e publicar uma landing page simples, usando blocos visuais ou código (HTML/CSS). \ Importante: antes de editar, tenha um HTML e um CSS prontos (pode pedir a uma IA para gerar).
*** ### 1) Acesso e criação do projeto 1. Vá em Marketing → Landing Page.\
2. Clique em Adicionar projeto (modelo em branco) e dê um nome.\
Resultado: você entra no Editor do projeto.
*** ### 2) Entendendo a tela do Editor * Topo (direita):\
* Criar modelo → salva o layout atual como um template para reutilizar depois.\
* Editor de Código → abre modal com duas abas para colar HTML e CSS.\
* Salvar e Publicar → publica a página (o link ficará disponível na lista de projetos).\
* Topo (centro): seletor Desktop/Mobile (para conferir o responsivo).\
* Esquerda: Páginas e Layers (árvore dos elementos para facilitar a seleção).\
* Centro: Canvas (onde você vê e monta a página).\
* Direita: Styles e Properties (ajustes visuais e atributos do item selecionado).
\
*** ### 3) Opção A — Montar com blocos (drag & drop) No painel de Blocks (paleta), você tem os componentes: * Section (cria uma seção); 1 Column / 2 Columns / 3 Columns (estrutura de colunas)\
* Heading (título), Text (texto)\
* Image (imagem), Link / Link Box (links), Video, Map\
Como usar (exemplo rápido): 1. Arraste uma Section para o Canvas.\
2. Dentro dela, arraste 2 Columns.\
3. Na esquerda: Heading + Text. Na direita: Image (faça upload).\
4. Selecione cada item e ajuste em Styles (tipografia, cor, espaçamento, fundo).\
***
### 4) Opção B — Montar com código (HTML/CSS) 1. Clique em Editor de Código.\
2. Na aba HTML, cole o HTML da sua landing.\
3. Na aba CSS, cole os estilos.\
4. Clique em Salvar para aplicar no Canvas.\
Observação: se quiser usar formulário nativo da plataforma depois (para lead/tag/webhook), não insira \
no HTML — monte a estrutura visual e, quando houver o bloco de formulário, use-o no editor.
*** 5\) Publicar e obter o link 1. Clique em Salvar e Publicar.\
2. Volte para a lista de projetos; o projeto publicado exibe Link ativo.\
3. Copie o link para divulgação.\ \
*** \
### Checklist rápido * HTML e CSS colados (ou blocos adicionados) e salvos\
* Ajustes visuais em Styles/Properties\
* Desktop/Mobile conferido\
* Salvar e Publicar feito\
* Link com Link ativo copiado\
* (Opcional) Criar modelo para reutilizar\
*** #### Dica final (pré-requisito) Se não tiver código, peça a uma IA: “Gerar HTML (sem frameworks) e CSS mobile-first para uma landing com hero (título, subtítulo, CTA), 3 benefícios em cards e CTA final.”\ Depois, cole no Editor de Código (HTML/CSS) e ajuste no Styles.
*** ###
# Short-Link Links curtos e inteligentes para rastrear campanhas, gerar QR Codes e analisar resultados de forma ágil. ### O que é o Short-Link Short-Link é uma funcionalidade que permite criar links personalizados e compactos (por exemplo, `habl.la/contato`) que redirecionam para uma URL longa — ideal para divulgação em campanhas, redes sociais, e-mail ou WhatsApp.\ Você acompanha automaticamente as **visualizações**, gera **QR Codes** e adiciona parâmetros **UTM** para rastreamento fácil e consistente.
### Quando usar | Cenário | Por que usar o Short-Link | | ---------------------------- | -------------------------------------------------------- | | Redes sociais ou posts | CTA mais limpo, visual e fácil de memorizar | | Materiais impressos/QR Codes | Código gerado automaticamente para escaneamento simples | | Campanhas regionais | Aplicar UTM de fonte, meio ou campanha com rápido acesso | | Links longos ou genéricos | Encortar URLs com estética e performance otimizadas | ### Como criar um Short-Link 1. Navegue até **Marketing → Short-Link**. 2. Clique em **+ Novo short link**. 3. Preencha os campos: * **Nome** → referência interna (ex.: `fale_conosco`) * **URL de destino** → o link completo para onde será redirecionado. * **UTM parâmetros** → defina `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` e `utm_content`. 4. Clique **Salvar**. O sistema gera o link curto e já começa a rastrear acessos. **Exemplo de criação:**
### O que você vê na lista de Short-Links * **Link curto** gerado (`habl.la/contato`) * **URL de destino configurada** * **Número de visualizações** atualizadas em tempo real * Ícone de **lixeira** para deletar o link quando quiser ### Visualizar detalhes e exportar QR Code Clicando sobre um Short-Link existente, você acessa: * **Visualização do link curto** com opção de copiar * **QR Code** para escanear ou baixar * **Configurações de UTM** que foram aplicadas **Exemplo de visualização:**
### Boas práticas para usar o Short-Link * Use nomes curtos e intuitivos (ex.: `evento-agosto`) * Padronize UTM para manter clareza nos relatórios * Use os QR Codes em materiais offline com alta conversão * Apague links inativos ou com baixa conversão regularmente *** #### Resumo O Short-Link combina: * **Compartilhamento simplificado** com links curtos e impacto visual * **Rastreamento inteligente** com parâmetros UTM configuráveis * **Relatórios práticos** de visualização + QR Code embutido Use essa ferramenta para tornar suas campanhas mais limpas, rastreáveis e eficientes. # Conversão ## Conversões A tela **Conversões** centraliza os *eventos operacionais e de marketing* disparados na Hablla — criação/atualização de cadastros, mudanças de status, ações em cartões, entre outros.\ Ela funciona como um **log auditável** para observabilidade e troubleshooting: você acompanha a linha do tempo, aplica filtros e pode inspecionar o **payload bruto (JSON)** de cada evento. > ⚠️ A lista de eventos evolui continuamente. Novos tipos podem ser adicionados e alguns nomes podem mudar conforme melhorias do produto.
### Como ler a timeline Cada linha exibe: * **Tipo do evento** (ex.: *Conversão*, *Criou uma pessoa*). * **Contexto/entidade** (ex.: pessoa, cartão, usuário, organização). * **Mensagem resumida** com o que aconteceu. * **Data e hora** *(carimbo temporal)*. * **Ações**: * **JSON** → abre o payload completo do evento. * **Ver dados atualizados** / **Dados antigos** → quando houver comparação entre antes/depois. *** ### Filtros Use o botão **Filtros** (canto superior direito) para refinar a timeline por: * **Tipo de evento** * **Período (data e hora)** * **Origem** (quando aplicável) * **Entidade** (pessoa, cartão, etc.) #### Período (Data e Hora) Permite restringir os eventos por intervalo temporal **preciso**, combinando data e horário. Campos: * **Data inicial** e **Hora inicial** * **Data final** e **Hora final** Comportamento: * O intervalo é **inclusivo**: eventos com carimbo exatamente na **hora inicial/final** também entram no resultado. * Se você **não** preencher as horas: * **Hora inicial** assume `00:00` * **Hora final** assume `23:59` * Validação impede **data/hora final anterior** à inicial. * O fuso utilizado é o **fuso configurado no workspace**. Exemplos rápidos: * “Hoje, das 09:00 às 12:00” → encontre picos matinais de conversões. * “Ontem, 18:00 até Hoje, 09:00” → monitore efeitos de campanhas noturnas. * “Últimos 7 dias completos” → **Data inicial** = hoje−7, **Hora inicial** = `00:00`; **Data final** = hoje, **Hora final** = `23:59`. > Dica: combine **Tipo de evento + Período** para acelerar diagnósticos em campanhas e integrações. *** ### Tipos de eventos (exibidos nesta tela) Abaixo, os eventos informados para esta página. Novos eventos podem aparecer ao longo do tempo. | Evento | O que significa na prática | Quando usar | | ----------------------- | --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | **Conversão** | Registro de uma conversão (ex.: formulário, fluxo, short-link com UTM) vinculado a uma pessoa/lead. | Medir performance, atribuição de campanha e jornada de aquisição. | | **Criou uma pessoa** | Um novo contato foi adicionado à base. | Confirmar ingestão de leads (planilha, API, formulário, webhook etc.). | | **Alterou os dados de** | Dados cadastrais/atributos de uma pessoa foram atualizados. | Auditar origem de atualizações e entender *quando* e *quem* mudou um campo crítico. | | **Excluiu uma pessoa** | Um contato foi removido. | Rastrear limpezas de base, LGPD/consentimento ou ajustes em lotes. | | **Bloqueou** | Pessoa/entidade marcada como bloqueada para algum fluxo/canal. | Investigar por que um contato parou de receber comunicações. | | **Desbloqueou** | Remoção do status de bloqueio. | Restabelecer elegibilidade para campanhas e fluxos. | > Outras mensagens que você pode ver (dependendo do seu workspace): **atualizou/moveu cartão**, **tarefa criada**, **removeu tag**, **dados do dicionário atualizados**. Esses eventos seguem a mesma lógica: resumo + horário + ação para abrir o JSON. *** ### Inspecionando o JSON do evento Clique em **JSON** para abrir o payload bruto. Isso é essencial para: * Validar **variáveis** e **IDs** usados em fluxos/integrações. * Checar **antes/depois** de um update. * Reproduzir cenários em ambientes de teste. > Boas práticas: ao abrir o JSON, procure por `id`/`external_id`, `origin`, `timestamp`, `before`/`after` e campos sensíveis de negócio (ex.: `stage`, `labels`, `owner`). *** ### Casos de uso recomendados * **Atribuição de campanha**: valide se uma *Conversão* veio de um short-link com UTM correta. * **Qualidade de dados**: audite atualizações em massa (ex.: “Alterou os dados de”). * **Suporte e CX**: explique por que um contato **bloqueou/desbloqueou** e quando isso ocorreu. * **Operação comercial**: acompanhe *movimentações de cartões* e *criação de tarefas* vinculadas à pessoa. *** ### Limitações e evolução * A nomenclatura e o conjunto de eventos podem mudar com novas releases. * Alguns eventos dependem de permissões e de integrações habilitadas no workspace. *** #### Resumo A tela **Conversões** é seu **painel de auditoria** para marketing conversacional e operações.\ Use **filtros** para isolar o que interessa, **abra o JSON** para ver granularidade técnica e garanta rastreabilidade ponta a ponta — da origem da conversão ao status do contato. # Segmentação Agrupe pessoas ou organizações com características em comum para facilitar filtros, campanhas, automações e análises dentro da plataforma. ## 🏷️ Cadastro de Segmentações ### Visão geral As segmentações permitem agrupar **pessoas** ou **organizações** que compartilham características em comum. Esses grupos podem ser utilizados em campanhas, filtros, automações, análises e demais recursos que dependam da seleção de conjuntos específicos de contatos. Ao criar segmentações, o gerenciamento torna-se mais organizado, facilitando a identificação de grupos estratégicos e a execução de ações direcionadas. {% hint style="info" %} As segmentações podem ser criadas para **Pessoas** ou **Organizações**, mas nunca para ambos ao mesmo tempo. {% endhint %} *** ## 📌 O que é uma segmentação? Uma segmentação é um agrupamento personalizado criado a partir de critérios definidos pelo usuário. Ela pode reunir pessoas ou organizações com base em: * Informações cadastrais. * Atributos específicos. * Comportamentos. * Seleção manual. * Regras automáticas. Seu principal objetivo é facilitar buscas, organização e ações direcionadas. {% hint style="success" %} Segmentações ajudam a reduzir trabalhos repetitivos e tornam campanhas, filtros e automações muito mais eficientes. {% endhint %} *** ## ⚙️ Como configurar Preencha os seguintes campos ao criar uma nova segmentação: | Campo | Descrição | | ------------------------ | -------------------------------------------------------------------------------------------- | | 📝 **Nome** | Nome identificador da segmentação. Utilize um título que represente claramente seu objetivo. | | 📄 **Descrição** | Descreva a finalidade da segmentação e como ela deve ser utilizada pela equipe. | | 👥 **Tipo** | Define se a segmentação será utilizada para **Pessoas** ou **Organizações**. | | 🔄 **Tipo de Resultado** | Define se a segmentação será **Fixa** ou **Dinâmica**. | {% hint style="info" %} Utilize nomes claros, como **Clientes Premium**, **Novos Leads**, **Parceiros Ativos** ou **Organizações com Contrato Ativo**. {% endhint %} *** ## 🔄 Tipos de resultado ### Fixo Na segmentação **Fixa**, os participantes são adicionados manualmente ou por fluxos de automação. O grupo permanecerá inalterado até que um usuário ou automação realize uma nova alteração. #### Indicado para * Clientes VIP. * Listas estratégicas. * Participantes de eventos. * Contatos selecionados manualmente. *** ### Dinâmico Na segmentação **Dinâmica**, os participantes são incluídos ou removidos automaticamente conforme atendem aos critérios definidos. Após configurar os filtros, o sistema mantém a segmentação sempre atualizada, sem necessidade de alterações manuais. #### Exemplos de filtros * Pessoas com a etiqueta **Novo Lead.** * Organizações com status **Ativa.** * Pessoas cadastradas nos últimos **30 dias.** * Pessoas da cidade **São Paulo**. {% hint style="warning" %} Em segmentações dinâmicas, participantes adicionados manualmente serão removidos caso não atendam aos critérios definidos. {% endhint %} *** ## ❓ Perguntas frequentes #### Posso alterar o tipo de resultado após criar a segmentação? **Não.** Depois que a segmentação é criada, o tipo de resultado (**Fixo** ou **Dinâmico**) não pode ser alterado. *** #### Posso adicionar participantes manualmente em uma segmentação dinâmica? **Não.** Os participantes são controlados exclusivamente pelas regras configuradas na segmentação. *** ## 🚀 Aplicações As segmentações podem ser utilizadas em diversos recursos do sistema. #### 📢 Campanhas e comunicação Selecione grupos específicos para envio de campanhas, notificações ou comunicações direcionadas. #### 📊 Análises e indicadores Avalie o comportamento de grupos específicos e acompanhe métricas relevantes para tomada de decisão. #### 📁 Organização interna Estruture pessoas e organizações conforme processos internos, dispensando listas manuais ou controles externos. # Hablla Tag Manager ## Hablla Tag Manager O **Hablla Tag Manager** funciona como um *container inteligente*, permitindo monitorar e rastrear interações dos usuários no seu site.\ Com ele, você pode configurar **eventos personalizados**, coletar dados e automatizar ações estratégicas diretamente pela Hablla, sem depender de implementações externas complexas.
### 📌 Acessando o Hablla Tag Manager No menu lateral, acesse: **Marketing > Hablla Tag Manager** Na tela inicial você verá todos os contêineres criados, com as informações de: * **Nome** * **Domínio vinculado** * **Data de criação**
### ➕ Criando um novo container Clique em **Adicionar** para criar um novo Tag Manager. Você poderá definir: * **Nome do container** * **Domínio** onde o script será instalado Após criado, a Hablla gera automaticamente um **script de instalação** que deve ser adicionado dentro da tag `` do site: ```html ``` ### ⚙️ Gerenciando as Tags Dentro de um container, é possível visualizar e criar novas **tags**: Cada tag possui: * **Nome** * **Tipo** (cookies, rastreamento, formulário, etc.) * **Data de criação**
### 🏷️ Tipos de Tags disponíveis A Hablla oferece diferentes tipos de tags que podem ser configuradas: #### 1. Cookie Banner Permite configurar o aviso de uso de cookies do site.\ É possível personalizar: * Local da exibição (inferior direito, inferior esquerdo, etc.) * Tema (claro ou escuro) * Mensagem da política de privacidade * URL da política
#### 2. Formulário de WhatsApp Exiba um **pop-up de contato** diretamente no site, integrado com WhatsApp. Configurações possíveis: * Título, descrição e texto de boas-vindas * Upload de imagem e cor personalizada * URL da política de privacidade * Enviar dados para um **Webhook** * Redirecionar direto para um **número de WhatsApp**
### 🔗 Exemplo de uso estratégico Com o Hablla Tag Manager, você pode: * Exibir um aviso de cookies conforme LGPD. * Criar formulários inteligentes no site que enviam dados para automações da Hablla. * Redirecionar visitantes diretamente para seu time de WhatsApp. * Rastrear acessos e campanhas de marketing. *** ### ✅ Benefícios * Centralização da gestão de tags. * Maior agilidade e autonomia para o marketing. * Integração nativa com o **MCI – Marketing Conversacional Integrado**. * Redução da dependência de TI para ajustes rápidos no site. # Disparo em Massa O **Disparo em massa** da Hablla permite automatizar comunicações em escala, enviando **mensagens personalizadas**, acionando **fluxos inteligentes** e alcançando seu público nos canais certos — tudo em um só lugar. Com essa funcionalidade, é possível disparar: * **Templates de WhatsApp**: mensagens padronizadas aprovadas pelo WhatsApp, ideais para campanhas e comunicações estratégicas. * **Fluxos de automação**: execução de automações em larga escala a partir de uma base de contatos (ex.: planilhas).
### 1. Criando um novo disparo Para iniciar um disparo em massa: 1. Acesse o menu **Marketing > Disparo em massa**. 2. Clique em **Novo disparo**. 3. Preencha as informações iniciais: * **Nome do disparo**: defina um título interno para identificação. * **Tipo de envio**: escolha entre **Envio imediato** ou **Envio agendado**. * **Modo de envio**: * **Único lote**: envia para todos os contatos de uma vez. * **Fracionado**: divide em lotes configuráveis, definindo **intervalo (minutos)** e **quantidade por lote**. 📌 *O envio fracionado é ideal para mitigar bloqueios de canais e manter a entregabilidade alta.*
### 2. Seleção do canal de disparo Na etapa seguinte, escolha o canal: * **Mensagens (WhatsApp)** → utilize **templates oficiais** e personalize variáveis (como nome, empresa, atendente etc.). * **Fluxo de automação** → execute automações personalizadas para cada contato importado ou segmentado.
### 3. Selecionando o público Você pode definir os destinatários de duas formas: * **Planilha** * Importe um arquivo **.xlsx** com os contatos. * Cada linha executa um fluxo (no caso do canal de automação) ou recebe uma mensagem (no WhatsApp/Webchat). * **Filtros de segmentação** * Aplique regras para selecionar o público-alvo. * Exemplos de filtros disponíveis: #### Pessoas * Não converteram no evento * Converteram no evento * Todos em uma segmentação * Todos que não estão em segmentação * Todos com todas as etiquetas * Todos com alguma das etiquetas * Todos sem todas as etiquetas * Todos sem alguma das etiquetas * Criados dentro de um período específico #### Atendimentos * Sem atendimento recente * Que possui atendimento por status e setor * Que não possui atendimento por status e setor * Todos com todas as etiquetas * Todos com alguma das etiquetas * Todos sem todas as etiquetas * Todos sem alguma das etiquetas * Criados dentro de um período específico #### Cartões (CRM) * Todos com cartão em uma coluna * Todos com todas as etiquetas * Todos com alguma das etiquetas * Todos sem todas as etiquetas * Todos sem alguma das etiquetas * Criados dentro de um período específico * Movidos para uma lista específica * Saíram de uma lista específica
### 4. Configuração da mensagem Na etapa de configuração da mensagem: * **Canal**: selecione o número/canal habilitado (ex.: WhatsApp oficial). * **Modelo de mensagem** (WhatsApp): escolha o template pré-aprovado e configure as **variáveis dinâmicas**. * **Pré-visualização**: acompanhe em tempo real como ficará a mensagem enviada. 📌 Exemplo de template: ``` Olá, *{{1}}*! Tudo bem? 😊 Sou *{{2}}*, responsável pela sua implementação na *{{3}}*. Gostaria de agendar nossa primeira reunião para dar início ao projeto. ``` *** ### 5. Finalização do disparo Após revisar: 1. Clique em **Finalizar**. 2. O disparo será executado conforme o tipo de envio configurado (**imediato** ou **agendado**). 3. É possível acompanhar os resultados em tempo real no painel de desempenho. *** ### Benefícios do Disparo em Massa * **Escalabilidade**: envie milhares de mensagens de forma inteligente. * **Personalização**: insira variáveis dinâmicas para tornar a comunicação única. * **Segmentação avançada**: use filtros estratégicos para atingir o público certo. * **Segurança**: evite bloqueios com envio fracionado e parâmetros ajustáveis. * **Multicanalidade**: unifique mensagens no WhatsApp, Webchat e Fluxos. # Atendimento # Histórico de atendimentos Listas, relatórios e dashboards de atendimento. # Como Iniciar um atendimento Este guia descreve o processo de iniciar um atendimento no Hablla, conectando-se ao cliente através do WhatsApp e utilizando templates de mensagens. ### Passo 1: Acessar o Atendimento 1. Faça login na sua conta do Hablla. 2. No menu principal, clique em Dados para visualizar as opções e escolha \*pessoas\*
3. Em seguida, selecione o botão de Pessoas.
4. O próximo passo é buscar a pessoa ou cliente. Caso o cliente ainda não esteja cadastrado, veja o tutorial correspondente. 5. Se o cliente já estiver cadastrado, clique na pessoa desejada.
Passo 2: Acessar o Cadastro do Cliente 1. Na lateral superior esquerda, clique no nome do cliente para abrir o cadastro completo. 2. Revise as informações do cliente, como histórico de interações, dados de contato, preferências ou outras anotações relevantes. ### Passo 3: Clicar no Ícone do WhatsApp
1. No cadastro do cliente, clique no ícone do WhatsApp para iniciar a comunicação via WhatsApp.\ \
Passo 4: Adicionar a Conexão 1. Caso a conexão do WhatsApp ainda não tenha sido estabelecida, clique na opção Adicionar Conexão. 2. Siga as instruções na tela para conectar o número de WhatsApp do cliente à plataforma. \
Passo 5: Adicionar o Setor 1. Depois de adicionar a conexão, será necessário selecionar o setor apropriado para esse atendimento. 2. Escolha o setor relacionado ao serviço ou solicitação do cliente (ex.: vendas, suporte, etc.). \ \
Passo 6: Adicionar o Template Liberado pelo Meta 1. Em seguida, clique em Adicionar Template. 2. Selecione o template liberado pelo Meta que você deseja utilizar para essa comunicação (ex.: template de boas-vindas, confirmação de agendamento, etc.).
Passo 7: Personalizar o Corpo da Mensagem 1. Verifique se o nome do cliente já está automaticamente preenchido no template. Caso contrário: 2. * Ative o botão Manual (ON/OFF) para inserir o nome manualmente, se necessário. * Se o nome for preenchido automaticamente, verifique se está correto. 3. Revise o conteúdo da mensagem para garantir que a personalização está adequada para o cliente e a situação. \ \ Passo 8: Iniciar o Atendimento e Aguardar Resposta do Cliente
1. Após revisar o template e a personalização da mensagem, clique em Iniciar Atendimento. 2. A mensagem será enviada automaticamente para o cliente com o template selecionado. 3. Agora, aguarde a resposta do cliente. 4. Assim que o cliente responder, você poderá enviar mensagens livres para dar continuidade ao atendimento.
Seguindo esses passos, você garantirá um atendimento eficiente e organizado dentro da plataforma Hablla. O uso correto dos templates e das conexões permite uma comunicação mais ágil e profissional, melhorando a experiência do cliente. Sempre revise as mensagens antes de enviá-las e acompanhe as interações para garantir um suporte de qualidade.
# Transferência de Atendimento em Massa # Nível usuário O usuário tem autonomia para fazer transferência dos seus atendimentos em andamento. Isso é possível através do ícone ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcGqhOzk6kspW-3l2jCva95Y7R_-AOqdrep1oxJm3N1SUNIqeDGqYaXPrM0z5wI8dTEO7kwLSN9ItRTJhpc1j7aBjX_erNAIOVfag5CFk1k5PGLZuFw1pdjjkg64-tMrYenHC89?key=7UjLjmDwaFEHZ39yHves0Bwq) localizado na lateral esquerda, no menu acima dos atendimentos.
A tela se dá da seguinte forma:
Todos os campos com asterisco (\*) são obrigatórios o preenchimento. Atendimentos: Ao selecionar o campo de atendimentos, aparecerá uma listagem de todos os atendimentos que estão em andamento com o atendente, fornecendo a opção de selecionar mais de um atendimento para ser transferido.\
Setor: Neste campo deve ser selecionado o setor para o qual estes atendimentos serão transferidos.
Após selecionar o setor, fica disponível a opção de Usuários para selecionar qual usuário do setor selecionado receberá os atendimentos.
Motivo: No campo de motivo deve ser selecionado -obrigatoriamente- um motivo pelo qual os atendimentos selecionados estão sendo transferidos (estes motivos são criado em Configurações > Motivos para atendimento ( apenas administradores têm esse acesso)).
No campo de confirmação do processo deve ser digitado a palavra PROSSEGUIR (em letras maiúsculas) como forma de garantir que o usuário esteja ciente da transferência. # Nível administrador O administrador tem autonomia para fazer transferência dos atendimentos em andamento dos atendentes através do painel de atendimentos.
Em atendimentos > histórico de atendimentos > Atendentes, é exibido o painel dos atendentes.
⬇️ \ Na lateral direita no painel de atendimentos, o ícone ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXwprEMlZR0c851wY6YmFzlpOZuEE57tyXECo0FDSTgAMY6eV44VZErvICBA9aAb2fJrHwtPSkagv2jGIbgnwMKaK0-Y9qX8cNod7oHdeeYCShjLnQx3mI-aOu50pzrwl4WaKz?key=7UjLjmDwaFEHZ39yHves0Bwq) abre a tela de seleção para transferência.
A tela se dá da seguinte forma:
Todos os campos com asterisco (\*) são obrigatórios o preenchimento. Atendimentos: Ao selecionar o campo de atendimentos, aparecerá uma listagem de todos os atendimentos que estão em andamento com o atendente, fornecendo a opção de selecionar mais de um atendimento para ser transferido.\
Setor: Neste campo deve ser selecionado o setor para o qual estes atendimentos serão transferidos.
Após selecionar o setor, fica disponível a opção de Usuários para selecionar qual usuário do setor selecionado receberá os atendimentos.
Motivo: No campo de motivo deve ser selecionado -obrigatoriamente- um motivo pelo qual os atendimentos selecionado estão sendo transferidos (estes motivos são criado em Configurações > Motivos para atendimento ( apenas administradores têm esse acesso)).
No campo de confirmação do processo deve ser digitado a palavra PROSSEGUIR (em letras maiúsculas) como forma de garantir que o usuário esteja ciente da transferência. # Permissão Personalizada Para usuários que não tem acesso de administrador, além da opção de transferir os próprios atendimentos em andamento, pode ser personalizado uma permissão fornecendo o acesso ao Painel de atendimentos:
Neste acesso o usuário passa a ter acesso a seguinte tela em Atendimentos > Histórico de atendimentos:
Na opção de Atendentes (![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeE-rk0LSzjQO0mSTaW-qAQZ6AHM5nxoOroQLW6eGhHCZN9ygRlPc0a6uZTXeYhMBgALGkkjI9VzZaaSB1LpRn2o9laXmhVgTCoGP9C1A3V7rSkLqkJiMpwgNRyLxDlEDYSXXeDcQ?key=7UjLjmDwaFEHZ39yHves0Bwq)) é possível gerenciar a transferência de atendimentos para o usuário que está atendendo através do ícone ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcN2vfoiZSvJFK6CITLO-Ym3uYQuAn0e7rs-snCwsP0I5bwUUVm3cn51ZuH51-dgUwbt9G6ss-97NHUDKgsIGrwpQTBs6EUBVmwnokuyxXpPQ1szrgQ-qyfGKoJ9rMCaXembyzx6Q?key=7UjLjmDwaFEHZ39yHves0Bwq).
A tela se dá da seguinte forma:
Todos os campos com asterisco (\*) são obrigatórios o preenchimento.
Atendimentos: Ao selecionar o campo de atendimentos, aparecerá uma listagem de todos os atendimentos que estão em andamento com o atendente, fornecendo a opção de selecionar mais de um atendimento para ser transferido.\
Setor: Neste campo deve ser selecionado o setor para o qual estes atendimentos serão transferidos.
Após selecionar o setor, fica disponível a opção de Usuários para selecionar qual usuário do setor selecionado receberá os atendimentos.
Motivo: No campo de motivo deve ser selecionado -obrigatoriamente- um motivo pelo qual os atendimentos selecionados estão sendo transferidos (estes motivos são criado em Configurações > Motivos para atendimento ( apenas administradores têm esse acesso)).
No campo de confirmação do processo deve ser digitado a palavra PROSSEGUIR (em letras maiúsculas) como forma de garantir que o usuário esteja ciente da transferência.
# Como finalizar ou arquivar um Atendimento no Hablla Este guia explica o passo a passo para finalizar ou arquivar um atendimento no Habla, incluindo informações adicionais para facilitar o processo e garantir uma experiência eficiente. 1. Faça login na sua conta do Hablla. 2. No menu principal, clique em Atendimentos para visualizar os atendimentos em andamento.
\ **Passo 2:** Acessar o Histórico de Atendimento 1. Dentro de Atendimentos, acesse o Histórico de Atendimento. 2. Utilize a busca para localizar o cliente ou serviço com o qual você deseja retomar o atendimento.
\ **Passo 3:** Identificar o Cliente ou Serviço 1. Após localizar o cliente ou serviço correto, clique na caixa de atendimento para acessar os detalhes do atendimento. 2. Identifique o cliente e confirme que está tudo correto para continuar o atendimento.
\ **Passo 4:** Clicar no Botão de Finalizar 1. No canto superior direito da tela, localize e clique no botão "Finalizar". 2. Isso abrirá um pop-up de finalização.
**Passo 5:** Escolher entre Finalizar ou Arquivar 1. No pop-up de finalização, você terá duas opções: * Finalizar: * O atendimento será encerrado definitivamente. * Após finalizar, não será possível enviar mensagens livres para o cliente. * Para um novo atendimento, será necessário abrir uma nova janela. * Arquivar: * O atendimento não será priorizado, mas permanecerá acessível no Habla. * Você poderá retomar o atendimento futuramente, se necessário.
**Passo 6:** Adicionar um Motivo (Opcional) 1. Se necessário, selecione um motivo para finalizar o atendimento. * Os motivos já estão pré-estabelecidos nas configurações de motivos de atendimento. * Esses motivos ajudam a definir as usabilidades e processos do cliente dentro do sistema.
2. Clique no botão "Finalizar" para confirmar a conclusão do atendimento. *** #### Dicas Importantes: * Verifique o status do atendimento: Antes de finalizar, confira se todas as necessidades do cliente foram atendidas. * Use motivos de finalização: Utilize os motivos pré-definidos para padronizar os processos e facilitar a análise de métricas. * Comunique-se com o cliente: Caso o atendimento seja finalizado, informe ao cliente que o suporte foi concluído e que ele pode abrir um novo chamado, se necessário. * Acompanhe atendimentos arquivados: Para atendimentos arquivados, mantenha um acompanhamento periódico para garantir que não haja pendências.
Agora você sabe como finalizar ou arquivar atendimentos no Habla de forma eficiente. Lembre-se de escolher a opção mais adequada para cada situação e utilize os recursos disponíveis para garantir uma experiência positiva tanto para sua equipe quanto para os clientes. \
# Finalização de Atendimento em Massa #### Opção disponível apenas para usuários com permissão de Administradores Em Atendimentos > Histórico de atendimentos, há o ícone ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXe7kq4WGgvS8Q_sIVNVTkfXQHoYB7MCosLJKD4bMxK3tZ2FvfmToQr35PTF1X0EznUjdhAiUIUizCEUC0UdE5Tx6PQsma9zvLPNvwePa5yuUrxNj4JLOC2L8Rm-4SUZITpLkd0H?key=J7adDEWOlkruv_EDAS1q4Q) onde é possível finalizar atendimentos simultâneos. De primeiro momento o botão fica indisponível para clique pois é necessário informar um filtro pelo qual os atendimentos serão finalizados (é obrigatório selecionar um setor e um status, os demais filtros são personalizados) Exemplo:
\* pode ser selecionado mais de uma opção de Status do atendimento para ser finalizado:
\* Setores são feitos apenas um por vez Após selecionar os filtros, o botão fica disponível:
É obrigatório selecionar um motivo para a finalização e fazer confirmação através do preenchimento do campo PROSSEGUIR:
\* Não é possível liberar essa funcionalidade para usuários (mesmo com permissão personalizada)
# Base de Conhecimento # Agentes autônomos Um agente autônomo é um sistema inteligente que opera de forma independente para executar tarefas. Ele pode analisar o contexto, tomar decisões em tempo real e interagir com usuários ou sistemas # Bot de qualificação de lead A qualificação de leads permite automatizar o topo do funil, comunicando com agilidade e classificando conforme necessidade. # Vendas # Produtos Gerencie seus produtos com facilidade: ajuste preços, imagens e atualize informações. Tudo que você precisa para manter seu catálogo atualizado e organizado em um só lugar. # Tabela de Preços Mantenha sua tabela de preços sempre atualizada e organizada. Ajuste valores, aplique descontos e garanta que suas informações estejam sempre corretas. Tudo de forma simples e prática em um só lugar. # Condições de pagamento Defina os termos e condições de pagamento para seus produtos ou serviços. # Notas Fiscais Importe ou cadastre notas fiscais em poucos cliques. Organização e praticidade para manter sua operação atualizada. # Automação de CRM Integração de CRM para gerenciar e nutrir leads de forma eficiente, melhorando a conversão e o relacionamento com o cliente. # CS/CX # Templates Templates personalizáveis para agilizar a criação de campanhas e manter a consistência da marca. ## Como usar este template de fluxo na Hablla Este fluxo foi criado para facilitar a interação com os clientes, mas para utilizá-lo corretamente é necessário ajustar alguns pontos importantes. {% file src="/files/9xFPyQmtNKqKX6sxBars" %} ### 1. Trocar os templates de WhatsApp No fluxo existem **dois pontos que utilizam templates de WhatsApp (HSM)**. * Esses templates precisam ser substituídos pelos modelos aprovados da sua empresa. * Caso ainda não tenha templates aprovados, será necessário criá-los e submetê-los à Meta antes da troca. Sem essa substituição, o disparo não funcionará, já que o WhatsApp exige que somente templates válidos sejam usados em mensagens ativas. ### 2. Ajustar os componentes da Hablla Além dos templates, o fluxo também possui **dois componentes da Hablla** onde deve ser configurado o **teste de pesquisa**: * No **primeiro componente**, adicione o teste de pesquisa de forma que ele valide a resposta recebida. * No **segundo componente**, configure da mesma forma, garantindo que o fluxo consiga identificar e classificar a resposta corretamente. Esses ajustes são obrigatórios para que o fluxo funcione sem erros e consiga entregar os resultados esperados. ### 3. Forma correta de disparo Este template **não deve ser usado em atendimentos individuais manuais**.\ Ele foi desenhado para ser disparado em **massa**, ou seja, através de uma lista de clientes previamente definida. Assim, cada contato recebe o template inicial, e as respostas seguem o fluxo automaticamente, garantindo maior eficiência no processo. *** ✅ **Resumo:** * Troque os dois templates de WhatsApp por versões aprovadas. * Configure o id de pesquisa nos dois componentes da Hablla. * Execute o fluxo sempre por **disparo em massa de clientes**. 📌 **Dica prática:** Antes de rodar em produção, faça um teste com uma lista reduzida de contatos(apenas com contatos internos) para confirmar que as trocas e configurações estão funcionando corretamente. # NPS e pesquisa de satisfação Medição do NPS e realização de pesquisas para entender a satisfação do cliente e identificar áreas de melhoria. {% file src="/files/Jxmcb4BgGtsgcidCup9h" %}
## Como usar este template de fluxo na Hablla Este fluxo foi criado para facilitar a interação com os clientes, mas para utilizá-lo corretamente é necessário ajustar alguns pontos importantes. ### 1. Trocar os templates de WhatsApp No fluxo existem **dois pontos que utilizam templates de WhatsApp (HSM)**. * Esses templates precisam ser substituídos pelos modelos aprovados da sua empresa. * Caso ainda não tenha templates aprovados, será necessário criá-los e submetê-los à Meta antes da troca. Sem essa substituição, o disparo não funcionará, já que o WhatsApp exige que somente templates válidos sejam usados em mensagens ativas. ### 2. Ajustar os componentes da Hablla Além dos templates, o fluxo também possui **dois componentes da Hablla** onde deve ser configurado o **teste de pesquisa**: * No **primeiro componente**, adicione o teste de pesquisa de forma que ele valide a resposta recebida. * No **segundo componente**, configure da mesma forma, garantindo que o fluxo consiga identificar e classificar a resposta corretamente. Esses ajustes são obrigatórios para que o fluxo funcione sem erros e consiga entregar os resultados esperados. ### 3. Forma correta de disparo Este template **não deve ser usado em atendimentos individuais manuais**.\ Ele foi desenhado para ser disparado em **massa**, ou seja, através de uma lista de clientes previamente definida. Assim, cada contato recebe o template inicial, e as respostas seguem o fluxo automaticamente, garantindo maior eficiência no processo. *** ✅ **Resumo:** * Troque os dois templates de WhatsApp por versões aprovadas. * Configure o ID da pesquisa nos dois componentes da Hablla. * Execute o fluxo sempre por **disparo em massa de clientes**. 📌 **Dica prática:** Antes de rodar em produção, faça um teste com uma lista reduzida de contatos para confirmar que as trocas e configurações estão funcionando corretamente. # Fluxo Medição do NPS e realização de pesquisas para entender a satisfação do cliente e identificar áreas de melhoria. # Desempenho # Análise de funil Visualize o desempenho desde o clique até o fechamento do negócio # Metas # Centro de Custo # Integração entre sistemas Conecte diferentes sistemas para uma operação mais fluida e dados sincronizados, otimizando processos de negócios. # Verificando a saúde do número no Business Manager (Meta) Acompanhar a saúde do número é essencial para garantir a boa performance e entregabilidade do WhatsApp Oficial dentro da **Hablla**.\ No Business Manager da Meta, você pode visualizar métricas de uso, limites de envio e a qualidade do número. ### **O que é a saúde do número?** A saúde do número é um conjunto de indicadores que mostra: * **Limite de mensagens** permitido atualmente. * **Volumes enviados**, separados por categoria (Marketing, Utilidade, Autenticação). * **Qualidade** do número nos últimos 30 dias (Alta, Média ou Baixa). Essas informações ajudam a entender como o número está sendo usado e quais ajustes podem ser feitos para manter a boa reputação. ### Passo a passo para verificar a saúde do número #### 1. Abra a Meta Business Suite Acesse [business.facebook.com](https://business.facebook.com).\ No menu lateral, role até o final e clique em **Configurações**.

#### **2. Vá até Contas do WhatsApp** Dentro de **Configurações**, na seção **Contas**, clique em **Contas do WhatsApp**.
#### 3. Selecione a conta e abra o Gerenciador Escolha a conta do WhatsApp (WABA) desejada.\ No canto inferior direito, clique em **Gerenciador do WhatsApp**.
#### **4. Acesse Insights do número** No Gerenciador, selecione o número de telefone no painel lateral e clique em **Insights**.\ Aqui você já vê o **limite atual de mensagens** do número.
#### 5. Analise os Insights de entrega Role a página para visualizar: * Volumes de mensagens por categoria. * Estimativas de cobranças.
#### 6. Confira a Qualidade No final da página, veja o gráfico de **Qualidade** (Alta, Média ou Baixa).\ Esse é o principal indicador de saúde do número.
*** ### Dicas práticas se a qualidade cair * **Pausa estratégica**: segure disparos em massa por 24–48h e priorize mensagens transacionais/esperadas. * **Mensagens claras**: use templates objetivos, sem termos sensíveis. * **Segmentação**: envie só para quem deu opt-in e interage com frequência. * **Equilíbrio**: priorize mensagens transacionais antes das promocionais. * **Monitoramento**: acompanhe bloqueios e reclamações para ajustar cadência. *** **Manter a saúde do número em alta garante melhor entregabilidade e evita restrições no uso do WhatsApp Oficial dentro da Hablla.** # Atendimentos # Como Iniciar um Atendimento na Hablla #### Como Iniciar um Atendimento no Hablla \ Este guia descreve o processo de iniciar um atendimento no Hablla, conectando-se ao cliente através do WhatsApp e utilizando templates de mensagens.\ \ **Passo 1:** Acessar o Atendimento 1. Faça login na sua conta do Hablla. 2. No menu principal, clique em Dados para visualizar as opções e escolha \*pessoas\*.
3. Em seguida, selecione o botão de Pessoas.
4. O próximo passo é buscar a pessoa ou cliente. Caso o cliente ainda não esteja cadastrado, veja o tutorial correspondente. 5. Se o cliente já estiver cadastrado, clique na pessoa desejada.
\ **Passo 2:** Acessar o Cadastro do Cliente 1. Na lateral superior esquerda, clique no nome do cliente para abrir o cadastro completo. 2. Revise as informações do cliente, como histórico de interações, dados de contato, preferências ou outras anotações relevantes.\
**Passo 3:** Clicar no Ícone do WhatsApp
1. No cadastro do cliente, clique no ícone do WhatsApp para iniciar a comunicação via WhatsApp.
**Passo 4:** Adicionar a Conexão 1. Caso a conexão do WhatsApp ainda não tenha sido estabelecida, clique na opção Adicionar Conexão. 2. Siga as instruções na tela para conectar o número de WhatsApp do cliente à plataforma.
**Passo 5:** Adicionar o Setor 1. Depois de adicionar a conexão, será necessário selecionar o setor apropriado para esse atendimento. 2. Escolha o setor relacionado ao serviço ou solicitação do cliente (ex.: vendas, suporte, etc.).
**Passo 6:** Adicionar o Template Liberado pelo Meta 1. Em seguida, clique em Adicionar Template. 2. Selecione o template liberado pelo Meta que você deseja utilizar para essa comunicação (ex.: template de boas-vindas, confirmação de agendamento, etc.).
**Passo 7:** Personalizar o Corpo da Mensagem 1. Verifique se o nome do cliente já está automaticamente preenchido no template. Caso contrário: 2. * Ative o botão Manual (ON/OFF) para inserir o nome manualmente, se necessário. * Se o nome for preenchido automaticamente, verifique se está correto. 3. Revise o conteúdo da mensagem para garantir que a personalização está adequada para o cliente e a situação. \ **Passo 8:** Iniciar o Atendimento e Aguardar Resposta do Cliente
1. Após revisar o template e a personalização da mensagem, clique em Iniciar Atendimento. 2. A mensagem será enviada automaticamente para o cliente com o template selecionado. 3. Agora, aguarde a resposta do cliente. 4. Assim que o cliente responder, você poderá enviar mensagens livres para dar continuidade ao atendimento.
Seguindo esses passos, você garantirá um atendimento eficiente e organizado dentro da plataforma Hablla. O uso correto dos templates e das conexões permite uma comunicação mais ágil e profissional, melhorando a experiência do cliente. Sempre revise as mensagens antes de enviá-las e acompanhe as interações para garantir um suporte de qualidade.
# Como Transferir um Atendimento no Hablla Este guia explica o passo a passo para transferir um atendimento no Habla, incluindo informações adicionais para facilitar o processo.\ \ Passo 1: Acessar o Atendimento 1. Faça login na sua conta do Hablla. 2. No menu principal, clique em Atendimentos para visualizar os atendimentos em andamento.
**Passo 2:** Acessar o Histórico de Atendimento 1. Dentro de Atendimentos, acesse o Histórico de Atendimento. 2. Utilize a busca para localizar o cliente ou serviço com o qual você deseja retomar o atendimento.
**Passo 3:** Identificar o Cliente ou Serviço 1. Após localizar o cliente ou serviço correto, clique na caixa de atendimento para acessar os detalhes do atendimento. 2. Identifique o cliente e confirme que está tudo correto para continuar o atendimento.
**Passo 4:** Acessar o Botão de Transferência 1. No canto superior direito da tela, localize e clique no botão "Transferir". 2. Isso abrirá um pop-up de transferência.
**Passo 5:** Adicionar Setor (Obrigatório) 1. No pop-up de transferência, selecione o setor para o qual deseja transferir o atendimento. * Certifique-se de escolher o setor correto para garantir que o cliente seja direcionado adequadamente.
**Passo 6:** Adicionar Usuário e Comentário (Opcional) 1. Se necessário, selecione um usuário específico para receber o atendimento. 2. Adicione um comentário para contextualizar o próximo atendente (ex.: "Cliente com dúvida sobre assinatura"). ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXezChudrV0wES0GLyZqDE6l-4aqGKxxZiC9jiCvYAglwCiOs8wsatH7RmKE2qFOhYP7oLHZZivyFHUZ6BiBOt7rA0ZRkovMD_f1mshm2T-6KKb-zgSQ17m5rJzrrs-0Hd_PIMhGpA?key=E0zIBvvpYtI5t0BUyzS8f5wy)![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfZOdNniFleRMYOdRWXneIITECZc_NkXbz7OAo_66Rbi4HGLcq1q0YUSSqz2VZuxb31sHhTBm_i0JfvggkVyv2R3LKS_-uCk5HfKULGw-KnjmMtDP47DHckqeXWUAVdS66ofMPdxg?key=E0zIBvvpYtI5t0BUyzS8f5wy)\ \ \ **Passo 7:** Confirmar a Transferência 1. Clique no botão "Transferir" para finalizar o processo. 2. Após a transferência: * Se o atendimento foi transferido para você mesmo, ele permanecerá na sua cartela de atendimentos. Para visualizá-lo, clique no botão roxo à direita. * Se o atendimento for transferido para outra pessoa, ele desaparecerá da sua cartela.
Após a transferência, o atendimento aparecerá dentro dos seus atendimentos.
*** #### Como Assumir um Atendimento Caso você queira assumir um atendimento, siga estas etapas: 1. Verifique suas permissões: * Para assumir um atendimento, você precisa ter permissão para visualizar todos os atendimentos. * Caso não tenha, entre em contato com o administrador do sistema para solicitar a permissão necessária. 2. Busque o atendimento: * Acesse o Histórico de Atendimentos e localize o atendimento que deseja assumir. 3\. Siga o processo de transferência: * No pop-up de transferência, selecione o setor correto. * Em vez de escolher outro usuário, selecione a si mesmo como responsável pelo atendimento. 4. Confirme a transferência: * Clique em "Transferir" para assumir o atendimento. * O atendimento agora aparecerá na sua cartela de atendimentos. *** #### Dicas Importantes: * Verifique disponibilidade: Antes de transferir ou assumir um atendimento, confira se o setor ou usuário está disponível. * Use comentários: Utilize o campo de comentários para passar informações relevantes, como o contexto do atendimento ou necessidades específicas do cliente. * Acompanhe o status: Após a transferência ou ao assumir um atendimento, acompanhe o status para garantir que o cliente foi atendido corretamente. * Comunique-se: Caso transfira ou assuma por engano, entre em contato com o responsável para realinhar o atendimento.\ \
# Como Reiniciar um Atendimento no Hablla Este guia descreve o processo de reiniciar um atendimento no Hablla, conectando-se ao cliente através do WhatsApp e utilizando templates de mensagens.\ \ **Passo 1:** Acessar o Atendimento 1. Faça login na sua conta do Hablla. 2. No menu principal, clique em Atendimentos para visualizar os atendimentos em andamento.
\ **Passo 2:** Acessar o Histórico de Atendimento 1. Dentro de Atendimentos, acesse o Histórico de Atendimento. 2. Utilize a busca para localizar o cliente ou serviço com o qual você deseja retomar o atendimento.
\ **Passo 3:** Identificar o Cliente ou Serviço 1. Após localizar o cliente ou serviço correto, clique na caixa de atendimento para acessar os detalhes do atendimento. 2. Identifique o cliente e confirme que está tudo correto para continuar o atendimento.
**Passo 4:** Acessar o Cadastro do Cliente 1. Na lateral esquerda superior, clique no nome do cliente para abrir o cadastro completo da pessoa. 2. Revise as informações do cliente, como histórico de interações, dados de contato, preferências ou outras anotações relevantes.
\ **Passo 5:** Clicar no Ícone do WhatsApp 1. No cadastro do cliente, clique no ícone do WhatsApp para iniciar a comunicação via WhatsApp.
**Passo 6:** Adicionar a Conexão 1. Caso a conexão do WhatsApp ainda não tenha sido estabelecida, clique na opção Adicionar Conexão. 2. Siga as instruções na tela para conectar o número de WhatsApp do cliente à plataforma.
\ **Passo 7:** Adicionar o Setor 1. Depois de adicionar a conexão, será necessário selecionar o setor apropriado para esse atendimento. 2. Escolha o setor relacionado ao serviço ou solicitação do cliente (ex.: vendas, suporte, etc.).
**Passo 8:** Adicionar o Template Liberado pelo Meta 1. Em seguida, clique em Adicionar Template. 2. Selecione o template liberado pelo Meta que você deseja utilizar para essa comunicação (ex.: template de boas-vindas, confirmação de agendamento, etc.).
**Passo 9:** Personalizar o Corpo da Mensagem 1. Verifique se o nome do cliente já está automaticamente preenchido no template. Caso contrário: 2. * Ative o botão Manual (ON/OFF) para inserir o nome manualmente, se necessário. * Se o nome for preenchido automaticamente, verifique se está correto. 3. Revise o conteúdo da mensagem para garantir que a personalização está adequada para o cliente e a situação.
**Passo 10:** Iniciar o Atendimento e Aguardar Resposta do Cliente 1. Após revisar o template e a personalização da mensagem, clique em Iniciar Atendimento. 2. A mensagem será enviada automaticamente para o cliente com o template selecionado. 3. Agora, aguarde a resposta do cliente. 4. Assim que o cliente responder, você poderá enviar mensagens livres para dar continuidade ao atendimento.

# Usuários # Grupos Os grupos permitem organizar conversas e reunir colaboradores para comunicação interna e gerenciamento de atendimentos. ### Como criar um grupo 1. Acesse o menu **Chat**. 2. Clique na opção **Grupos**. 3. Selecione o ícone **+** para criar um novo grupo. 1. Informe o **nome do grupo**. 2. Clique em **Enviar** para finalizar a criação. ### Configurando o grupo Após criar o grupo, clique no ícone **Informações do Grupo** (ícone da letra **"i"**) para acessar as configurações. Nessa tela, é possível: * Alterar o nome do grupo; * Definir uma descrição para facilitar a identificação; * Adicionar ou remover membros do grupo. ### Utilização em fluxos Caso o grupo seja utilizado em automações da plataforma, habilite a opção **`flow_visible`**. Ao ativar essa configuração, o grupo ficará disponível para seleção nas ações dos fluxos, permitindo seu uso em automações e direcionamentos. ### Estatísticas do grupo No canto superior direito da tela, clique em **Estatísticas** para visualizar os indicadores de desempenho do grupo. As informações disponíveis incluem: * Tempo médio de resposta; * Tempo médio de espera; * Total de mensagens recebidas; * Quantidade de participantes do grupo; * Resumo geral dos atendimentos realizados. Essas métricas auxiliam no acompanhamento da produtividade, do volume de interações e do desempenho do grupo, facilitando a análise da operação. # Pessoas ## Entidade: Pessoas ### 1. Visão Geral A entidade **Pessoas** é o núcleo da modelagem de dados da Hablla e representa qualquer indivíduo com o qual a organização interage — seja cliente, prospect, lead, parceiro ou contato interno. No contexto do **MCI (Marketing Conversacional Integrado)**, *Pessoas* é a base para centralizar e unificar interações em múltiplos canais, garantindo que cada conversa seja **contextual, personalizada e orientada por dados**. *** ### 2. Objetivos da Entidade * **Unificar dados de contato** de múltiplos canais em um registro único. * **Histórico consolidado de interações** para visão 360º do relacionamento. * **Ativar personalização** em campanhas, fluxos e atendimentos. * **Suportar compliance** com LGPD e governança de dados. *** ### 3. Atributos e Campos Padrão | Campo | Descrição | Tipo de Dado | Exemplo | Observações | | --------------------------- | ----------------------------------------------------- | ---------------- | -------------------------------------- | ---------------------- | | **ID Interno** | Identificador único gerado pela plataforma Hablla | UUID | `3f9c2b...` | Não editável | | **Nome Completo** | Nome do indivíduo | Texto | `João da Silva` | Obrigatório | | **E-mail** | Endereço eletrônico | Texto / E-mail | `joao@email.com` | Validado | | **Telefone (WhatsApp)** | Número para comunicação via WhatsApp | Texto / Numérico | `+55 11 91234-5678` | Formato E.164 | | **Identificador Instagram** | ID do perfil do Instagram | Texto | `17841405793187218` | Obtido via API | | **Identificador Facebook** | ID do perfil do Facebook | Texto | `1000123456789` | Obtido via API | | **Telegram ID** | ID único do contato no Telegram | Texto | `123456789` | Obtido via Bot | | **Telefone (voz)** | Número para chamadas telefônicas | Texto / Numérico | `+55 21 99876-5432` | | | **Histórico de Interações** | Registro completo de mensagens, ligações e atividades | Registro | — | Atualização automática | | **Tags** | Etiquetas para segmentação | Lista de texto | `["Cliente VIP", "Black Friday 2025"]` | Livre | | **Fonte de Aquisição** | Origem do contato | Texto | `Campanha WhatsApp Ads` | | | **Status de Consentimento** | Indica se há autorização para comunicações | Boolean | `true` | LGPD-compliant | *** ### 4. Relacionamentos com Outras Entidades | Entidade | Tipo de Relacionamento | Descrição | | ---------------- | ---------------------- | ---------------------------------------------------------------------------------------- | | **Organizações** | N:N | Uma Pessoa pode estar associada a múltiplas Organizações (e vice-versa). | | **Cartões** | 1:N | Uma Pessoa pode estar vinculada a vários Cartões (oportunidades, tickets, atendimentos). | | **Tarefas** | 1:N | Uma Pessoa pode ter Tarefas associadas direta ou indiretamente. | *** ### 5. Regras de Negócio 1. **Identificação Multicanal** * Cada canal possui seu identificador único (e.g., Instagram ID, WhatsApp telefone). * O mesmo indivíduo pode ter diferentes IDs por canal. 2. **Unificação de Registros** * A fusão de registros duplicados deve seguir regras de priorização de dados (última atualização > mais completa). 3. **Histórico Imutável** * Interações registradas não podem ser apagadas, apenas ocultadas por questões de compliance. 4. **Consentimento Obrigatório** * Comunicações proativas exigem status de consentimento `true`. *** ### 6. Exemplos de Uso * **Marketing**: Segmentação de leads que interagiram no Instagram nos últimos 30 dias. * **Vendas**: Identificação de decisores vinculados a uma mesma Organização. * **CX**: Recuperar histórico completo de um cliente antes de uma chamada de suporte. *** ### 7. Boas Práticas * **Atualizar dados** sempre que uma nova interação trouxer informações mais precisas. * **Usar tags padronizadas** para facilitar segmentação. * **Evitar duplicatas** por importação de listas não tratadas. * **Manter consentimento** revisado periodicamente para evitar bloqueios de campanhas. *** ### 8. Considerações de Segurança e LGPD * Armazenar apenas dados necessários para a operação. * Garantir que pedidos de exclusão de dados sejam tratados no prazo legal. * Registrar logs de alterações e acessos ao perfil da Pessoa. # Organizações Aprenda a gerenciar as Organizações na Hablla. Adicione, edite, importe e filtre os dados de empresas e clientes para manter seu CRM sempre organizado. A seção de **Organizações** é onde você gerencia todas as empresas e entidades com as quais sua equipe interage. Manter essa base de dados organizada é fundamental para um bom relacionamento com clientes, parceiros e fornecedores. Nesta página, você pode adicionar, visualizar, editar e organizar todas as informações importantes sobre as empresas cadastradas na sua plataforma. *** #### A Tela de Organizações Ao acessar a área de Organizações, você encontrará uma lista completa de todas as empresas cadastradas. Esta tela serve como seu painel central para visualizar, pesquisar e acessar rapidamente os registros. Por padrão, a listagem exibe as colunas mais comuns para uma identificação rápida, como Status, Nome, CNPJ e Telefone. No entanto, cada organização na Hablla pode conter um conjunto muito mais rico de informações. Abaixo estão todos os campos que você pode utilizar para detalhar os registros de uma organização: * Nome: O nome fantasia ou comercial da organização. * Razão Social: O nome de registro legal da empresa. * CNPJ: O Cadastro Nacional da Pessoa Jurídica. * E-mail: O endereço de e-mail principal da organização. * Telefone: O número de telefone principal para contato. * Endereço Completo: Inclui todos os detalhes de localização: * CEP: O Código de Endereçamento Postal. * Logradouro, Número, Complemento e Bairro. * Município: A cidade onde a organização está localizada. * Estado: O estado da organização. * Dono: O usuário da sua equipe que é o responsável principal por aquela organização. * Campos Personalizados: Campos adicionais criados por sua equipe para armazenar informações que são específicas para o seu negócio. * Etiquetas (Tags): Marcadores que ajudam a categorizar, segmentar e filtrar suas organizações com facilidade (ex: "Cliente VIP", "São Paulo", "Indústria"). * Datas de Referência: * Criado em: A data em que a organização foi adicionada à Hablla. * Última atualização: A data da última modificação feita no registro. * Status: Indica a etapa atual da organização no seu processo de negócio. **Tipos de Status** O campo Status é fundamental para entender o ciclo de vida de um cliente. Os valores possíveis são: * Prospecto: Um cliente em potencial que ainda não foi totalmente qualificado. * Engajado: Um lead que já está em conversa ou interação com a sua equipe. * Em Negociação: Uma proposta foi enviada e a negociação está em andamento. * Cliente Ativo: Um cliente com contrato ou serviço ativo no momento. * Cliente Inativo: Um cliente que já teve um contrato, mas está inativo. * Promotor: Um cliente satisfeito que atua como promotor da sua marca. * Perdido: Uma oportunidade de negócio que foi perdida. * Não Qualificado: O lead foi desqualificado, pois não se encaixa no perfil de cliente ideal. Acima da lista, você tem acesso rápido às seguintes ações: * **Pesquisar:** Busque rapidamente por uma organização específica. * **Mesclar:** Ferramenta para unificar registros duplicados. * **Filtros:** Permite segmentar sua lista com base em critérios específicos. * **+ Adicionar:** Abre o formulário para cadastrar uma nova organização. *** ### Adicionando uma Nova Organização Para cadastrar uma nova empresa, clique no botão **"+ Adicionar"**. Um formulário simples será exibido para que você preencha as informações essenciais: * **Nome da empresa:** Nome principal ou fantasia da organização. * **CNPJ:** O CNPJ da empresa. * **Razão Social:** O nome legal da empresa. * **Telefone:** Um telefone de contato. * **E-mail:** Um e-mail geral da empresa. {% hint style="info" %} O campo **Nome da empresa** é o único obrigatório para criar um registro inicial. Você pode adicionar as outras informações depois. {% endhint %} Clicando em **"+ Cadastre mais dados"**, você terá acesso a campos adicionais para um cadastro mais completo: * **Endereço:** CEP, País, Estado, Município, Bairro, Logradouro, Número e Complemento. * **Status:** A fase atual da organização no seu funil (ex: Cliente Ativo, Prospecto). * **Dono:** O usuário da sua equipe que é responsável por esta organização. * **Campos Personalizados:** Informações extras que você pode ter configurado na sua conta. *** ### Campos da Organização Abaixo está uma lista detalhada de todos os campos que você pode preencher para uma organização: | CAMPO | DESCRIÇÃO | EXEMPLO | | ------------------------- | ----------------------------------------------------------------------------- | --------------------------------------- | | **Nome da Empresa** | Nome principal ou fantasia da organização. | `Hablla` | | **Razão Social** | Nome de registro legal da empresa. | `Hablla Inc.` | | **CNPJ** | Número do Cadastro Nacional da Pessoa Jurídica. | `12.345.678/0001-90` | | **Sobre** | Uma descrição, notas ou informações relevantes. | `Empresa de software focada em CRM.` | | **Status** | Estágio da organização no funil. | `Cliente Ativo`, `Prospecto`, `Perdido` | | **Telefones** | Lista de telefones. Pode incluir o tipo (pessoal, comercial) e se é WhatsApp. | `+55 11 98765-4321` | | **E-mails** | Lista de endereços de e-mail da organização. | `contato@hablla.com` | | **Endereços** | Lista de endereços físicos. | `Rua Exemplo, 123, São Paulo, SP` | | **Dono** | Usuário da Hablla responsável pela organização. | `Marcus Barboza` | | **Pessoas** | Contatos (pessoas) vinculados a esta organização. | `João Silva`, `Maria Santos` | | **Etiquetas (Tags)** | Marcadores para categorizar e segmentar a organização. | `VIP`, `Software`, `São Paulo` | | **Campos Personalizados** | Campos extras criados por você para atender às necessidades do seu negócio. | `ID do Contrato: C1234` | *** ### Filtrando Organizações Os filtros permitem que você segmente sua base de organizações para encontrar exatamente o que precisa. Clique em **"Filtros"** para abrir a barra lateral de opções. Você pode filtrar por: * **Status:** Exibe apenas organizações com o status selecionado. * **Campos Personalizados:** Filtra com base nos valores dos seus campos personalizados. * **Etiquetas:** Mostra organizações que possuem uma ou mais etiquetas específicas. *** ### Mesclar Organizações Caso encontre registros duplicados, você pode unificá-los. Selecione as organizações que deseja mesclar na lista e clique em **"Mesclar"**. Uma tela aparecerá para que você possa revisar as informações e confirmar a unificação. *** ### Importar Dados Para adicionar múltiplas organizações de uma vez, utilize a função de importação. 1. Clique em **"Importar dados"** no menu lateral esquerdo. 2. **Baixe o modelo da planilha:** Isso garante que seus dados estejam no formato correto. 3. **Preencha a planilha** com as informações das organizações. 4. **Faça o upload do arquivo** na tela de importação. 5. **Defina as regras:** Escolha se deseja atualizar registros existentes ou permitir duplicatas. 6. Clique em **"Importar"** para iniciar o processo. *** ### Exportar Dados Você pode exportar os dados das suas organizações para um arquivo. 1. Clique em **"Exportar dados"** no menu lateral esquerdo. 2. **Dê um nome (Descrição)** para sua exportação. 3. **Selecione o formato** do arquivo: CSV, JSON ou XLSX. 4. Clique em **"Exportar"**. # Tarefas Aprenda a gerenciar Tarefas na Hablla. Crie e organize atividades, defina prazos, visualize em lista ou calendário, filtre e exporte seus dados facilmente. A funcionalidade de **Tarefas** na Hablla é a sua central de gerenciamento de atividades. Ela foi projetada para ajudar você e sua equipe a organizar o trabalho, acompanhar pendências e garantir que nenhuma atividade importante seja esquecida. Gerencie suas atividades em uma lista cronológica ou visualize-as em um calendário para planejar sua semana, vinculando cada tarefa a clientes, organizações e negócios. *** ### Visualizando suas Tarefas A Hablla oferece duas maneiras principais de visualizar suas tarefas, permitindo que você escolha a que melhor se adapta ao seu fluxo de trabalho: a lista de tarefas e o calendário. #### A Visualização em Lista Esta é a tela principal, que exibe suas tarefas em ordem cronológica, agrupadas por mês. É ideal para acompanhar o que foi feito e o que está por vir. Para cada tarefa na lista, você pode ver rapidamente: * **Título e Tipo:** O nome da tarefa e sua categoria (ex: Ligação, Reunião). * **Status:** A etiqueta colorida que indica o progresso (ex: Pendente, Concluído). * **Responsável e Criador:** Quem deve executar e quem criou a tarefa. * **Horário:** O período definido para a execução. * **Ações Rápidas:** Botões para iniciar a tarefa, ver o checklist, adicionar anexos e mais. No topo da tela, você encontra os botões para **Pesquisar**, aplicar **Filtros** e **+ Adicionar** uma nova tarefa. #### A Visualização em Calendário Para uma visão mais estratégica da sua agenda, a visualização em **Calendário** distribui suas tarefas ao longo dos dias e horários da semana. É perfeita para planejar sua disponibilidade e gerenciar seu tempo. Nesta tela, você pode: * Arrastar e soltar tarefas para reagendá-las. * Visualizar a agenda de outros membros da equipe. * Aplicar filtros para focar em tarefas de um setor ou tipo específico. *** ### Campos de uma Tarefa Ao criar ou editar uma tarefa, você pode preencher diversos campos para garantir que todas as informações necessárias estejam claras: {% hint style="info" %} Os campos **Título**, **Descrição**, **Responsável** e as **Datas** são obrigatórios para garantir que a tarefa tenha todas as informações essenciais para sua execução. {% endhint %} * **Título:** O nome da tarefa. * **Descrição:** Detalhes sobre o que precisa ser feito. * **Responsável:** O usuário da equipe que deve executar a tarefa. * **Data de Início e Prazo Final:** O período para a realização da tarefa. * **Tipo:** A categoria da tarefa (Ligação, E-mail, Reunião, etc.). * **Status:** O progresso atual da atividade. * **Vínculos:** Para associar a tarefa a outros registros na Hablla (Pessoas, Organizações, Cards). * **Checklist:** Uma lista de subtarefas que podem ser marcadas como concluídas. * **Anexos:** Permite adicionar arquivos relevantes à tarefa. *** ### Filtrando Tarefas Para encontrar atividades específicas, clique no botão **"Filtros"**. Uma barra lateral será aberta com diversas opções para refinar sua busca. Você pode filtrar suas tarefas por: * **Status** * **Data de Início** e **Fim** * **Usuário** (Responsável) * **Pessoa** vinculada * **Organização** vinculada *** ### Exportando Tarefas Se precisar de um relatório ou de uma lista de tarefas fora da Hablla, você pode exportar os dados facilmente. 1. No menu lateral esquerdo, clique em **"Exportar dados"**. 2. Preencha uma **Descrição** para o seu arquivo. 3. Selecione o formato desejado: **CSV**, **JSON** ou **XLSX**. 4. Clique em **"Exportar"**. # Cartões A área de **Vendas** da Hablla é onde você gerencia seus processos comerciais, de atendimento ou de projetos de forma visual e intuitiva. A gestão é feita através de **Quadros (Boards)** no estilo Kanban, onde cada **Card** representa um negócio, uma oportunidade de venda, um ticket de suporte ou uma atividade em andamento. Esta ferramenta permite um acompanhamento claro do seu funil, centralizando informações financeiras, contatos, produtos e atividades relacionadas em um único lugar. *** ### Criando um Novo Quadro (Funil) Tudo começa com a criação de um **Quadro**, que representa um processo completo. Você pode ter quadros distintos para diferentes equipes ou objetivos. Ao criar um novo quadro, você define: * **Nome do quadro:** O título que identifica o processo (ex: "Funil de Vendas Diretas"). * **Tipo de quadro:** A finalidade do seu funil. * **Motivos de Perda/Ganho:** Habilite para que sua equipe possa registrar por que um negócio foi ganho ou perdido, gerando dados valiosos para análise. * **Configurações Adicionais:** Defina o setor responsável, campos personalizados padrão e outras permissões. {% hint style="info" %} A escolha do **tipo de quadro** (Oportunidade, Ticket ou Atividade) é importante, pois define os campos e comportamentos padrão do seu funil, como a inclusão de valores financeiros. {% endhint %} *** ### Visualizando seus Negócios A Hablla oferece três maneiras principais de visualizar e analisar os cards do seu quadro, permitindo que você escolha a que melhor se adapta ao seu fluxo de trabalho. #### A Visualização em Quadro (Kanban) Esta é a visualização principal e mais utilizada. Ela exibe suas **Etapas (colunas)** e os **Cards** dentro de cada uma, proporcionando uma visão clara do fluxo do seu processo. Você pode facilmente arrastar e soltar os cards de uma coluna para outra para atualizar seu status. #### A Visualização em Lista Para uma análise mais direta e tabular, a visualização em lista exibe todos os cards em linhas, com colunas para **Status, Nome, Etiquetas, Responsável,** e datas. É útil para classificar, ordenar e ter uma visão geral de um grande volume de negócios. #### O Dashboard do Quadro Para análises e insights, o Dashboard compila os dados do seu quadro em gráficos e indicadores. Acompanhe métricas importantes como: * **Quantidade e Valores:** Veja o total de cards e o valor financeiro em cada status (Novo, Em progresso, Ganho, Perdido). * **Gráficos de Conversão:** Analise a contagem de cards por campanha, fonte e status. * **Relatórios:** Acesse resumos por usuários e motivos de ganho/perda. *** ### Adicionando e Gerenciando Cards #### Adicionando um Novo Card (Negócio) Para criar uma nova oportunidade, clique em **"+ Adicionar"**. Um formulário aparecerá para você preencher as informações iniciais: * **Título do cartão:** O nome do negócio. **(Obrigatório)** * **Data de previsão:** A data estimada para o fechamento. * **Dono:** O responsável pela oportunidade. * **Quadro e Lista:** Onde o card será criado. * **Campos personalizados e Descrição.** #### Campos de um Negócio (Card) Um card armazena todas as informações sobre uma negociação. Os campos incluem **Informações Principais** (título, responsável, pessoas e organizações vinculadas), **Valores Financeiros** (valor total, recorrente, descontos), **Datas Importantes** (previsão, fechamento), **Status** (em atendimento, ganho, perdido), **Marketing** (campanha, fonte), **Produtos** e **Checklist**. *** ### Filtrando, Importando e Exportando #### Filtrando seus Negócios Use os **Filtros Personalizados** para segmentar sua visão e encontrar exatamente o que precisa. Os filtros disponíveis incluem Nome, Fonte, Status, Campanha, Organização, Pessoa, Produto, Etiquetas e Setor. #### Importação e Exportação de Dados Você pode adicionar múltiplos cards de uma vez via importação de planilhas ou exportar os dados do seu quadro para análises externas nos formatos CSV, JSON ou XLSX. # Dashboard do Quadro O **Dashboard do Quadro** na Hablla é a sua central de inteligência para monitorar e analisar o desempenho dos seus funis de vendas, processos de atendimento ou projetos. Ele consolida os dados dos cards do seu quadro em uma série de métricas, gráficos e relatórios, oferecendo uma visão clara do que está funcionando e onde há oportunidades de melhoria. Para acessar o Dashboard, navegue até o quadro desejado e selecione a aba **"Dashboard"**. *** ### Seções do Dashboard O Dashboard é dividido em várias seções para fornecer uma visão abrangente do seu processo: #### 1. Resumo Geral do Quadro Esta seção oferece um panorama rápido do estado atual do seu quadro: * **Quantidade de Cartões:** * **Novo:** Número de cards recém-criados. * **Em progresso:** Cards ativos no funil. * **Ganho:** Cards que foram concluídos com sucesso. * **Perdido:** Cards que não foram convertidos. * **Valores:** * **Em progresso:** Valor financeiro total dos cards ativos. * **Ganho:** Valor financeiro total dos cards ganhos. * **Perdido:** Valor financeiro total dos cards perdidos. #### 2. Contagens e Análises Gráficas Esta área apresenta gráficos que detalham a origem e o status dos seus cards, auxiliando na identificação de tendências: * **Contagem de Cards por Campanha e Status:** Analise quais campanhas estão gerando mais cards e qual o percentual de sucesso/perda de cada uma. * **Contagem de Cards por Fonte e Status:** Entenda quais canais de aquisição são mais eficazes em gerar negócios para seu funil. #### 3. Novas Oportunidades por Dia Acompanhe a criação de novos cards ao longo do tempo para identificar picos de atividade ou períodos de menor entrada de oportunidades. #### 4. Relatórios Detalhados Na barra lateral esquerda do Dashboard, você encontrará links para relatórios mais aprofundados: **Resumo por Usuários** Este relatório exibe o desempenho individual de cada membro da equipe que gerencia cards no quadro. Você pode ver: * **User Name:** Nome do usuário. * **New Cards:** Quantidade de novos cards atribuídos ao usuário. * **In Attendance:** Quantidade de cards que o usuário está gerenciando ativamente. * **Total:** Valor total dos cards sob responsabilidade do usuário. * **Total Lost:** Valor total dos cards perdidos pelo usuário. * **Total Won:** Valor total dos cards ganhos pelo usuário. {% hint style="info" %} Use o relatório "Resumo por Usuários" para monitorar a produtividade da equipe e identificar quem são os top performers. {% endhint %} **Cartões Ganhos por Motivos** Analise os motivos que levaram ao sucesso das suas negociações. Esta visão ajuda a identificar padrões e replicar estratégias vitoriosas. **Cartões Perdidos por Motivos** Este é um relatório crucial para entender onde o processo pode estar falhando. Visualize os principais motivos de perda, permitindo que você tome ações corretivas e otimize seu funil. {% hint style="warning" %} A análise dos "Cartões Perdidos por Motivos" é fundamental para a melhoria contínua do seu processo de vendas ou atendimento. Identifique os gargalos e ajuste suas estratégias. {% endhint %} # Componentes Os **componentes da Hablla** são as peças fundamentais para criar automações e fluxos inteligentes. Eles permitem que você **capture informações, processe dados e execute ações** de maneira automatizada, sem precisar programar. Cada componente tem uma função específica e pode ser combinado com outros para criar fluxos personalizados e altamente eficientes. *** ### 🔹 **O que são Componentes na Hablla?** Na Hablla, os componentes são **blocos funcionais** que permitem integrar diferentes sistemas, processar informações e criar regras automáticas dentro dos fluxos de automação. ✔️ **Exemplo de Uso:**\ 📥 Um lead preenche um formulário → O WhatsApp envia uma mensagem automática → A oportunidade é cadastrada no CRM → Uma tarefa é criada para um vendedor. Os componentes permitem essa comunicação e automação entre sistemas.
*** ### 🚀 **Lista de Componentes Disponíveis e Suas Funções** Abaixo, você encontra os **principais componentes disponíveis na Hablla** e o que cada um deles faz: #### 🔮 **Hablla e Hablla GPT** * **Hablla**: Componentes nativos da plataforma para manipulação de dados, automação e controle de fluxos. * **Hablla GPT**: Permite criar agentes autônomos com IA para atendimento, automação de mensagens e análise de texto. 📌 **Exemplo de Uso:** Criar um **agente virtual** que responde dúvidas automaticamente. *** #### 💬 **Canais de Comunicação** São componentes responsáveis pela **entrada e saída de mensagens** nos principais canais conversacionais. **📱 WhatsApp Components** * Recebe e envia mensagens pelo WhatsApp. * Permite interações automáticas e envio de templates HSM. * Conecta com chatbots e agentes humanos. 📌 **Exemplo de Uso:** Enviar uma mensagem automática para um lead qualificado. **👥 Facebook Components** * Gerencia mensagens do Messenger. * Permite automações e interações no Facebook. 📌 **Exemplo de Uso:** Criar um fluxo de atendimento para responder mensagens recebidas no Messenger. **🚀 Telegram Components** * Recebe e envia mensagens no Telegram. * Possui suporte para bots e automações avançadas. 📌 **Exemplo de Uso:** Criar um bot no Telegram para captar leads. **📸 Instagram Components** * Responde mensagens no Direct do Instagram. * Permite capturar interações e criar automações. 📌 **Exemplo de Uso:** Enviar uma mensagem automática para quem comentar em um post. *** #### 🔥 **Integrações e APIs** São componentes que **conectam a Hablla com outras plataformas** para enviar e receber dados. **⚡ Triggers and HTTP** * Permite configurar **webhooks** para receber e enviar informações para outras plataformas. * Inicia automações sempre que um evento externo acontece. 📌 **Exemplo de Uso:** Quando um cliente faz uma compra, um webhook pode ser acionado para criar uma oportunidade de pós-venda. **📊 Pipedrive** * Conecta-se ao CRM Pipedrive para **criação e atualização de negócios**. 📌 **Exemplo de Uso:** Criar um novo negócio no Pipedrive quando um lead responde no WhatsApp. **🔄 RD Station CRM e RD Station Marketing** * Integra-se ao RD Station CRM e Marketing para cadastrar leads, atualizar oportunidades e enviar campanhas. 📌 **Exemplo de Uso:** Enviar um lead qualificado do WhatsApp para o RD Station Marketing. **✅ Trello** * Cria, atualiza e move cartões dentro de um quadro no Trello. 📌 **Exemplo de Uso:** Criar um cartão automaticamente quando uma nova tarefa é registrada na Hablla. **📧 Email Trigger and Send Message** * Permite enviar e receber e-mails automatizados. 📌 **Exemplo de Uso:** Disparar um e-mail automático de confirmação após um cliente se cadastrar. **🔍 Google** * Integra-se com serviços do Google, como Planilhas, Drive e Analytics. 📌 **Exemplo de Uso:** Registrar dados de leads em uma planilha automaticamente. **💳 Asaas** * Conecta-se ao sistema de pagamentos Asaas, permitindo criar cobranças e acompanhar faturas. 📌 **Exemplo de Uso:** Gerar automaticamente um boleto para um cliente que realizou uma compra. **🔀 Transformação de Dados** * Processa, formata e manipula informações antes de enviá-las para outros componentes. 📌 **Exemplo de Uso:** Converter um número de telefone antes de enviar para outro sistema. **🛠 Others** * Reúne outras integrações e funcionalidades diversas dentro da Hablla. 📌 **Exemplo de Uso:** Criar conexões personalizadas com APIs externas. *** ### 🔹 **Como Adicionar um Componente no Fluxo?** 1️⃣ **Clique no botão "Adicionar Componente"** dentro do Hablla Studio.\ 2️⃣ **Escolha um componente** da lista exibida.\ 3️⃣ **Configure os parâmetros** (como canais, integrações ou variáveis de entrada e saída).\ 4️⃣ **Salve e conecte o componente** ao fluxo desejado. *** ### 🎯 **Conclusão** Os componentes da Hablla permitem **criar fluxos inteligentes, automatizar processos e conectar diferentes sistemas**, tudo de maneira intuitiva. 🚀 **Combinando esses componentes, você pode criar uma experiência de atendimento e automação altamente eficiente!** # Entrada e Saída Na Hablla, **toda entrada e saída de um componente é feita em formato JSON**. Isso significa que cada ação dentro do fluxo de automação recebe informações (entrada), processa esses dados e retorna um resultado (saída). Vamos entender melhor como isso funciona e como você pode utilizar essas informações no seu dia a dia. *** ### 🏗 **Fluxo de Dados na Hablla** 1️⃣ **Entrada** → O componente recebe um conjunto de dados em JSON, vindos de outras etapas do fluxo.\ 2️⃣ **Processamento** → O componente manipula os dados e faz requisições internas ou externas.\ 3️⃣ **Saída** → O componente retorna um JSON com as informações processadas, incluindo status, detalhes da requisição e resultados obtidos. 📌 **Exemplo real na Hablla:**\ Imagine que um componente recebe dados de um contato do WhatsApp e precisa criar um cartão de atendimento no sistema. *** ### 📥 **Entrada de Dados** A entrada contém todas as informações disponíveis para o componente. Essas informações vêm de componentes anteriores no fluxo. **Exemplo de entrada (JSON):** ```json { "whatsapp": { "name": "Marcus Barboza", "phone_number": "5517997275046" }, "person": { "name": "Marcus Barboza", "customer_status": "lead", "id": "675c7667dc2708736e804575" }, "service": { "type": "whatsapp", "status": "in_bot", "id": "67c7503f15788872a1f61328" }, "content": { "body": "Hablla, boa tarde!" } } ``` Os dados na Hablla são gerados a partir de interações do usuário, capturados de sistemas externos ou adicionados por componentes anteriores no fluxo de automação. As automações na Hablla podem ser iniciadas por eventos disparados a partir de **componentes receptivos** como **WhatsApp, Instagram, Messenger, Telegram, Email, Telefone**, além de integrações via **Webhooks, CRON** e **Trigger**. Esses eventos (trigger) podem ser acionados por diferentes tipos de ações dentro da plataforma, como:\ ✅ **Interações com Pessoas** → Leads, clientes ou usuários realizando ações no sistema.\ ✅ **Organizações** → Atualizações em empresas cadastradas.\ ✅ **Cards** → Movimentações dentro de quadros e pipelines.\ ✅ **Bot e Chat** → Mensagens enviadas ou recebidas por IA ou operadores humanos.\ ✅ **Chamadas Telefônicas e Emails** → Registros e atualizações de comunicações.\ ✅ **Campos Personalizados (Custom Fields)** → Mudanças em dados específicos dentro do CRM.\ ✅ **Eventos de Sessão** → Login, logout, sessão expirada, status online/offline.\ ✅ **Serviços e Transferências** → Atribuições de atendimentos e movimentação entre setores.\ ✅ **Tags e Usuários** → Ações relacionadas a segmentação e permissões de usuários.\ ✅ **Tarefas e Dicionário de Dados** → Atualizações em tarefas ou informações estruturadas.\ ✅ **Conversões e Alterações de Status** → Mudanças em estágios do funil de vendas e atendimento. Sempre que um desses eventos é ativado na Hablla, ele dispara uma **trigger** que recebe os dados do evento e executa ações configuradas, como: **Criar, Atualizar, Excluir, Mesclar**, entre outras. 🚀 *** ### ⚙ **Processamento de Dados** Entre a **entrada** e a **saída**, o componente manipula os dados recebidos. Ele pode:\ ✅ **Consultar um banco de dados** → Buscar informações de clientes, pedidos, etc.\ ✅ **Fazer uma chamada para uma API externa** → Como integrar um ERP ou outro sistema de API aberta.\ ✅ **Aplicar regras de automação** → Criar, atualizar ou excluir registros na Hablla conforme regras do fluxo. *** ### 📤 **Saída de Dados** A saída contém o resultado da operação do componente. Ela segue sempre o mesmo formato e inclui: 1️⃣ **value** → Resultado da operação (exemplo: sucesso ou erro).\ 2️⃣ **headers** → Cabeçalhos da requisição (útil para depuração e segurança).\ 3️⃣ **config** → Configuração da requisição, como URL e tempo de resposta.\ 4️⃣ **request** → Caminho da chamada feita pelo componente.\ 5️⃣ **data** → O resultado final da operação. **Exemplo de saída (JSON):** ```json { "status": "fulfilled", "value": { "status": 200, "statusText": "OK", "headers": { "content-type": "application/json; charset=utf-8", "date": "Tue, 04 Mar 2025 19:10:56 GMT" }, "config": { "method": "GET", "url": "https://api.hablla.com/v3/workspaces/643d802021b6aa9234eb9797/cards" }, "request": { "method": "GET", "path": "/v3/workspaces/643d802021b6aa9234eb9797/cards?person=675c7667dc2708736e804575" }, "data": { "results": [], "count": 0, "totalItems": 0 } } } ``` 🔹 **O que esses dados significam?**\ ✅ **status**: Indica se a operação foi bem-sucedida (`fulfilled`) ou se houve erro.\ ✅ **value.status**: O código de resposta HTTP (`200` significa sucesso, `400` erro de requisição, etc.).\ ✅ **config.url**: A URL utilizada na requisição.\ ✅ **request.path**: O caminho exato da API chamada.\ ✅ **data**: O resultado da requisição (neste caso, não encontrou nenhum cartão para essa pessoa). *** ### 🛠 **Como Usar Esses Dados no Fluxo** 💡 Você pode acessar qualquer valor da **entrada** ou da **saída** do componente dentro do fluxo usando a sintaxe: ```plaintext {{$data?.codigoDoComponente?.caminhoVariavel}} ``` 📌 Existem exemplos em [**Usando variáveis**](/fluxos-de-automacoes/usando-variaveis) *** ### 🚀 **Conclusão** 🔹 **A entrada** contém os dados disponíveis antes do componente ser executado.\ 🔹 **O componente** processa esses dados, faz requisições e aplica regras de automação.\ 🔹 **A saída** mostra o resultado da operação, permitindo que o fluxo continue automaticamente. 💡 **Dica:** Sempre analise a **entrada** e a **saída** para entender como os dados estão fluindo dentro da automação. Isso facilita identificar erros e configurar suas regras corretamente! 🚀 # Usando variáveis Na Hablla, ao configurar um fluxo de automação, você pode utilizar **variáveis** para recuperar dados de componentes anteriores e expressões **lógicas e condicionais** para tornar suas automações mais dinâmicas e inteligentes. Isso permite que informações sejam reutilizadas automaticamente, sem precisar preenchê-las manualmente, tornando o processo mais eficiente e sem erros. ### 🎯 **O Que São Variáveis na Hablla?** Cada componente dentro de um fluxo tem um **código único** e pode gerar **dados de saída** que podem ser usados por outros componentes no mesmo fluxo.
Você pode acessar esses dados usando a seguinte sintaxe: ```plaintext {{$data?.codigoDoComponente?.caminhoVariavel}} ``` ➡ **Exemplo real:**\ Se um componente chamado `whatsappReceptive_tmy0de` identificou uma pessoa, e o ID dela está armazenado dentro do campo `person.id`, podemos acessar esse valor assim: ```plaintext {{$data?.whatsappReceptive_tmy0de?.person?.id}} ``` Se esse componente não retornar um valor válido, podemos tentar um segundo componente chamado `whatsappReceptive_r2b7wr`: ```plaintext {{$data?.whatsappReceptive_tmy0de?.person?.id ?? $data?.whatsappReceptive_r2b7wr?.person?.id}} ``` 📌 Aqui, `??` significa: **se o primeiro valor for nulo ou indefinido, use o segundo.** *** ### 🔥 **Operadores e Expressões na Hablla** Além de acessar variáveis, você pode usar **operadores lógicos** para criar regras e condições dentro dos seus fluxos. #### 🛠 Operadores Lógicos e Condicionais | Operador | Significado | Exemplo | | --------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | `??` (Nullish Coalescing - "Se nulo ou indefinido") | Se o primeiro valor for nulo ou indefinido, use o segundo | `{{$data?.componente1?.valor ?? $data?.componente2?.valor}}` | | \|\| (Logical OR - "Ou") | Se o primeiro valor for falso (`false`, `null`, `undefined`, `0`, `""`), usa o segundo | {{$data?.status \|\| "Pendente"}} | | `:` (Operador ternário - "Se... então... senão") | Funciona como um operador ternário (if/else) | `{{$data?.idade > 18 ? "Maior de idade" : "Menor de idade"}}` | | `&&` (Logical AND - "E") | Retorna o segundo valor se o primeiro for verdadeiro | `{{$data?.temDesconto && "Desconto Aplicado"}}` | *** | Operador | Significado | Exemplo | | ------------------- | --------------------------- | ------------------ | | `+` (Adição) | Soma dois valores. | `{{5 + 3}}` → `8` | | `-` (Subtração) | Subtrai dois valores. | `{{10 - 4}}` → `6` | | `*` (Multiplicação) | Multiplica dois valores. | `{{3 * 4}}` → `12` | | `/` (Divisão) | Divide dois valores. | `{{10 / 2}}` → `5` | | `%` (Módulo) | Retorna o resto da divisão. | `{{10 % 3}}` → `1` | *** #### 🔍 **Operadores de Comparação** | Operador | Significado | Exemplo | | ------------------------------ | ----------------------------------------------------------------- | ------------------------- | | `==` (Igualdade) | Compara valores sem verificar o tipo. | `{{5 == "5"}}` → `true` | | `===` (Estritamente igual) | Compara valores e o tipo de dado. | `{{5 === "5"}}` → `false` | | `!=` (Diferente) | Compara se os valores são diferentes. | `{{5 != "5"}}` → `false` | | `!==` (Estritamente diferente) | Compara se os valores e os tipos são diferentes. | `{{5 !== "5"}}` → `true` | | `>` (Maior que) | Retorna `true` se o primeiro valor for maior que o segundo. | `{{10 > 5}}` → `true` | | `<` (Menor que) | Retorna `true` se o primeiro valor for menor que o segundo. | `{{3 < 7}}` → `true` | | `>=` (Maior ou igual) | Retorna `true` se o primeiro valor for maior ou igual ao segundo. | `{{8 >= 8}}` → `true` | | `<=` (Menor ou igual) | Retorna `true` se o primeiro valor for menor ou igual ao segundo. | `{{6 <= 5}}` → `false` | *** #### 🔄 **Operadores de String** | Operador | Significado | Exemplo | | ------------------ | ------------------- | ------------------------------------------ | | `+` (Concatenação) | Junta duas strings. | `{{"Olá, " + "mundo!"}}` → `"Olá, mundo!"` | *** #### 🔀 **Operadores de Arrays** | Operador | Significado | Exemplo | | ------------- | -------------------------------------------- | ------------------------------------------ | | `.length` | Retorna o tamanho de um array. | `{{$data?.nomes.length}}` | | `.includes()` | Verifica se um valor existe no array. | `{{$data?.cidades.includes("São Paulo")}}` | | `.map()` | Itera sobre os elementos e modifica o array. | `{{$data?.numeros.map(n => n * 2)}}` | | `.filter()` | Filtra elementos do array. | `{{$data?.numeros.filter(n => n > 5)}}` | ### 🔍 **Como Usar Condições IF/ELSE** Na Hablla, você pode criar **regras condicionais** dentro dos fluxos. Veja como funciona: #### ✅ **Exemplo 1: Verificar se um cliente está qualificado** ```plaintext {{$data?.lead?.score > 50 ? "Lead Qualificado" : "Lead Não Qualificado"}} ``` Se o score do lead for **maior que 50**, o resultado será `"Lead Qualificado"`, caso contrário, `"Lead Não Qualificado"`. #### ✅ **Exemplo 2: Definir um status padrão** ```plaintext {{$data?.pedido?.status ?? "Em processamento"}} ``` Se o status do pedido existir, ele será utilizado. Caso contrário, o status padrão `"Em processamento"` será aplicado. #### ✅ **Exemplo 3: Combinar múltiplas condições** ```plaintext {{$data?.usuario?.idade >= 18 ? "Maior de idade" : $data?.usuario?.idade > 0 ? "Menor de idade" : "Idade não informada"}} ``` 🔹 Se a idade for maior ou igual a **18**, o resultado será `"Maior de idade"`.\ 🔹 Se a idade for maior que **0**, mas menor que **18**, o resultado será `"Menor de idade"`.\ 🔹 Se a idade não estiver informada, o resultado será `"Idade não informada"`. *** ### 🎯 **Como Utilizar Essas Expressões na Configuração de um Componente** Sempre que estiver configurando um componente na Hablla, você pode usar essas expressões nos campos onde deseja inserir valores dinâmicos. 📌 **Exemplo prático:**\ Suponha que estamos criando um novo cartão no fluxo e queremos associar a ele uma pessoa identificada em um componente anterior. Podemos fazer isso assim: ```plaintext {{$data?.whatsappReceptive_tmy0de?.person?.id ?? $data?.whatsappReceptive_r2b7wr?.person?.id}} ``` Isso garante que, se um componente não encontrar a pessoa, o outro será usado automaticamente. *** ### 🔥 **Resumo: Como Usar Variáveis e Expressões na Hablla** ✅ **Use `{{$data?.codigoDoComponente?.caminhoVariavel}}`** para acessar dados de componentes anteriores.\ ✅ **Use `??` para definir um valor alternativo caso o primeiro seja nulo ou indefinido.**\ ✅ **Use `||` para definir um valor alternativo caso o primeiro seja falso.**\ ✅ **Use `:` para criar regras `if/else` dentro dos campos.**\ ✅ **Use `&&` para definir um valor somente se a condição for verdadeira.** 🚀 **Com essas técnicas, você pode criar fluxos inteligentes e personalizados sem precisar programar!** # Manipulando Datas Na Hablla, a **manipulação de datas** é essencial para configurar automações, definir prazos e criar regras inteligentes dentro do fluxo. Você pode definir datas automaticamente usando expressões dentro dos campos, sem precisar programar. ### 🌍 Ajustando o Fuso Horário Os horários utilizados em automações seguem o **padrão UTC (Tempo Universal Coordenado)**. No entanto, dependendo do local onde você está, pode ser necessário ajustar esse horário. ✅ **Exemplo para o Brasil:**\ O **fuso horário de Brasília** é UTC **-3**. Para ajustar qualquer data ao horário correto, basta subtrair **3 horas** da data gerada. *** ### 🔹 Como Definir Datas Dinamicamente? Na Hablla, usamos **expressões de data** dentro de **{{ }}** para calcular e definir valores automaticamente. #### ✅ **Definir Data Atual** (com ajuste de fuso horário) Se você quiser definir um campo com a **data e hora do momento da automação**, ajustando para Brasília (UTC -3), use: ``` {{new Date(Date.now() - 3 * 60 * 60 * 1000)}} ``` 📌 **Exemplo:** Se a execução ocorrer em **4 de março de 2025, às 14h UTC**, o ajuste exibirá **"Tue Mar 04 2025 11:00:00 GMT-3"**. *** #### ⏳ **Adicionando Tempo à Data Atual** Se você precisa adicionar minutos, horas ou dias à data atual, basta somar o valor correspondente ao `Date.now()` e subtrair as 3 horas do fuso horário. **➕ Adicionar Minutos** Cada minuto equivale a **60.000 milissegundos**. Para adicionar 20 minutos e ajustar para UTC -3, usamos: ``` {{new Date(Date.now() + 20 * 60 * 1000 - 3 * 60 * 60 * 1000)}} ``` 📌 **Exemplo de Uso:** Definir a **Data de Início** de uma tarefa para 20 minutos no futuro. *** **⏳ Adicionar Horas** Cada hora equivale a **3.600.000 milissegundos**. Para adicionar **3 horas**, já considerando o fuso horário, usamos: ``` {{new Date(Date.now() + 3 * 60 * 60 * 1000 - 3 * 60 * 60 * 1000)}} ``` 📌 **Exemplo de Uso:** Definir a **Data de Término** para 3 horas após o início da tarefa. *** **📅 Adicionar Dias** Cada dia tem **86.400.000 milissegundos**. Para adicionar **2 dias** e manter o ajuste do fuso horário, usamos: ``` {{new Date(Date.now() + 2 * 24 * 60 * 60 * 1000 - 3 * 60 * 60 * 1000)}} ``` 📌 **Exemplo de Uso:** Configurar um prazo de vencimento para 2 dias após a criação da tarefa. *** #### ⏰ **Definir um Intervalo entre Datas**

Configuração de um componnte Hablla para Criar Tarefa

Se você precisa configurar **Data de Início e Data de Término**, pode usar expressões diferentes para cada campo. 🔹 **Data de Início:** 20 minutos a partir do momento atual (UTC -3): ``` {{new Date(Date.now() + 20 * 60 * 1000 - 3 * 60 * 60 * 1000)}} ``` 🔹 **Data de Término:** 40 minutos após a criação da tarefa (UTC -3): ``` {{new Date(Date.now() + 40 * 60 * 1000 - 3 * 60 * 60 * 1000)}} ``` 📌 **Exemplo de Uso:** Criar uma tarefa que inicie em 20 minutos e termine em 40 minutos. *** #### 🕑 **Subtrair Tempo da Data Atual** Se precisar configurar um horário **antes do momento atual**, basta **subtrair** valores. 🔹 **Exemplo: Definir um horário 1 hora atrás (UTC -3):** ``` {{new Date(Date.now() - 1 * 60 * 60 * 1000 - 3 * 60 * 60 * 1000)}} ``` 📌 **Uso:** Criar um evento com data retroativa. *** ### 🎯 **Dicas Finais** ✅ **Sempre ajuste o fuso horário** de acordo com sua localização. O Brasil usa UTC **-3**, mas se for outro local, ajuste conforme necessário.\ ✅ **Multiplique corretamente os valores** para minutos, horas e dias.\ ✅ **As datas geradas seguem o formato UTC**, mas podem ser convertidas no sistema automaticamente.\ ✅ **Testar antes de aplicar** ajuda a evitar erros de configuração. 🚀 **Com essas técnicas, você pode automatizar tarefas e prazos corretamente, sempre respeitando o horário local!** # Todos os Componentes # Hablla # Pessoas # Criar Neste guia, você aprenderá a usar o componente visual da Hablla para criar uma nova pessoa dentro do seu fluxo de automação. A operação Criar Pessoa permite registrar um novo indivíduo (como um lead, cliente ou contato) na sua base da Hablla. Esta ação é fundamental para centralizar as informações de contato e iniciar o gerenciamento do relacionamento através de automações. Ao criar uma pessoa, você pode especificar todos os seus dados principais, como nome, status de cliente, informações de contato e campos personalizados, garantindo que o registro já nasça completo e pronto para ser utilizado em outros fluxos. #### Como Configurar 1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação. 2. No campo "Operação", selecione a opção "Criar". 3. Escolha como deseja fornecer os dados: "Usando Campos" para a interface visual ou "Usando JSON" para maior flexibilidade. *** ### Parâmetros (Usando Campos) Abaixo estão todos os campos disponíveis ao configurar a criação de uma nova pessoa. | Campo | Tipo | Obrigatório? | Descrição | | --------------------- | ----------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Nome | Texto | ✅ Sim | O nome completo da pessoa. | | Sobre | Texto Longo | ❌ Não | Um campo aberto para anotações ou uma biografia sobre a pessoa. | | URL da Foto de Perfil | Texto | ❌ Não | O link para a imagem de perfil da pessoa. | | Privacidade | Lista de Opções | ✅ Sim | Define a base legal do contato. Opções: `unknown`, `granted`, `interest`, `pre-existing`, `legal`, `protection`, `public`. | | Status do Cliente | Lista de Opções | ✅ Sim | Classifica a pessoa no funil de vendas. Opções: `visitor`, `lead`, `marketing_qualified_lead`, `sales_qualified_lead`, `opportunity`, `customer`, `evangelist`, `ex_customer`. | | Responsável (Owner) | Lista de Usuários | ❌ Não | Permite associar um ou mais usuários da plataforma como responsáveis por essa pessoa. | | Telefones | Coleção de Campos | ❌ Não | Uma lista de um ou mais telefones associados. Cada telefone deve conter: `Tipo` (Personal ou Business), `Telefone` (o número) e `É WhatsApp?` (sim/não). | | E-mails | Coleção de Campos | ❌ Não | Uma lista com um ou mais endereços de e-mail. | | Endereços | Coleção de Campos | ❌ Não | Uma lista de endereços. Cada endereço pode conter: `CEP`, `País`, `Rua`, `Número`, `Complemento`, `Bairro`, `Cidade` e `Estado`. | | Campos Personalizados | Chave-Valor | ❌ Não | Permite preencher os campos personalizados que foram criados na plataforma para a entidade "Pessoa". | Exportar para as Planilhas *** ### Estrutura (Usando JSON) Para usuários avançados, é possível fornecer todos os dados em um único objeto JSON. Esta é a estrutura base: JSON ``` { "name": "João da Silva", "about": "Lead interessado no produto X. Veio da campanha de marketing de agosto.", "photo_url": "https://example.com/photo.jpg", "privacy": "granted", "customer_status": "lead", "users": [ "user_id_1", "user_id_2" ], "phones": [ { "type": "personal", "phone": "+5511999998888", "is_whatsapp": true } ], "emails": [ { "email": "joao.silva@example.com" } ], "addresses": [ { "zip_code": "01001-000", "country": "Brasil", "street": "Praça da Sé", "number": "100", "complement": "Lado A", "neighborhood": "Sé", "city": "São Paulo", "state": "SP" } ], "custom_fields": { "origem_do_lead": "Website", "score": 50 } } ``` *** ### 🚀 Exemplo de Caso de Uso Objetivo: Cadastrar um novo lead na Hablla sempre que um formulário de "Peça uma Demonstração" for preenchido no site. 1. Crie um gatilho no seu fluxo que recebe os dados do formulário via Webhook. 2. Adicione o bloco "Pessoas" e selecione a operação "Criar". 3. Mapeie os campos recebidos do formulário para os parâmetros da ação "Criar Pessoa": * `Nome` ← `dados.webhook.nome` * `E-mails` ← `dados.webhook.email` * `Telefones` ← `dados.webhook.telefone` 4. Defina um valor fixo para o campo Status do Cliente como `"lead"`. 5. Associe um usuário específico no campo Responsável para que ele receba a notificação do novo lead. Com isso, a cada novo envio no formulário, uma nova pessoa será criada automaticamente na plataforma, com o status e o responsável já definidos, pronta para o time comercial agir. # Atualizar Este guia mostrará como editar os dados de uma pessoa dentro do seu fluxo de automação usando a interface visual da Hablla. A operação Atualizar Pessoa permite modificar os dados de um registro de pessoa existente na sua base da Hablla. Esta ação é essencial para manter as informações de seus contatos sempre corretas e atualizadas, refletindo mudanças de status, novos dados de contato ou qualquer outra informação relevante. Você pode usar esta operação para alterar informações específicas, como o status de cliente após uma compra, adicionar um novo número de telefone ou atualizar o usuário responsável por um lead. #### Como Configurar 1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação. 2. No campo "Operação", selecione a opção "Atualizar". 3. No campo "ID da Pessoa" (`personId`), insira o identificador único da pessoa que você deseja atualizar. Este dado é obrigatório e pode ser obtido de etapas anteriores do fluxo. 4. Escolha como deseja fornecer os novos dados: "Usando Campos" para a interface visual ou "Usando JSON" para maior flexibilidade. *** ### Parâmetros (Usando Campos) Abaixo estão todos os campos disponíveis para atualizar uma pessoa. Você precisa preencher apenas os campos que deseja alterar. | Campo | Tipo | Obrigatório? | Descrição | | --------------------- | ----------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------- | | ID da Pessoa | Texto | ✅ Sim | O ID único da pessoa a ser atualizada. | | Nome | Texto | ❌ Não | O nome completo da pessoa. | | Sobre | Texto Longo | ❌ Não | Um campo aberto para anotações ou uma biografia sobre a pessoa. | | URL da Foto de Perfil | Texto | ❌ Não | O link para a imagem de perfil da pessoa. | | Privacidade | Lista de Opções | ❌ Não | Define a base legal do contato. Opções: `unknown`, `granted`, `interest`, `pre-existing`, `legal`, `protection`, `public`. | | Status do Cliente | Lista de Opções | ❌ Não | Classifica a pessoa no funil de vendas. Opções: `visitor`, `lead`, `marketing_qualified_lead`, etc. | | Responsável (Owner) | Lista de Usuários | ❌ Não | Permite associar um ou mais usuários da plataforma como responsáveis por essa pessoa. | | Telefones | Coleção de Campos | ❌ Não | Adiciona um ou mais telefones. Cada telefone deve conter: `Tipo`, `Telefone` e `É WhatsApp?`. | | E-mails | Coleção de Campos | ❌ Não | Adiciona um ou mais endereços de e-mail. | | Endereços | Coleção de Campos | ❌ Não | Adiciona um ou mais endereços. | | Campos Personalizados | Chave-Valor | ❌ Não | Permite preencher ou alterar valores em campos personalizados. | Exportar para as Planilhas *** ### Estrutura (Usando JSON) Para usuários avançados, é possível fornecer os dados a serem atualizados em um objeto JSON. Lembre-se que o `personId` é passado diretamente no campo de configuração da operação, não no corpo JSON. JSON ``` { "name": "João da Silva Santos", "customer_status": "customer", "phones": [ { "type": "business", "phone": "+5511988887777", "is_whatsapp": true } ], "custom_fields": { "ultima_compra": "2024-08-15" } } ``` *** ### 🚀 Exemplo de Caso de Uso Objetivo: Quando um negócio é movido para a etapa "Ganha" em um funil, atualizar o status da pessoa associada para "Cliente" e adicionar uma tag de "Cliente VIP". 1. Inicie um fluxo com o gatilho "Card Movido", configurado para a etapa "Ganha". 2. Use a operação "Obter Card por ID" para pegar os detalhes do negócio, incluindo o ID da pessoa associada (`card.person.id`). 3. Adicione o bloco "Pessoas" e selecione a operação "Atualizar". 4. No campo "ID da Pessoa", insira a variável do passo anterior: `{{steps.1.result.person.id}}`. 5. No campo "Status do Cliente", selecione o valor `customer`. 6. Adicione um passo seguinte com o bloco "Pessoas", operação "Adicionar Tags", e adicione a tag "Cliente VIP" à mesma pessoa. Dessa forma, seu processo de vendas fica totalmente sincronizado com os dados dos seus contatos, garantindo que eles reflitam corretamente a jornada do cliente. # Criar ou Atualizar Com essa operação, a automação verifica se a pessoa já existe no sistema baseado no telefone e e-mail: Se existir, os dados serão atualizados. Se não existir, será criada uma nova pessoa. A operação Criar ou Atualizar Pessoa é uma funcionalidade poderosa para gerenciar contatos de forma inteligente, evitando a criação de duplicatas. O sistema utiliza os campos de identificação única (como e-mail ou telefone) para verificar se a pessoa já existe na base. * Se a pessoa for encontrada, seus dados serão atualizados com as informações fornecidas. * Se a pessoa não for encontrada, um novo registro será criado. Esta ação é ideal para integrações com outras plataformas, onde os dados de contato são enviados repetidamente e você precisa garantir a consistência da sua base. #### Como Configurar 1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação. 2. No campo "Operação", selecione a opção "Criar ou Atualizar". 3. Preencha os campos com os dados da pessoa. É crucial fornecer pelo menos um identificador único (E-mail ou Telefone) para que a busca funcione. 4. Defina o campo "Regra" (`rule`) para determinar como o sistema deve se comportar caso encontre múltiplos registros com os mesmos dados. *** ### Parâmetros (Usando Campos) | Campo | Tipo | Obrigatório? | Descrição | | --------------------- | ----------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Regra (`rule`) | Lista de Opções | ✅ Sim | Define qual registro atualizar caso mais de um seja encontrado. Opções: `older` (atualiza o mais antigo) ou `newest` (atualiza o mais recente). O padrão é `older`. | | Nome | Texto | ✅ Sim | O nome completo da pessoa. | | Privacidade | Lista de Opções | ✅ Sim | Define a base legal do contato. Opções: `granted`, `interest`, etc. | | Status do Cliente | Lista de Opções | ✅ Sim | Classifica a pessoa no funil de vendas. Opções: `visitor`, `lead`, `customer`, etc. | | E-mails | Coleção de Campos | ✅ Sim | Forneça pelo menos um e-mail. Este campo é usado para encontrar a pessoa existente. | | Telefones | Coleção de Campos | ❌ Não | Forneça um ou mais telefones. Este campo também é usado para encontrar a pessoa existente. | | Sobre | Texto Longo | ❌ Não | Um campo aberto para anotações ou uma biografia sobre a pessoa. | | URL da Foto de Perfil | Texto | ❌ Não | O link para a imagem de perfil da pessoa. | | Responsável (Owner) | Lista de Usuários | ❌ Não | Associa ou altera os usuários responsáveis por esta pessoa. | | Endereços | Coleção de Campos | ❌ Não | Adiciona ou atualiza os endereços da pessoa. | | Campos Personalizados | Chave-Valor | ❌ Não | Preenche ou altera valores nos campos personalizados. | Exportar para as Planilhas > ⚠️ Importante: Para que a funcionalidade de "Atualizar" funcione corretamente, você deve fornecer pelo menos um dos campos de identificação: E-mails ou Telefones. *** ### Estrutura (Usando JSON) O corpo JSON permite fornecer todos os dados de uma vez. A lógica de busca e a regra de atualização serão aplicadas com base nos dados enviados. JSON ``` { "rule": "newest", "name": "Maria Oliveira", "customer_status": "opportunity", "privacy": "granted", "emails": [ { "email": "maria.oliveira@example.com" } ], "phones": [ { "type": "personal", "phone": "+5521999991234", "is_whatsapp": true } ], "custom_fields": { "produto_interesse": "Plano Premium", "score": 85 } } ``` *** ### 🚀 Exemplo de Caso de Uso Objetivo: Sincronizar uma lista de contatos de uma plataforma de automação de marketing (ex: RD Station, Mailchimp) com a Hablla, sem gerar contatos duplicados. 1. Crie um fluxo que é executado periodicamente (ex: a cada 24 horas). 2. Nesse fluxo, adicione uma etapa que busca os contatos atualizados recentemente na plataforma de marketing. 3. Use um laço (`loop`) para processar cada contato retornado pela plataforma. 4. Dentro do laço, adicione o bloco "Pessoas" com a operação "Criar ou Atualizar". 5. Mapeie os campos do contato vindo da plataforma externa (nome, email, telefone, etc.) para os parâmetros da ação na Hablla. 6. Defina a Regra como `newest` para garantir que, se houver duplicatas na sua base, a mais recente seja sempre a atualizada. Ao executar este fluxo, sua base na Hablla será enriquecida com novos contatos e atualizada com as informações mais recentes, mantendo-a limpa e sem duplicidade. # Bloquear Com essa operação, você pode impedir que um contato continue interagindo dentro da sua automação. A operação Bloquear Pessoa permite alterar o status de bloqueio de um contato. Uma pessoa bloqueada geralmente deixa de receber comunicações e pode ser excluída de certas automações, ajudando a manter sua base de contatos higienizada e respeitando as solicitações de privacidade. Esta ação pode ser usada tanto para bloquear quanto para desbloquear uma pessoa, simplesmente alterando o valor do parâmetro. #### Como Configurar 1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação. 2. No campo "Operação", selecione a opção "Bloquear". 3. No campo "ID da Pessoa" (`personId`), insira o identificador único da pessoa cujo status de bloqueio você deseja alterar. 4. Defina o campo "Bloquear" como `true` para bloquear ou `false` para desbloquear. *** ### Parâmetros (Usando Campos) | Campo | Tipo | Obrigatório? | Descrição | | --------------------- | ------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------- | | ID da Pessoa | Texto | ✅ Sim | O ID único da pessoa a ser bloqueada ou desbloqueada. | | Bloquear (`is_block`) | Booleano (Sim/Não) | ✅ Sim | Define a ação a ser tomada. Selecione `true` (sim) para bloquear a pessoa ou `false` (não) para remover o bloqueio. | Exportar para as Planilhas *** ### Estrutura (Usando JSON) O corpo da requisição JSON é simples, contendo apenas a chave `is_block`. Para bloquear uma pessoa: JSON ``` { "is_block": true } ``` Para desbloquear uma pessoa: JSON ``` { "is_block": false } ``` *** ### 🚀 Exemplo de Caso de Uso Objetivo: Bloquear automaticamente um contato na Hablla quando um e-mail enviado para ele resulta em "hard bounce" (falha permanente na entrega). 1. Crie um fluxo que utilize um gatilho do seu serviço de e-mail (via Webhook) que dispara quando ocorre um "hard bounce". 2. O gatilho receberá o e-mail do destinatário que falhou. 3. Use a operação "Buscar Pessoa por E-mail" para encontrar o ID da pessoa correspondente a esse e-mail na Hablla. 4. Adicione o bloco "Pessoas" com a operação "Bloquear". 5. No campo "ID da Pessoa", insira a variável do ID encontrado no passo anterior (`{{steps.2.result.id}}`). 6. No campo "Bloquear", defina o valor como `true`. Com esta automação, sua base de contatos se mantém limpa, evitando envios futuros para endereços de e-mail inválidos e melhorando a reputação do seu domínio de envio. # Obter por ID Com essa operação, a automação pode buscar os dados de uma pessoa usando o ID dela e utilizar essas informações em outros blocos do fluxo. A operação Obter Pessoa por ID recupera todas as informações de um registro de pessoa específico, utilizando o seu identificador único (`personId`). Esta ação é uma das mais utilizadas em automações, pois permite carregar os dados de um contato conhecido para utilizá-los em etapas seguintes, como personalizar uma mensagem, tomar decisões com base em seus dados (ex: status do cliente) ou simplesmente verificar suas informações. O resultado desta operação é um objeto completo contendo todos os campos da pessoa, incluindo campos personalizados. #### Como Configurar 1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação. 2. No campo "Operação", selecione a opção "Obter por ID". 3. No campo "ID da Pessoa" (`personId`), insira o identificador único da pessoa que você deseja consultar. Este valor geralmente é obtido de um gatilho ou de uma etapa anterior do fluxo. *** ### Parâmetros | Campo | Tipo | Obrigatório? | Descrição | | ----------------------- | ------------------ | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | ID da Pessoa | Texto | ✅ Sim | O ID único da pessoa a ser consultada. | | Popular Dados da Pessoa | Booleano (Sim/Não) | ❌ Não | Se definido como `true`, a busca pode retornar dados relacionados adicionais, como informações detalhadas de organizações ou outros registros associados. | Exportar para as Planilhas *** ### Estrutura da Saída (Exemplo de Resultado) Após a execução, o resultado deste bloco será um objeto JSON com a estrutura abaixo, que pode ser acessado em passos seguintes (ex: `{{steps.1.result}}`): JSON ``` { "id": "person_abcdef123456", "name": "Juliana Souza", "about": "Gerente de Marketing na Empresa Exemplo.", "photo_url": "https://example.com/juliana.jpg", "privacy": "granted", "customer_status": "customer", "is_blocked": false, "created_at": "2023-10-26T10:00:00Z", "updated_at": "2024-08-16T15:30:00Z", "users": [ { "id": "user_xyz789", "name": "Carlos Andrade" } ], "phones": [ { "type": "business", "phone": "+5511977775555", "is_whatsapp": true } ], "emails": [ { "email": "juliana.souza@example.com" } ], "custom_fields": { "data_ultima_reuniao": "2024-08-10", "nivel_satisfacao": "Muito Satisfeita" } } ``` *** ### 🚀 Exemplo de Caso de Uso Objetivo: Enviar um e-mail de boas-vindas personalizado para um novo cliente assim que um negócio for marcado como "Ganho". 1. Crie um fluxo com o gatilho "Card Movido", configurado para a etapa "Ganha" do seu funil de vendas. O gatilho fornecerá o `cardId` e o `personId` associado. 2. Adicione o bloco "Pessoas" com a operação "Obter por ID". 3. No campo "ID da Pessoa", insira a variável correspondente do gatilho (ex: `{{trigger.person.id}}`). 4. Adicione um bloco de envio de e-mail na etapa seguinte. 5. No corpo do e-mail, personalize a saudação usando os dados obtidos no passo anterior. Por exemplo: "Olá, `{{steps.2.result.name}}`! Bem-vindo(a) à nossa empresa." Desta forma, você utiliza os dados em tempo real da pessoa para criar uma comunicação muito mais pessoal e eficaz, de forma totalmente automatizada. # Obter Todos Com essa operação, a automação pode obter uma lista completa de pessoas cadastradas dentro do sistema, o que é útil para análise de dados, segmentação ou ações em massa. A operação Obter Todas as Pessoas recupera uma lista de pessoas da sua base de contatos. Por padrão, a lista é paginada para garantir um bom desempenho, mesmo com um grande volume de dados. Esta ação é extremamente versátil, pois permite a aplicação de diversos filtros para segmentar a busca, como buscar por pessoas criadas em um determinado período, com um status específico, associadas a uma organização, entre muitas outras opções. O resultado é uma coleção (array) de objetos, onde cada objeto representa uma pessoa que atende aos critérios de busca. #### Como Configurar 1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação. 2. No campo "Operação", selecione a opção "Obter Todos". 3. Opcionalmente, clique em "Adicionar Filtro" para especificar os parâmetros de busca e refinar seus resultados. *** ### Filtros Disponíveis Você pode combinar os filtros abaixo para criar consultas precisas. | Filtro | Tipo | Descrição | | ------------------------ | --------------- | ------------------------------------------------------------------------------------------------- | | Página (`page`) | Número | O número da página de resultados que você deseja obter. O padrão é 1. | | Limite (`limit`) | Número | A quantidade máxima de pessoas a serem retornadas por página. | | Ordenar por (`order`) | Lista de Opções | Campo pelo qual os resultados serão ordenados. Opções: `created_at`, `updated_at`, `name`. | | Direção da Ordem | Lista de Opções | Define a direção da ordenação. Opções: `asc` (ascendente) ou `desc` (descendente). | | Data de Início | Data/Hora | Retorna pessoas criadas a partir desta data e hora. | | Data de Fim | Data/Hora | Retorna pessoas criadas até esta data e hora. | | Nome | Texto | Filtra pessoas por um nome específico. | | E-mail | Texto | Filtra pessoas por um endereço de e-mail específico. | | Telefone | Texto | Filtra pessoas por um número de telefone específico. | | Busca (`search`) | Texto | Realiza uma busca geral por um termo em vários campos principais da pessoa. | | Busca Completa | Booleano | Se `true`, realiza uma busca mais profunda e abrangente, o que pode levar mais tempo. | | Possui Chaves Duplicadas | Booleano | Se `true`, retorna apenas pessoas que possuem identificadores duplicados (ex: mesmo e-mail). | | Está Bloqueado | Booleano | Filtra pessoas pelo seu status de bloqueio (`true` para bloqueadas, `false` para não bloqueadas). | | Organização | Lista de Opções | Filtra pessoas que pertencem a uma organização específica. | | Campos Personalizados | Chave-Valor | Filtra pessoas com base nos valores de seus campos personalizados. | *** ### Estrutura da Saída (Exemplo de Resultado) A saída deste bloco será um objeto contendo a lista de pessoas e informações de paginação. JSON ``` { "data": [ { "id": "person_abcdef123456", "name": "Juliana Souza", "customer_status": "customer", "created_at": "2024-08-16T15:30:00Z", "emails": [{"email": "juliana.souza@example.com"}] }, { "id": "person_ghijkl789012", "name": "Marcos Almeida", "customer_status": "lead", "created_at": "2024-08-15T11:20:00Z", "emails": [{"email": "marcos.a@example.com"}] } ], "pagination": { "total": 527, "page": 1, "limit": 2 } } ``` *** ### 🚀 Exemplo de Caso de Uso Objetivo: Gerar um relatório semanal com todos os novos leads qualificados e enviá-lo para uma planilha do Google Sheets. 1. Crie um fluxo com um gatilho agendado para ser executado toda segunda-feira às 9h. 2. Adicione o bloco "Pessoas" com a operação "Obter Todos". 3. Configure os seguintes filtros: * Data de Início: Use uma expressão para definir a data para 7 dias atrás. * Data de Fim: Use uma expressão para a data atual. * Status do Cliente: Selecione `sales_qualified_lead`. 4. Adicione um laço (`loop`) para iterar sobre a lista de pessoas retornada (`{{steps.2.result.data}}`). 5. Dentro do laço, adicione um bloco do Google Sheets com a ação "Adicionar Linha" e mapeie os dados de cada pessoa (nome, e-mail, telefone, etc.) para as colunas da sua planilha. Com este fluxo, sua equipe de vendas receberá uma lista atualizada de leads qualificados no início de cada semana, de forma totalmente automática. # Adicionar Telefone Com essa operação, a automação pode adicionar um ou mais números de telefone ao cadastro de uma pessoa, garantindo que todas as informações estejam atualizadas. A operação Adicionar Telefones permite inserir um ou mais números de telefone a um registro de pessoa já existente. Esta ação é especialmente útil para enriquecer o perfil de um contato ao longo do tempo. Se um lead, que inicialmente forneceu apenas o e-mail, informa seu telefone em uma interação posterior, você pode usar esta operação para complementar o cadastro sem sobrescrever outros dados. A operação adiciona os novos telefones à lista de contatos da pessoa, mantendo os que já existiam. #### Como Configurar 1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação. 2. No campo "Operação", selecione a opção "Adicionar Telefones". 3. No campo "ID da Pessoa" (`personId`), insira o identificador único da pessoa a quem você deseja adicionar os telefones. 4. Na seção "Telefones", preencha os detalhes do(s) número(s) que deseja adicionar. *** ### Parâmetros (Usando Campos) | Campo | Tipo | Obrigatório? | Descrição | | ------------ | ----------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ID da Pessoa | Texto | ✅ Sim | O ID único da pessoa que receberá os novos números de telefone. | | Telefones | Coleção de Campos | ✅ Sim | Uma lista contendo um ou mais telefones a serem adicionados. Cada item da lista deve incluir: `Tipo` (Personal ou Business), `Telefone` (o número) e `É WhatsApp?` (sim/não). | Exportar para as Planilhas *** ### Estrutura (Usando JSON) O corpo da requisição JSON deve ser um array chamado `phones`, contendo um ou mais objetos de telefone. JSON ``` { "phones": [ { "type": "business", "phone": "+5511987654321", "is_whatsapp": true }, { "type": "personal", "phone": "+5511912345678", "is_whatsapp": false } ] } ``` *** ### 🚀 Exemplo de Caso de Uso Objetivo: Quando um cliente responde a uma pesquisa de satisfação e fornece seu número de WhatsApp para contato, adicionar esse número ao seu cadastro na Hablla. 1. Crie um fluxo que começa com um gatilho de Webhook, recebendo os dados da pesquisa preenchida (incluindo o e-mail e o novo telefone). 2. Use a operação "Buscar Pessoa por E-mail" para encontrar o `personId` do cliente com base no e-mail recebido. 3. Adicione o bloco "Pessoas" com a operação "Adicionar Telefones". 4. No campo "ID da Pessoa", insira a variável do ID encontrado no passo anterior (`{{steps.2.result.id}}`). 5. Na seção "Telefones", mapeie os dados do telefone recebido no gatilho: * Tipo: Defina como `personal`. * Telefone: Mapeie a variável do telefone vinda do webhook. * É WhatsApp?: Defina como `true`. Desta forma, os perfis dos seus clientes são enriquecidos automaticamente com novas informações de contato, centralizando a comunicação e garantindo que os dados estejam sempre atualizados. # Obter por Telefone Com essa operação, a automação pode localizar o cadastro de uma pessoa no sistema apenas pelo número de telefone. A operação Obter Pessoa por Telefone localiza um registro de pessoa na sua base de contatos utilizando um número de telefone como critério de busca. Esta ação é fundamental para automações que partem de uma interação por telefone ou canais de mensagem, como WhatsApp, SMS ou Telegram. Ao receber uma comunicação, você pode usar o número do remetente para buscar o perfil completo do contato na Hablla e personalizar o restante do fluxo. Se um contato com o telefone especificado for encontrado, a operação retorna o objeto completo da pessoa. Caso contrário, o resultado será vazio. #### Como Configurar 1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação. 2. No campo "Operação", selecione a opção "Obter por Telefone". 3. No campo "Telefone" (`phone`), insira o número de telefone que você deseja usar para a busca. Este valor pode ser um texto fixo ou uma variável vinda de um gatilho. *** ### Parâmetros | Campo | Tipo | Obrigatório? | Descrição | | ------------------ | ----- | ------------ | -------------------------------------------------------------------------------------------------------------------------- | | Telefone (`phone`) | Texto | ✅ Sim | O número de telefone exato da pessoa a ser localizada. Recomenda-se o uso do formato internacional (ex: `+5511999998888`). | Exportar para as Planilhas *** ### Estrutura da Saída (Exemplo de Resultado) Se uma pessoa for encontrada, o resultado será um objeto JSON com a estrutura similar à da operação "Obter por ID". JSON ``` { "id": "person_abcdef123456", "name": "Ricardo Mendes", "customer_status": "opportunity", "is_blocked": false, "created_at": "2023-11-05T14:00:00Z", "phones": [ { "type": "personal", "phone": "+5511999998888", "is_whatsapp": true } ], "emails": [ { "email": "ricardo.mendes@example.com" } ] } ``` *** ### 🚀 Exemplo de Caso de Uso Objetivo: Quando um cliente envia uma mensagem para o WhatsApp da empresa, buscar seu cadastro na Hablla e direcionar a conversa para o vendedor responsável por ele. 1. Crie um fluxo que começa com um gatilho de "Nova Mensagem Recebida" do seu conector de WhatsApp. O gatilho fornecerá o número do remetente (`trigger.sender.phone`). 2. Adicione o bloco "Pessoas" com a operação "Obter por Telefone". 3. No campo "Telefone", insira a variável do número do remetente: `{{trigger.sender.phone}}`. 4. Adicione um bloco de Condição (If) para verificar se uma pessoa foi encontrada (`{{steps.2.result.id}}` não está vazio). * Se Sim: Use a operação "Obter Usuário por ID" para buscar os dados do responsável (`{{steps.2.result.users[0].id}}`) e, em seguida, transfira a conversa para ele. * Se Não: Crie uma nova pessoa com a operação "Criar Pessoa" e direcione a conversa para a fila de triagem geral. Com esta automação, você oferece um atendimento imediato e personalizado, pois o sistema reconhece o cliente e o encaminha para a pessoa certa sem intervenção manual. --- [Next Page](/llms-full.txt/1)