# 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. # Acesso Temporário O **Acesso Temporário** permite conceder acesso administrativo ao seu workspace da Hablla por um período determinado, sem a necessidade de criar ou manter um novo usuário administrador permanentemente no ambiente. Esse recurso é utilizado principalmente quando a equipe da Hablla precisa acessar o workspace para realizar atividades de **suporte, análise técnica, implementação ou execução de serviços contratados**. Ao criar um acesso temporário, você define **quem poderá acessar o workspace, qual a finalidade do acesso e até quando ele permanecerá disponível**. Após a data e o horário definidos, o acesso será expirado. {% hint style="danger" %} **Atenção:** um Acesso Temporário concede ao usuário permissões em **nível de administrador** dentro do seu workspace. Isso significa que, durante o período de vigência, o usuário poderá acessar as mesmas áreas e funcionalidades disponíveis para um administrador do ambiente. Por segurança, recomendamos utilizar esse recurso **somente para conceder acesso a membros oficiais da equipe Hablla** e apenas quando solicitado por meio dos canais oficiais de comunicação. {% endhint %} ### Como conceder um Acesso Temporário Para realizar essa configuração, você precisa possuir **permissão de administrador** no workspace. #### 1. Acesse as configurações do Workspace Dentro do **Studio Hablla**, clique no ícone de **engrenagem**, localizado no canto superior direito da tela.
#### 2. Acesse a opção Acesso Temporário Nas configurações do workspace, localize o menu disponível na lateral esquerda da tela e clique na opção **Acesso Temporário**.
#### 3. Adicione um novo Acesso Temporário Na tela de **Acesso Temporário**, você poderá visualizar todos os acessos temporários cadastrados no seu workspace. Para adicionar um novo acesso: * Clique no botão **+ Adicionar Acesso**, localizado no canto superior direito da tela. * Na janela que será exibida, preencha os campos **Finalidade**, **E-mail do Usuário** e **Expira Em**. * Confira as informações preenchidas. * Clique no botão **Adicionar acesso** para finalizar.
Após concluir essas etapas, o usuário informado já poderá acessar o seu workspace utilizando o Acesso Temporário concedido, respeitando a data e o horário de expiração configurados. ### Entenda os campos do Acesso Temporário Ao adicionar um novo Acesso Temporário, será necessário preencher três informações. Entenda abaixo a finalidade de cada um desses campos. #### Finalidade Nesse campo, você deve informar o motivo pelo qual o acesso está sendo concedido. Recomendamos utilizar uma descrição que permita identificar facilmente, no futuro, **por que aquele acesso foi criado**. Alguns exemplos: * `Análise de atendimento pela equipe de Suporte Hablla` * `Implementação do projeto pela equipe de Serviços Hablla` #### E-mail do Usuário Nesse campo, você deve informar o **e-mail do usuário que deverá receber o Acesso Temporário**. {% hint style="warning" %} Certifique-se de informar exatamente o e-mail fornecido pelo profissional da Hablla que solicitou o acesso. Não conceda Acesso Temporário a endereços desconhecidos ou que não tenham sido previamente confirmados pelos canais oficiais. {% endhint %} #### Expira Em Nesse último campo, você precisa apenas definir a **data e o horário em que o Acesso Temporário deverá expirar**. Utilize o seletor de data para determinar até quando o usuário poderá acessar o workspace. Após a data e o horário configurados, o acesso será automaticamente expirado. {% hint style="info" %} Recomendamos definir um período de acesso compatível com a atividade que será realizada, evitando manter permissões administrativas disponíveis por muito mais tempo do que o necessário. {% endhint %} ### Conclusão Após clicar em **Adicionar acesso**, a permissão será concedida ao e-mail informado e permanecerá disponível até a **data e o horário de expiração definidos**. A partir desse momento, o profissional autorizado poderá acessar o workspace para realizar a atividade necessária. {% hint style="success" %} Após a conclusão da atividade, mantenha somente os acessos que ainda forem necessários. O uso de acessos com prazo definido ajuda a evitar que permissões administrativas permaneçam disponíveis além do período necessário. {% endhint %} # 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:**
*** # Calendários Agrupados Os **Calendários Agrupados** permitem reunir a disponibilidade de múltiplos calendários em um único link de agendamento. Com esse recurso, em vez de compartilhar o calendário individual de um único usuário, você pode disponibilizar um link que considera a **disponibilidade conjunta de vários calendários** pertencentes ao mesmo grupo. Imagine, por exemplo, uma equipe de suporte formada por diferentes atendentes. Caso um deles não possua disponibilidade em determinado horário, mas outro membro da equipe esteja disponível, esse horário poderá continuar sendo apresentado ao cliente por meio do Calendário Agrupado. Dessa forma, o cliente não precisa escolher previamente com qual usuário deseja realizar o agendamento. Ele visualiza as disponibilidades do grupo e pode selecionar um dos horários disponíveis. {% hint style="warning" %} Os **Calendários Agrupados** utilizam calendários que já foram previamente criados e configurados no workspace. Antes de criar um grupo, certifique-se de que os calendários dos usuários que farão parte dele já estejam criados e configurados. Caso precise, você pode acessar a nossa documentação que explica sobre os calendários [clicando aqui](/hablla/configuracoes/calendario). {% endhint %} ### Quando utilizar Calendários Agrupados? Os Calendários Agrupados são especialmente úteis quando diferentes pessoas podem realizar o mesmo tipo de atendimento e você deseja disponibilizar a agenda da equipe por meio de um único link. Alguns exemplos de utilização são: * **Equipe de suporte:** disponibilize os horários de diferentes agentes de suporte em um único calendário. * **Equipe comercial:** permita que leads agendem uma reunião considerando a disponibilidade dos diferentes vendedores. * **Consultorias:** agrupe consultores que realizam o mesmo tipo de reunião ou atendimento. * **Onboarding e implantação:** permita que clientes agendem reuniões considerando a disponibilidade de diferentes profissionais responsáveis pela implantação. * **Atendimentos especializados:** reúna profissionais que podem realizar o mesmo tipo de atendimento em uma única agenda. O objetivo é **aumentar a disponibilidade apresentada ao cliente e centralizar o agendamento**, evitando a necessidade de compartilhar individualmente o calendário de cada usuário. ## Como configurar um Calendário Agrupado Para utilizar esse recurso, primeiro é necessário criar o grupo e, posteriormente, definir quais calendários farão parte dele. ### 1. Acesse as configurações do Workspace Acesse o seu **Studio Hablla** e clique no ícone de **engrenagem**, localizado no canto superior direito da tela, para acessar as configurações do seu workspace. ### 2. Acesse Calendários Agrupados * No menu lateral esquerdo das configurações, localize e clique na opção **Calendários Agrupados**. * Nesta tela serão apresentados todos os grupos de calendários já cadastrados no seu workspace. Caso ainda não exista nenhum grupo configurado, você poderá criar o primeiro clicando no botão **Novo Grupo de Calendário**, localizado no canto superior direito da tela. ### 3. Crie um novo Grupo de Calendário Clique em **Novo Grupo de Calendário**. Uma nova janela será exibida para que você configure as informações do grupo. Preencha os seguintes campos: * **Nome:** defina um nome para identificar o grupo de calendários dentro da Hablla. Por exemplo: `Agenda Suporte`. * **Slug:** defina o identificador que fará parte do endereço utilizado para acessar o Calendário Agrupado. O **Slug** é utilizado na composição do link público do grupo. Por isso, recomendamos utilizar um valor curto e que facilite a identificação do calendário. Por exemplo, utilizando: `agenda-suporte` Esse identificador fará parte do endereço utilizado para acessar o calendário da equipe. {% hint style="info" %} Prefira utilizar no **Slug** palavras simples, sem espaços e separadas por hífen. Por exemplo: `agenda-suporte`, `time-comercial` ou `consultoria`. {% endhint %} Após preencher os campos **Nome** e **Slug**, clique em **Salvar** para criar o grupo.
## Adicionando calendários ao grupo Após criar o grupo, será necessário definir quais calendários farão parte dele. ### 4. Acesse o Grupo de Calendário Na tela de **Calendários Agrupados**, localize e acesse o grupo criado na etapa anterior clicando sobre ele. Ao acessar o grupo, serão exibidos os calendários que atualmente fazem parte dele. ### 5. Adicione os calendários * Para incluir um novo calendário no grupo, clique no botão **Adicione Calendário** no canto superior direito da tela. * Na janela que irá se abrir, selecione o calendário que deseja incluir no grupo. * Após selecionar o calendário desejado, clique em **Salvar**. Repita o procedimento para adicionar os demais calendários que deverão compartilhar suas disponibilidades por meio desse grupo.
{% hint style="info" %} Caso um calendário não deva mais fazer parte do grupo, você também poderá removê-lo posteriormente. Dessa forma, é possível manter os participantes do Calendário Agrupado atualizados conforme a composição da sua equipe. {% endhint %} ## Tudo pronto! Após adicionar os calendários desejados, o seu **Calendário Agrupado** estará configurado. A partir desse momento, você poderá compartilhar o link do grupo com seus clientes para que eles visualizem, em um único local, os horários disponíveis considerando os calendários adicionados ao grupo. Por exemplo: ```mermaid flowchart LR A["Calendário - Ana"] --> D["Calendário Agrupado"] B["Calendário - Bruno"] --> D C["Calendário - Carlos"] --> D D --> E["Link de Agendamento"] E --> F["Cliente"] ``` Assim, caso um dos usuários não possua disponibilidade para determinado horário, o Calendário Agrupado poderá apresentar a disponibilidade dos demais calendários participantes do grupo. {% hint style="success" %} Com os **Calendários Agrupados**, você pode disponibilizar a agenda de uma equipe através de um único link, centralizando as disponibilidades e oferecendo mais opções de horários para seus clientes. {% endhint %} # Censura de Palavras O recurso de **Censura de Palavras** permite definir regras para bloquear automaticamente o uso de palavras, frases ou termos sensíveis nas comunicações realizadas por sua equipe de usuários pela Hablla. Quando uma mensagem contém um termo que faz parte da lista de censura, o envio é bloqueado e o sistema solicita imediatamente ao usuário que corrija o conteúdo da mensagem antes de prosseguir. O recurso pode ser aplicado tanto às **mensagens enviadas pelos usuários** quanto aos **templates**, ajudando a manter um padrão de comunicação e evitando o uso de termos inadequados ou não permitidos pela sua operação. ## Como configurar a Censura de Palavras ### 1. Acesse as configurações do Workspace Dentro do **Studio Hablla**, clique no ícone de **engrenagem**, localizado no canto superior direito da tela. No menu lateral das configurações, localize e clique na opção **Censura de palavras**.
### 2. Ative a Censura de Palavras Na parte superior da tela, habilite a chave **Ativar censura**. Essa configuração é responsável por habilitar o recurso no workspace. Após ativá-la, você poderá definir quais regras de censura serão utilizadas.
### 3. Utilize a lista de censura da Hablla Na seção **Configurações**, você encontrará a opção **Censura Hablla**. Ao habilitar essa opção, a plataforma passa a utilizar uma lista padrão com **mais de 1.000 palavras e termos sensíveis**, que serão bloqueados automaticamente sem a necessidade de cadastrá-los individualmente.
### 4. (Opcional) Adicione palavras personalizadas Além da lista padrão da Hablla, você também pode definir palavras ou frases específicas que não devem ser utilizadas nas comunicações do seu workspace. Na seção **Gerenciar palavras**: * Digite a palavra ou frase que deseja censurar. * Clique em **+ Adicionar palavra**. * Repita o processo para adicionar outros termos, caso necessário. Os termos adicionados serão exibidos na própria tela e passarão a fazer parte das regras de censura do workspace.
## O que acontece quando uma palavra é censurada? Quando um usuário tentar enviar uma mensagem contendo uma palavra ou frase bloqueada pelas regras de censura, a Hablla **impedirá o envio da mensagem**. O usuário deverá então corrigir ou remover o conteúdo censurado antes de realizar uma nova tentativa de envio. #### Exemplo de como aparece o Modal de Solicitar Correção de Mensagem ao Usuário
{% hint style="info" %} Você pode utilizar a **Censura Hablla** para aplicar a lista padrão de termos sensíveis e, simultaneamente, adicionar termos específicos da sua operação através da seção **Gerenciar palavras**. {% endhint %} # 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. # 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). # 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.** # 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. # 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. # Feriados ## Feriados O recurso de **Feriados** permite cadastrar datas específicas em que sua operação estará indisponível, mesmo que essas datas estejam dentro do horário de funcionamento normalmente configurado. Ele pode ser utilizado tanto para **feriados nacionais, estaduais ou municipais** quanto para outras datas especiais em que sua operação não realizará atendimentos. Por exemplo, imagine que sua operação funcione normalmente de **segunda a sexta-feira, das 09h às 18h**. Caso exista um feriado em uma quarta-feira, você poderá cadastrar essa data para que a Hablla considere aquele dia como **fora do horário de trabalho**, mesmo que normalmente houvesse atendimento naquele período. > **Importante** > > O cadastro de um feriado, por si só, **não altera o funcionamento dos seus fluxos**. > > Para que as datas cadastradas sejam consideradas, o fluxo deverá utilizar o componente **Horário de Trabalho** e a opção de validação de **Feriados** deverá estar habilitada nas configurações desse componente. ### Quando utilizar os Feriados? Além dos feriados convencionais, o recurso pode ser utilizado para representar qualquer data excepcional em que sua operação não estará disponível. Alguns exemplos: * Feriados nacionais; * Feriados estaduais ou municipais; * Recessos; * Datas comemorativas em que não haverá expediente; * Folgas coletivas; * Outras datas específicas de indisponibilidade da operação. O recurso é especialmente útil quando a indisponibilidade ocorre em um dia que **normalmente faria parte do seu horário de trabalho**. Por exemplo, se sua operação já não funciona aos sábados e domingos, geralmente não será necessário cadastrar um feriado que aconteça durante o final de semana, pois o componente de Horário de Trabalho já consideraria esse período como fora do expediente. ## Como cadastrar um Feriado ### 1. Acesse as configurações de Feriados Dentro do **Studio Hablla**, clique no ícone de **engrenagem**, localizado no canto superior direito da tela, para acessar as configurações do seu workspace. No menu lateral esquerdo, localize e clique na opção **Feriados**.
### 2. Adicione um novo Feriado Na tela de **Feriados**, clique no botão **+ Adicionar Feriado**, localizado no canto superior direito. Uma nova janela será exibida com três campos para configuração: * **Nome do Feriado** * **Descrição** * **Data** #### Nome do Feriado Informe um nome que permita identificar facilmente a data cadastrada. Por exemplo: `Independência do Brasil` O nome também poderá ser utilizado em implementações mais avançadas dentro dos Fluxos de Automação. Dessa forma, é possível, por exemplo, criar mensagens dinâmicas informando ao cliente o motivo pelo qual não haverá atendimento naquele dia. > **Exemplo** > > "Devido ao feriado da Independência do Brasil, não teremos atendimento hoje. Retornaremos no próximo dia útil." A utilização dinâmica dessas informações requer conhecimentos sobre **Variáveis e Expressões nos Fluxos de Automação** que você pode validar [clicando aqui](/fluxos-de-automacoes/usando-variaveis). #### Descrição Utilize esse campo para adicionar informações complementares que facilitem a identificação da data cadastrada. Por exemplo: `Feriado Nacional` ou `Feriado Municipal`. #### Data Selecione a **data em que sua operação estará indisponível**. Após preencher os três campos, clique em **Salvar**.
Pronto! A data estará cadastrada nas configurações do seu workspace. ## Utilizando os Feriados nos Fluxos Para que os feriados cadastrados sejam efetivamente considerados pela sua automação, o fluxo deverá utilizar o componente **Horário de Trabalho**. Nas configurações desse componente, habilite a opção responsável por considerar os **Feriados**.
A partir dessa configuração, sempre que o componente for executado, a Hablla verificará: 1. Se o momento da execução está dentro do horário de trabalho configurado; 2. Se a data atual corresponde a algum dos feriados cadastrados. Quando a data estiver cadastrada como feriado, o componente considerará aquele momento como **fora do horário de trabalho**, mesmo que o dia e o horário normalmente façam parte do expediente. ```mermaid flowchart LR A["Fluxo"] --> B["Horário de Trabalho"] B --> C{"É um feriado?"} C -->|"Não"| D["Dentro do horário"] C -->|"Sim"| E["Fora do horário"] ``` O fluxo seguirá, então, pela saída correspondente a **Fora do Horário de Trabalho**, permitindo definir o comportamento adequado para aquele período. > **Atenção** > > Lembre-se de que os feriados cadastrados nas configurações do workspace **somente serão considerados nos fluxos em que a validação de Feriados estiver habilitada no componente Horário de Trabalho**. ### Tudo pronto! Com essa configuração, você poderá manter seu horário de funcionamento padrão e cadastrar apenas as **exceções de calendário** da sua operação. Quando chegar uma das datas cadastradas, os fluxos configurados para considerar feriados reconhecerão automaticamente a indisponibilidade e seguirão pela saída de **Fora do Horário de Trabalho**. # Fila de distribuição As **Filas de Distribuição** permitem automatizar a seleção de um item dentre um conjunto previamente configurado, utilizando regras de distribuição definidas por diferentes algoritmos. Atualmente, esse recurso pode ser utilizado em **Fluxos de Automação** dentro do seu workspace na Hablla permitindo selecionar automaticamente um item da fila durante a execução do fluxo. Essas filas podem ser utilizadas em diversos cenários dentro da Hablla, como a distribuição de atendimentos entre atendentes, definição automática do responsável por um cartão, roteamento entre organizações, seleção de pessoas cadastradas ou qualquer outro processo que necessite escolher um item de forma automática e padronizada. Cada fila de distribuição criada é composta pelos seguintes componentes: 1. #### Conjunto de Itens da Fila *O conjunto de itens serão **as opções disponíveis** para que o algoritmo de distribuição possa selecionar um desses itens.* 2. #### Algoritmo de distribuição *O algoritmo é responsável por determinar qual será o próximo item selecionado sempre que a fila for utilizada.* Dessa forma, as Filas de Distribuição tornam os processos mais flexíveis, eliminam distribuições manuais e garantem que a lógica de seleção seja aplicada de forma consistente em toda sua operação. ## O que é o Algoritmo de Transbordo O **Algoritmo de Transbordo** é responsável por definir a lógica utilizada pelo sistema para selecionar o próximo item de uma fila. Sempre que uma fila de distribuição for acionada dentro de um fluxo, o sistema analisa os itens disponíveis e utiliza o algoritmo configurado para determinar qual deles será selecionado naquela execução. ### Algoritmos de Transbordo Atualmente, o **algoritmo de transbordo** conta com 6 opções disponíveis, sendo elas: Fila Sequencial, Menor quantidade de atendimentos no dia, Menor quantidade de atendimentos abertos, Menor quantidade de atendimentos abertos com limite, Aleatório e Peso por Atendentes. A seguir, explicamos um pouco sobre cada uma delas. ### Fila Sequencial A fila sequencial, realiza a distribuição seguindo uma sequência entre os itens cadastrados na fila. Por exemplo, considerando uma fila com as opções: 1. Ana 2. Bruno 3. Carlos As execuções serão distribuídas seguindo a ordem: ```mermaid --- config: theme: base themeVariables: primaryColor: "#893fff" primaryBorderColor: "#893fff" primaryTextColor: "#FFFFFF" lineColor: "#0057B8" --- flowchart LR A([Ana]) --> B([Bruno]) B --> C([Carlos]) C --> A ``` Esse algoritmo é indicado quando se deseja realizar uma distribuição uniforme seguindo uma ordem contínua. ### Menor Quantidade de Atendimentos no dia Responsável por selecionar o usuário que possuir a **menor quantidade de atendimentos recebidos no dia**. Nesse algoritmo, antes de realizar a distribuição, a Hablla compara a quantidade de atendimentos que cada usuário da fila recebeu e seleciona aquele que possuir o menor número. Esse modelo ajuda a equilibrar a distribuição ao longo do dia. ### Menor quantidade de atendimentos abertos Responsável por considera a quantidade de **atendimentos atualmente em aberto** com cada usuário. Desse modo, o próximo atendimento é direcionado para o usuário que possuir a menor quantidade de atendimentos em andamento no momento em que a fila com esse algoritmo for acionada. Esse algoritmo é útil para equilibrar a carga de trabalho atual da equipe. ### Menor quantidade de atendimentos abertos com limite {% hint style="info" %} **Importante:** este algoritmo funciona **apenas para usuários que utilizam uma Permissão Personalizada com limite de atendimentos definido**. Usuários que utilizam as permissões padrão da plataforma não terão o limite de atendimentos considerado durante a distribuição. {% endhint %} Funciona de forma semelhante à opção **Menor quantidade de atendimentos em aberto**, porém também considera o **limite máximo de atendimentos** permitido para cada usuário. Antes de realizar a distribuição, a Hablla verifica quais usuários possuem a menor quantidade de atendimentos em aberto no momento em que a fila é executada e, em seguida, valida se eles ainda não atingiram o limite configurado na permissão. Caso um usuário já tenha alcançado esse limite, ele deixa de participar da distribuição até voltar a possuir capacidade para receber novos atendimentos. O limite de atendimentos por usuário é definido por meio das **Permissões**, na configuração da permissão que será atribuída ao usuário. Para saber como configurar esse limite, consulte a documentação das **Permissões** [clicando aqui](/hablla/configuracoes/permissoes#atendimentos). ### Aleatório Seleciona um dos itens cadastrados na fila de forma aleatória sempre que a fila for utilizada. Nesse algoritmo, todos os itens participantes possuem a mesma probabilidade de serem selecionados, sem considerar qualquer critério de distribuição. Esse algoritmo é indicado para cenários em que não há necessidade de manter uma sequência ou balancear a carga de trabalho entre os participantes, sendo a escolha realizada de forma randômica a cada execução. ### Peso por atendente {% hint style="warning" %} Para utilizar este algoritmo, é necessário configurar o **nível de prioridade** de cada usuário participante da fila. Caso nenhum peso seja configurado, a distribuição pode não ocorrer conforme o esperado. {% endhint %} Permite distribuir os itens da fila de forma proporcional entre os usuários, utilizando um **peso** configurado para cada um deles. Quanto maior o peso atribuído a um usuário, maior será a frequência com que ele será selecionado durante as distribuições. Esse algoritmo é indicado para equipes em que alguns usuários possuem maior capacidade de atendimento ou que precisam receber um volume maior de demandas em relação aos demais. #### Exemplo
UsuáriosNível de Prioridade
Ana1
Bruno2
Carlos1
Nesse cenário, o usuário **Bruno** tende a receber aproximadamente o dobro de distribuições em comparação com Ana e Carlos, enquanto Ana e Carlos recebem distribuições na mesma proporção. {% hint style="info" icon="triangle-exclamation" %} Para saber como realizar essa configuração, consulte o guia prático em nossa documentação para saber como configurar os níveis de prioridade de atendimento dos usuários [clicando aqui. ↗️](/hablla/configuracoes/permissoes#atendimentos) {% endhint %} ## Como Configurar as Filas de Distribuição Para criar as suas próprias filas de distribuição, você primeiro precisará ter um usuário **administrador** para poder acessar as configurações do seu workspace. {% stepper %} {% step %} ### Acesse as configurações do seu Workspace Após acessar o seu [studio](https://studio.hablla.com/), para acessar as configurações do workspace, clique no ícone da **engrenagem** no canto **superior direito** da sua tela.
{% endstep %} {% step %} ### Acesse as configurações de Filas de Distribuição Ao acessar as configurações do seu workspace, localize no menu lateral na parte esquerda da sua tela a opção "**Filas de Distribuição**" e clique sobre ela.
{% endstep %} {% step %} ### Crie uma nova fila de distribuição Ao acessar as configurações das **filas de distribuição**, você provavelmente não terá ainda uma fila criada. Para criar uma nova fila, basta clicar no botão "**+ Nova Fila de Distribuição**" na lateral superior direita da nova tela que vai se abrir.
Após clicar surgirá uma nova tela de configuração da fila que você irá criar com 3 campos para serem definidos: **Nome de Exibição da Fila**, **Algoritmo de Transbordo**, e **Tipo da Fila**. {% endstep %} {% step %} ### **Defina o Nome de Exibição da sua Fila** Nessa etapa você deve criar um nome de exibição para a sua fila de distribuição.
{% endstep %} {% step %} ### **Defina o Algoritmo de Transbordo da sua Fila** Agora você precisa selecionar uma das opções de **Algoritmos de Transbordo** disponíveis para a definição do tipo de Algoritmo que será utilizado para a sua nova fila.
{% endstep %} {% step %} ### **Defina o Tipo da Fila da sua Fila** Aqui você deve selecionar uma das opções de **Tipos de Fila** disponíveis para definir qual será o tipo da sua nova fila de distribuição.
{% endstep %} {% step %} ### Salve as configurações Agora basta apenas clicar no botão **Salvar** para efetivar as suas configurações da Fila de Distribuição. {% endstep %} {% endstepper %} As **Filas de Distribuição** oferecem uma forma simples e flexível de automatizar a seleção de itens dentro da Hablla, permitindo que a distribuição siga regras consistentes e adaptadas as necessidades da sua operação. Ao escolher corretamente o **Tipo da Fila** e o **Algoritmo de Transbordo**, é possível distribuir atendimentos, definir responsáveis, realizar roteamentos e automatizar diversos processos sem a necessidade de decisões manuais durante a execução dos fluxos. Após criar e configurar sua fila de distribuição, ela ficará disponível para utilização nos **Fluxos de Automação** do seu workspace, podendo ser reutilizada sempre que necessário. {% hint style="success" %} **Próximo passo:** Agora que sua fila está configurada, consulte a documentação de **Fluxos de Automação** para aprender como utilizar uma Fila de Distribuição durante a execução de um fluxo, [clicando aqui ↗️](/fluxos-de-automacoes/gestao-de-fluxos/como-utilizar-as-filas-de-distribuicao-em-fluxo) {% endhint %} # Gerenciamento 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. \
# 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! # 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. # 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. # Ramais O recurso de **Ramais** permite configurar e gerenciar os usuários que poderão realizar e receber chamadas através do módulo de Telefonia da Hablla. Cada usuário responsável por atendimentos de voz pode possuir um ramal associado. Dessa forma, as chamadas podem ser **distribuídas automaticamente entre os usuários disponíveis** ou transferidas de um atendente para outro durante um atendimento. {% hint style="warning" %} **Importante:** o recurso de Ramais está disponível para operações que utilizam o **módulo de Telefonia da Hablla**. Antes de configurar um ramal, é necessário possuir uma conexão de telefonia previamente configurada no seu workspace. Para saber mais sobre a configuração e utilização da Telefonia, consulte nossa documentação [**clicando aqui**](/hablla/configuracoes/conexoes-e-integracoes/phone). {% endhint %} ### Como funcionam os Ramais? O Ramal é o identificador único de um usuário habilitado para realizar e receber chamadas telefônicas na operação. Os ramais também podem participar da distribuição automática de atendimentos, de acordo com as regras do **algoritmo de transbordo** configurados para o setor. O próprio usuário poderá controlar sua disponibilidade para Telefonia dentro do ambiente da Hablla, dessa forma ele pode definir quando está **disponível** ou **indisponível** para recebimento e/ou transferências de chamadas. #### Principais Funcionalidades * **Transferência de Chamadas**: Permite transferir ligações diretamente entre agentes habilitados e disponíveis. > *Exemplo:* Se o cliente solicitar falar com outro colaborador, a ligação poderá ser transferida caso o destinatário possua um ramal ativo e status disponível. * **Distribuição Automática**: Os ramais são integrados ao algoritmo de transbordo do setor, recebendo e distribuindo chamadas automaticamente de acordo com as regras configuradas. * **Controle de Disponibilidade**: O próprio usuário consegue gerenciar seu status de atendimento no painel da Hablla, controlando o recebimento e a transferência de chamadas. ### Como configurar um Ramal {% stepper %} {% step %} ### 1. Acesse as configurações de Ramais Dentro do **Studio Hablla**, clique no ícone de **engrenagem**, localizado no canto superior direito da tela, para acessar as configurações do seu workspace. No menu lateral esquerdo, localize e clique na opção **Ramais**.
{% endstep %} {% step %} ### 2. Adicione um novo Ramal Na tela de **Ramais**, clique no botão **+ Adicionar Ramal**, localizado no canto superior direito. Após clicar, uma nova janela será exibida para que você configure as informações do ramal. {% endstep %} {% step %} ### 3. Configure o Ramal Para criar o ramal, preencha as informações apresentadas na tela. #### **Descrição** Defina um nome que facilite a identificação do ramal. Recomendamos utilizar uma descrição que contenha o **nome do usuário e o número do ramal**. Dessa forma, fica mais fácil identificar posteriormente a quem aquele ramal pertence. > Exemplo: **`Tomaz [0133]`**. #### **Ramal** Informe o número que será utilizado para identificar aquele ramal. Recomendamos utilizar uma numeração padronizada entre os usuários da sua operação. Ramais com **quatro dígitos** são uma convenção comum e facilitam a organização, como `1001`, `1002`, `1003` e assim por diante. > Exemplo: **`0133`**. Recomendamos utilizar uma numeração padronizada entre os usuários da sua operação. Ramais com **quatro dígitos** são uma convenção comum e facilitam a organização, como `1001`, `1002`, `1003` e assim por diante. #### **Tipo** Defina como o usuário utilizará o ramal. Atualmente, a configuração pode utilizar os tipos **Web** ou **Device**. * **Web:** permite que o usuário realize e receba chamadas diretamente pelo ambiente da Hablla, utilizando o próprio navegador. Essa será a opção utilizada no nosso exemplo. * **Device:** destinado a cenários em que a operação utiliza um dispositivo físico de telefonia associado ao ramal. {% hint style="info" %} Para realizar configurações utilizando o tipo **Device**, recomendamos entrar em contato com nossa equipe de Suporte para receber auxílio durante a configuração. **Fale com nosso suporte** [**clicando aqui**](https://wa.me/558000001351)**.** {% endhint %} #### **Usuário** Selecione o **usuário que será proprietário daquele ramal**. É através dessa associação que a Hablla identifica qual usuário deverá utilizar o ramal para realizar e/ou receber chamadas. {% endstep %} {% step %} ### 4. Adicione uma Conexão Depois de definir as configurações do ramal e selecionar o usuário, será necessário associar uma **Conexão de Telefonia**. Na seção **Configurações de Conexões**, clique em **+ Adicionar Conexão**. Serão apresentados os campos necessários para definir qual conexão será utilizada pelo ramal. **Conexão** Selecione uma das **Conexões de Telefonia configuradas no seu workspace**. Essa conexão será responsável por permitir que o ramal utilize a estrutura de telefonia configurada na Hablla. {% hint style="warning" icon="triangle-exclamation" %} Caso nenhuma conexão esteja disponível para seleção, verifique primeiro se a Telefonia já foi configurada corretamente no seu workspace. {% endhint %} **Tipo de Conexão** Defina quais operações o ramal poderá realizar utilizando aquela conexão. De acordo com a necessidade da sua operação, você poderá configurar a conexão para: * **Realizar chamadas:** utilizada para chamadas de saída; * **Receber chamadas:** utilizada para chamadas de entrada; * **Realizar e receber chamadas:** permite utilizar a conexão tanto para chamadas de entrada quanto de saída. Escolha a opção de acordo com a finalidade daquele ramal. {% endstep %} {% step %} ### 5. Salve o Ramal Após finalizar todas as configurações, clique no botão **Salvar** e pronto! O ramal estará associado ao usuário selecionado e configurado.
{% endstep %} {% endstepper %} ### Disponibilidade para chamadas Após a criação do ramal, o usuário associado poderá controlar sua **disponibilidade para chamadas** diretamente no ambiente da Hablla. #### Atualize o ambiente do usuário Caso o usuário para o qual o ramal foi configurado **já esteja com a Hablla aberta no momento da configuração**, será necessário realizar um **recarregamento forçado da página** para que a opção de disponibilidade para chamadas seja apresentada. Para isso, utilize o atalho: **`Ctrl + Shift + R`** Esse comando força o navegador a recarregar a página e atualizar os recursos utilizados pela Hablla. #### Acesse o status de disponibilidade Após atualizar a página, clique no **botão roxo com o ícone de seta**, localizado na lateral esquerda da tela, para expandir a área onde ficam centralizados os atendimentos do usuário. Na parte inferior dessa área, serão apresentadas as opções de disponibilidade para os diferentes tipos de atendimento: * **Mensagens:** controla a disponibilidade do usuário para atendimentos de mensageria; * **Chamadas:** controla a disponibilidade do usuário para atendimentos de telefonia. Na opção **Chamadas**, o usuário poderá alterar seu status entre **Disponível** e **Indisponível**.
#### Disponível Quando o usuário estiver **Disponível para chamadas**, seu ramal estará apto a receber novas ligações e transferências realizadas por outros atendentes. #### Indisponível Quando o usuário estiver **Indisponível para chamadas**, seu ramal não estará disponível para receber novas ligações e/ou transferências de chamadas. {% hint style="warning" icon="triangle-exclamation" %} **Importante:** para que uma chamada seja direcionada ou transferida para determinado usuário, ele deverá possuir um ramal corretamente configurado e estar com o status **Disponível** em **Chamadas**. {% endhint %} ### Tudo pronto! Com o ramal configurado e o usuário disponível para chamadas, ele poderá participar normalmente da sua operação de Telefonia na Hablla. A partir dessa configuração, as chamadas poderão ser direcionadas aos usuários disponíveis conforme as regras da sua operação, além de permitir a **transferência de ligações entre atendentes** quando necessário. # Repositório (RPO) Em breve O **Repositório (RPO)** é um recurso da Hablla destinado ao armazenamento e gerenciamento de **Classes e Scripts em JavaScript** que podem ser utilizados nas automações do seu workspace. Seu principal objetivo é permitir que lógicas mais complexas sejam **centralizadas e reutilizadas**, evitando que uma mesma implementação precise ser construída e mantida individualmente em diferentes fluxos. {% hint style="warning" %} O **Repositório (RPO) é um recurso avançado**, destinado principalmente a usuários que possuem conhecimentos em **JavaScript, APIs, integrações entre sistemas e desenvolvimento**. Caso você não possua conhecimento técnico nessas áreas, recomendamos que a criação ou alteração de Classes e Scripts seja realizada por uma pessoa qualificada. {% endhint %} ### Quando utilizar o RPO? O RPO é especialmente útil quando uma mesma lógica precisa ser utilizada em diferentes pontos da sua operação. Um exemplo comum são as **integrações com sistemas externos**. Imagine que diferentes fluxos precisam consultar ou enviar informações para um mesmo sistema. É possível construir toda a lógica necessária individualmente dentro de cada fluxo. Porém, conforme a quantidade de automações aumenta, essa abordagem também aumenta a complexidade de manutenção. Sem uma lógica centralizada, poderíamos ter um cenário como: ```mermaid flowchart LR A["Fluxo A"] --> D["Integração"] B["Fluxo B"] --> E["Integração"] C["Fluxo C"] --> F["Integração"] ``` Nesse cenário, caso alguma regra da integração seja alterada, poderá ser necessário atualizar individualmente cada um dos fluxos que possuem aquela implementação. Utilizando o RPO, determinadas lógicas podem ser centralizadas e posteriormente reutilizadas pelas automações que precisarem delas: ```mermaid flowchart LR A["Fluxo A"] --> RPO1["RPO"] B["Fluxo B"] --> RPO2["RPO"] C["Fluxo C"] --> RPO3["RPO"] RPO1 --> INT["Integração"] RPO2 --> INT RPO3 --> INT ``` Dessa forma, parte da lógica pode ser mantida em um único local e reutilizada em diferentes processos. Alguns cenários em que o RPO pode ser utilizado incluem: * Integrações com sistemas externos; * Consultas e envio de informações através de APIs; * Tratamento e transformação de dados; * Reutilização de regras ou lógicas entre diferentes fluxos; * Centralização de funcionalidades utilizadas por diferentes automações. ### Classes e Scripts Dentro do **Repositório (RPO)**, você encontrará duas áreas principais: **Minhas Classes** e **Meus Scripts**. #### Classes As **Classes** permitem organizar funcionalidades que poderão ser reutilizadas em diferentes automações. Uma Classe pode concentrar diferentes ações relacionadas a uma mesma finalidade. Em uma integração com um sistema externo, por exemplo, uma única Classe poderia concentrar funcionalidades responsáveis por consultar, criar ou atualizar informações. Dessa forma, diferentes fluxos podem utilizar essas funcionalidades sem a necessidade de reproduzir toda a implementação individualmente. #### Meus Scripts A seção **Meus Scripts** permite armazenar códigos JavaScript destinados à execução de lógicas ou ações específicas dentro das automações. Enquanto as Classes são especialmente úteis para organizar e reutilizar conjuntos de funcionalidades, os Scripts podem ser utilizados para armazenar implementações mais direcionadas a uma determinada ação.
RecursoQuando utilizar
ClassesQuando uma lógica ou conjunto de funcionalidades precisa ser organizado e reutilizado em diferentes automações.
ScriptsQuando é necessário armazenar um código JavaScript destinado a uma ação ou lógica específica.
{% hint style="danger" %} **Tenha cuidado ao alterar códigos existentes no RPO.** Classes e Scripts podem ser utilizados por diferentes automações do seu workspace. Por esse motivo, uma alteração incorreta em um código compartilhado pode afetar **diversos fluxos e processos da sua operação simultaneamente**. Se você não conhece a finalidade de uma Classe ou Script existente, não recomendamos realizar alterações ou testes diretamente nesse código. {% endhint %} ## Como acessar o Repositório (RPO) ### 1. Acesse as configurações do Workspace Dentro do **Studio Hablla**, clique no ícone de **engrenagem**, localizado no canto superior direito da tela. ### 2. Acesse o Repositório (RPO) No menu lateral esquerdo das configurações, localize e clique na opção **Repositório (RPO)**.
Ao acessar o repositório, você encontrará as duas áreas disponíveis: * **Minhas Classes:** apresenta as Classes cadastradas no seu workspace; * **Meus Scripts:** apresenta os Scripts JavaScript armazenados no workspace. ## Criando uma Classe no RPO (Avançado) {% hint style="warning" %} A criação e edição de Classes requer conhecimento em **JavaScript e desenvolvimento de software**. Esta documentação apresenta o funcionamento do recurso e as regras necessárias para utilização das Classes no RPO, mas não tem como objetivo ensinar programação ou desenvolvimento em JavaScript. {% endhint %} ### 1. Crie uma nova Classe Na área de **Minhas Classes** do Repositório (RPO), crie uma nova Classe clicando no botão **+ Nova classe** e informe um nome para identificá-la. Ao terminar de digitar o nome da Classe, o sistema adicionará automaticamente o prefixo "**W\_**" ao nome informado e transformará a primeira letra em maiúsculo. Por exemplo, se você informar: "**`teste`**" A Hablla definirá o nome da Classe como: "**`W_Teste`**" ### 2. Utilize o nome gerado pela Hablla no código O nome apresentado pela Hablla após a definição do nome da Classe deverá ser considerado na sua implementação JavaScript. Por exemplo, se você informou inicialmente: "**`teste`**" e a Hablla registrou a Classe como: "**`W_Teste`**" A declaração da Classe no código deverá utilizar esse mesmo nome: ```javascript class W_Teste { // ... } ``` Portanto:
EtapaNome
Nome informado na criaçãoteste
Nome gerado pela HabllaW_Teste
Nome declarado no códigoW_Teste
#### Vídeo demonstrativo de como criar uma classe.
{% hint style="warning" %} O **nome declarado no código deve corresponder ao nome final apresentado pela Hablla**. O prefixo `W_` e a transformação da primeira letra em maiúsculo são transformados automaticamente pela plataforma ao definir o nome, mas deverá estar presente na declaração da Classe dentro do código. {% endhint %} ### 3. Publique a Classe Após finalizar a criação e conferir o código da sua Classe, é necessário **publicá-la** para que ela fique disponível para utilização no workspace. Para isso, clique no botão "**Publicar minhas classes**", localizado no canto superior direito do da seção Minhas Classes. Ao clicar nesse botão, confirme a ação digitando a palavra de confirmação para prosseguir e por fim clique em "**Confirmar**" para aplicar as alterações realizadas. > **⚠️ Importante** > > Sempre que você realizar uma alteração no código de uma Classe, será necessário **publicá-la novamente** para que a nova versão fique disponível para utilização. ### Classes podem utilizar outras Classes Uma Classe armazenada no RPO também pode utilizar funcionalidades disponibilizadas por outra Classe existente no mesmo ambiente. Isso permite dividir responsabilidades e reaproveitar funcionalidades sem precisar repetir a mesma implementação. Por exemplo, uma Classe responsável por cobranças poderia utilizar outra Classe responsável exclusivamente pela autenticação com o sistema externo: ```mermaid flowchart LR A["Fluxo"] --> B["Classe de Cobranças"] B --> C["Classe de Autenticação"] C --> D["Sistema Externo"] ``` Essa estrutura facilita a reutilização de funcionalidades, mas também cria uma **dependência entre as Classes**. {% hint style="danger" %} **Antes de editar ou excluir uma Classe, verifique se ela é utilizada por outras Classes e/ou fluxos de automações do workspace.** Uma Classe pode funcionar como dependência de outras implementações. Portanto, uma alteração pode afetar outros códigos e fluxos mesmo que a Classe não pareça estar sendo utilizada diretamente. {% endhint %} ## Boas práticas ao utilizar o RPO Por se tratar de um recurso avançado e capaz de impactar diferentes automações, recomendamos alguns cuidados durante sua utilização: * Utilize o RPO somente se possuir conhecimento técnico suficiente para compreender o código que está sendo implementado ou alterado; * Antes de alterar uma Classe ou Script existente, verifique onde aquele recurso está sendo utilizado; * Evite realizar testes diretamente em códigos utilizados por automações em produção; * Utilize nomes que facilitem a identificação da finalidade das Classes e Scripts; * Considere as dependências entre Classes antes de realizar alterações ou exclusões; * Sempre que possível, valide alterações antes de utilizá-las em processos críticos da operação. {% hint style="info" %} Caso sua operação necessite de uma implementação no RPO e sua equipe não possua conhecimento técnico para desenvolvê-la, recomendamos que a configuração seja realizada por um **profissional com experiência em JavaScript, APIs e integrações entre sistemas**. {% endhint %} # 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.**
# 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 %} # 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. # 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. # 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. # Link na Bio O **Link na Bio** permite criar uma página personalizada para centralizar seus principais links, canais e pontos de contato em um único endereço. Com ele, você pode reunir conteúdos importantes da sua marca em uma página própria e compartilhar um único link na **bio do Instagram, redes sociais, campanhas, anúncios ou outros canais digitais**. Em vez de direcionar seu público para apenas um destino, você pode criar uma página completa com diferentes opções de acesso, facilitando a conexão das pessoas com os principais canais, conteúdos e serviços da sua marca. Quer visualizar um exemplo na prática? Confira o **Link na Bio da Hablla** [clicando aqui](https://bio.hablla.io/hablla). #### Uma página. Vários destinos. Utilize o Link na Bio como um ponto central para conectar seu público aos canais mais importantes da sua operação. Você pode utilizá-lo para destacar, por exemplo: * Seu site ou loja virtual; * WhatsApp e outros canais de atendimento; * Redes sociais; * Produtos, serviços ou páginas específicas; * Campanhas e promoções; * Formulários e páginas de captura; * Conteúdos e materiais importantes. Dessa forma, sua marca mantém **um único endereço para divulgação**, enquanto possui liberdade para organizar e atualizar os diferentes destinos apresentados ao seu público sempre que necessário. ### Personalize a experiência da sua marca Além de centralizar seus principais links, você pode personalizar a página para criar uma experiência mais alinhada à identidade da sua marca. Durante a edição, a Hablla disponibiliza um **preview da página no lado direito da tela**, permitindo acompanhar como o seu Link na Bio ficará para o público. Você poderá personalizar informações como **foto de perfil, título, descrição, redes sociais e os conteúdos apresentados na página**. Também é possível organizar diferentes elementos, como **botões, links e grupos**, além de alterar sua ordenação para destacar os conteúdos mais relevantes para o seu público. ### Personalize o tema Na área de **Tema**, você poderá definir a identidade visual da página. É possível utilizar opções visuais previamente disponibilizadas pela Hablla ou personalizar elementos de acordo com o manual da sua marca. Utilize essas opções para criar uma página coerente com a identidade visual utilizada pela sua empresa nos demais canais digitais. ## Como criar um Link na Bio {% stepper %} {% step %} ### 1. Acesse o recurso No menu superior da Hablla, acesse **Marketing** e selecione a opção **Link na Bio**. Nesta página serão apresentados os Links na Bio existentes no seu workspace. Caso ainda não tenha criado nenhum, você poderá iniciar uma nova configuração. {% endstep %} {% step %} ### 2. Crie um novo Link na Bio Clique no botão **+ Adicionar**, localizado no canto superior direito da tela. Você será direcionado para o editor do **Link na Bio**, onde poderá iniciar a personalização da sua página.
{% endstep %} {% step %} ### 3. Configure sua página No editor, utilize as opções disponíveis para adicionar e organizar as informações que deseja apresentar ao seu público. Você poderá configurar elementos como **título, descrição, foto de perfil, redes sociais e os diferentes conteúdos e links que farão parte da página**. Conforme as configurações forem realizadas, utilize o **preview disponível no lado direito da tela** para acompanhar como sua página ficará para quem acessá-la. #### Organize seus conteúdos Na área de configuração, você poderá adicionar e organizar os conteúdos que serão apresentados na página. Utilize os elementos disponíveis para estruturar seus links, botões e grupos de acordo com a experiência que deseja oferecer ao público. A ordenação dos elementos também poderá ser ajustada, permitindo definir quais informações terão maior destaque na página. #### Personalize o tema Acesse a área de **Tema** para definir a aparência do seu Link na Bio. Você poderá selecionar uma das opções visuais disponíveis ou personalizar os elementos da página de acordo com a identidade da sua marca. Entre as opções disponíveis, você poderá ajustar características como **cores, fontes e aparência dos botões**. Enquanto realiza as alterações, acompanhe o resultado diretamente pelo preview disponível no editor. #### Personalize o endereço do seu Link na Bio Você também poderá definir um endereço personalizado para facilitar a identificação e divulgação da sua página. A URL seguirá a estrutura: `https://bio.hablla.io/seu-sufixo` O **sufixo** corresponde à parte personalizada do endereço e pode ser definido de acordo com a identificação que deseja utilizar para sua página. Por exemplo, a própria Hablla utiliza o sufixo `hablla` em seu Link na Bio: `https://bio.hablla.io/hablla` Nesse exemplo, temos:
ElementoValor
Domíniobio.hablla.io
Sufixo personalizadohablla
Endereço completobio.hablla.io/hablla
Você pode conferir nosso link na Bio [**clicando aqui**](https://bio.hablla.io/hablla). {% hint style="info" %} Ao definir o seu endereço, recomendamos utilizar um sufixo **curto, fácil de identificar e relacionado à sua marca ou empresa**. Isso facilita a divulgação e torna o link mais simples de reconhecer e compartilhar. {% endhint %} {% endstep %} {% step %} ### 4. Publique as alterações Depois de finalizar a configuração e conferir sua página pelo preview, clique em **Publicar**. {% endstep %} {% endstepper %} ### Tudo pronto :white\_check\_mark: Pronto! Seu Link na Bio estará disponível através do endereço configurado. Agora você pode utilizar essa URL na **bio do Instagram, outras redes sociais, campanhas, materiais de divulgação ou qualquer outro canal em que queira oferecer um ponto central de acesso à sua marca**. A partir daí, sempre que precisar atualizar algum conteúdo, basta retornar ao editor, realizar as modificações, utilizar o preview para conferir o resultado e **Publicar** novamente quando a nova versão estiver pronta. # Disparo em Massa (Campanha) 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. # Execuções de Fluxos em Lote A **Execução de Fluxos em Lote** permite executar um fluxo de automação para múltiplas pessoas de forma massiva, possibilitando automatizar comunicações, atualizações e diferentes processos em larga escala. Diferente de uma ação limitada ao envio de uma única mensagem, neste recurso **todo o fluxo configurado será executado para cada pessoa definida como alvo da execução**. Isso permite utilizar toda a versatilidade dos Fluxos de Automação da Hablla para construir diferentes estratégias e processos. Por exemplo, uma execução em lote pode iniciar um fluxo que envia uma mensagem para determinado público e, de acordo com a interação de cada pessoa, atualiza informações, executa novas ações ou transfere o atendimento para um atendente. Outros exemplos de utilização incluem: * Atualização de informações de Pessoas; * Execução de integrações e automações; * Segmentação de diferentes caminhos de acordo com regras definidas no fluxo; * Execução de processos personalizados construídos através dos componentes disponíveis nos Fluxos de Automação. As possibilidades dependem diretamente da **lógica configurada no fluxo utilizado na execução**. {% hint style="info" %} A **Execução de Fluxos em Lote** é um recurso recomendado para usuários que já possuem conhecimento sobre a criação e o funcionamento dos **Fluxos de Automação da Hablla**. Antes de realizar execuções para grandes públicos, recomendamos testar o fluxo utilizando uma quantidade reduzida de pessoas. Dessa forma, você poderá validar seu comportamento antes de ampliar a execução. {% endhint %} ## Como criar uma Execução de Fluxos em Lote A configuração é realizada em etapas, nas quais você poderá definir **como a execução acontecerá, quem fará parte dela e qual fluxo será utilizado**. {% stepper %} {% step %} ### 1. Acesse Execução de Fluxos em Lote No menu superior da Hablla, acesse **Marketing** e selecione a opção **Execução de Fluxos em Lote**. Nesta página serão apresentadas as execuções já cadastradas no seu workspace. Para criar uma nova, clique no botão **+ Novo Disparo**, localizado no canto superior direito da tela.
{% endstep %} {% step %} ### 2. Configurações de Informações do Disparo Na primeira etapa, configure as informações básicas da execução. > **Nome do Disparo**: Defina um nome que permita identificar facilmente essa execução posteriormente. Utilize uma nomenclatura relacionada ao objetivo ou público da execução para facilitar sua identificação. > **Tipo de Envio**: Defina **quando** a execução deverá ser iniciada. Você poderá configurar a execução para ser realizada **imediatamente** após a finalização da configuração do disparo ou definir um **agendamento** para que ela seja iniciada em uma data e horário programado. > **Modo de Envio**: Defina como as execuções serão processadas. Você poderá escolher entre **Único Lote** ou **Fracionado**. > > * **Único lote:** Utilize essa opção quando desejar processar todas as execuções de uma só vez. > * **Fracionado**: O modo **Fracionado** permite dividir a execução em grupos menores, distribuídos ao longo do tempo. Ao selecionar essa opção, configure: > > * **Intervalo:** valor da quantidade **em** **minutos** entre cada lote; > * **Tamanho do lote:** quantidade de execuções que deverão ser iniciadas a cada intervalo. > > Por exemplo, para uma execução destinada a `1.000` pessoas, você poderia configurar: > >
ConfiguraçãoValor
Quantidade total1.000 pessoas
Tamanho do lote100
Intervalo10 minutos
> > Nesse cenário, a Hablla processará **100 execuções a cada 10 minutos**, até que o total do público definido seja processado. O envio fracionado pode ser utilizado quando você deseja distribuir a execução ao longo do tempo em vez de iniciar todo o volume simultaneamente. {% endstep %} {% step %} ### 3. Defina os alvos da execução {% endstep %} {% endstepper %} **\[GIF — Configurando as informações e o modo de envio]** ### Defina os alvos da execução Na próxima etapa, você deverá definir **para quais pessoas o fluxo será executado**. A Hablla permite definir esse público de duas formas: | Opção | Como funciona | | --------------------- | ----------------------------------------------------------------------------------------------------------------------- | | **Arquivo** | Permite utilizar um arquivo contendo os dados que serão utilizados como entrada para a execução. | | **Filtros Dinâmicos** | Permite utilizar as próprias Pessoas cadastradas no workspace e segmentá-las através dos filtros disponíveis na Hablla. | #### Utilizando um arquivo Caso escolha utilizar um arquivo, faça o upload do documento que contém os dados que serão utilizados na execução. Atualmente, são aceitos os seguintes formatos: * `.xlsx` * `.xls` * `.json` Após realizar o upload, continue para a próxima etapa da configuração. **\[GIF — Realizando o upload de um arquivo]** #### Utilizando Filtros Dinâmicos Caso escolha utilizar os **Filtros Dinâmicos**, você poderá segmentar as Pessoas cadastradas no seu workspace de acordo com os critérios disponíveis. Conforme os filtros forem configurados, a Hablla apresentará a **quantidade de pessoas correspondentes à segmentação**, permitindo visualizar o tamanho do público que fará parte da execução. Os filtros seguem a mesma lógica de segmentação utilizada em outros recursos de Marketing da Hablla. Para conhecer os filtros disponíveis e entender como utilizá-los, consulte nossa documentação sobre **Filtros Dinâmicos clicando aqui**. **\[GIF — Criando uma segmentação utilizando Filtros Dinâmicos]** ### Selecione o Fluxo Depois de definir os alvos da execução, selecione o **Fluxo de Automação** que deverá ser utilizado. O fluxo selecionado será executado para as pessoas definidas nas etapas anteriores. É justamente a estrutura desse fluxo que determinará **o que acontecerá durante a execução em lote**. Por exemplo, se o fluxo possuir uma ação responsável por enviar uma mensagem, essa ação será executada durante o processamento das pessoas definidas como alvo. Se o fluxo possuir outras etapas, como atualização de dados, condições, integrações ou transferências, essas ações também poderão fazer parte da execução de acordo com a lógica construída. **\[GIF — Selecionando o Fluxo de Automação]** ### Revise e finalize a execução Após concluir todas as configurações, revise as informações definidas antes de continuar. Confira principalmente: * O público selecionado; * A quantidade de pessoas envolvidas; * O modo de envio; * O agendamento, caso tenha sido configurado; * O fluxo selecionado; * As ações que serão executadas por esse fluxo. Quando estiver tudo correto, clique em **Finalizar**, no canto superior direito da tela. {% hint style="danger" %} **Revise cuidadosamente sua configuração antes de confirmar uma Execução de Fluxos em Lote.** O fluxo selecionado será executado de forma massiva para o público definido e poderá realizar ações como envio de mensagens, alterações de dados e outros processos configurados na automação. Dependendo dos componentes, canais e serviços utilizados pelo fluxo, a execução também poderá **gerar cobranças relacionadas ao uso desses recursos**. Por isso, recomendamos validar previamente o fluxo com uma quantidade reduzida de pessoas e conferir o público selecionado antes de realizar execuções em maior escala. {% endhint %} ### Confirme a execução Ao clicar em **Finalizar**, a Hablla exibirá uma janela de confirmação antes de registrar a solicitação. Para confirmar que você está ciente da ação que será realizada, será necessário digitar no campo apresentado a **palavra de confirmação solicitada pelo sistema**. Após preencher corretamente a confirmação, o botão responsável por concluir a ação será liberado. Clique no botão de confirmação para registrar a Execução de Fluxos em Lote. **\[GIF — Revisando e confirmando a execução]** ### Tudo pronto! Após a confirmação, a Hablla processará a execução de acordo com as configurações definidas. Se você configurou uma execução **imediata**, o processamento poderá ser iniciado após a confirmação. Caso tenha utilizado um **agendamento**, a execução seguirá a data e o horário configurados. No modo **Fracionado**, o processamento seguirá o intervalo e o tamanho dos lotes definidos anteriormente. A partir desse momento, o comportamento de cada execução dependerá da lógica construída no **Fluxo de Automação selecionado**. É justamente essa flexibilidade que permite utilizar a Execução de Fluxos em Lote para diferentes necessidades da sua operação, desde comunicações em larga escala até processos automatizados mais completos. # 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 A Base de Conhecimento permite que a IA tenha acesso a informações específicas sobre os produtos, serviços e processos da empresa e etc, utilizando esses conteúdos como fonte para responder às pergunt ### O que pode ser colocado na Base de Conhecimento? A Base de Conhecimento pode conter informações relacionadas aos produtos e serviços oferecidos pela empresa. **Por exemplo:** Descrição dos produtos; Características e especificações; Preços e condições comerciais; Formas de pagamento; Prazos; Disponibilidade; Garantias; Políticas de troca e devolução; Perguntas frequentes; Formas de utilização; Benefícios e diferenciais; Regras e limitações; Informações sobre serviços oferecidos. **Exemplo:** Se a empresa vende um produto chamado Produto X, a Base de Conhecimento pode conter:
Produto X O Produto X possui capacidade de 500 ml, está disponível nas cores azul, preta e branca e possui garantia de 12 meses. O produto pode ser pago por cartão de crédito, Pix ou boleto. O prazo de entrega é de até 7 dias úteis para a região Sudeste. ***
### Como preparar as informações \ As informações devem ser escritas de forma clara, objetiva e organizada. A IA precisa conseguir identificar facilmente: * Qual é o produto; * Quais são suas características; * Quais regras se aplicam; * Quais informações são específicas de cada produto; * Quais são as condições ou limitações.
## Formato do arquivo A Base de Conhecimento deve ser disponibilizada em um formato de arquivo baseado em texto, que permita a leitura e interpretação adequada das informações pela IA. São recomendados formatos como: * .txt * .docx O conteúdo deve estar preferencialmente em texto estruturado, evitando formatos que dificultem a leitura ou extração das informações.
### Atualização das informações A Base de Conhecimento deve ser mantida atualizada sempre que houver alteração nas informações dos produtos ou serviços. Como a Base de Conhecimento não permite edição do conteúdo já publicado, quando for necessário realizar uma alteração, é necessário criar uma nova versão completa da base e substituir a anterior. Se necessário a base atual pode ser baixada em Base de conhecimento > Acesse a base desejada > clique em Arquivo. A nova versão deve conter as informações anteriores que continuam válidas, além das informações atualizadas.
# 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.

# Gerenciamento de Atendimentos em Massa O recurso de **Gerenciamento de Atendimentos** permite realizar **`ações em massa`** sobre os atendimentos do seu workspace. Através desse recurso, é possível **finalizar ou transferir múltiplos atendimentos de uma só vez**, facilitando operações que precisariam ser realizadas individualmente em cada atendimento. Esse recurso pode ser útil, por exemplo, quando existem diversos atendimentos acumulados que precisam ser finalizados ou quando é necessário transferir um conjunto de atendimentos para outro setor ou usuário. {% hint style="warning" %} O Gerenciamento de Atendimentos realiza ações em massa e deve ser utilizado com cuidado. Antes de confirmar qualquer operação, certifique-se de que os filtros aplicados e os atendimentos selecionados estão corretos. {% endhint %} ## Como acessar o Gerenciamento de Atendimentos Para utilizar esse recurso, é necessário possuir permissão para visualizar o **Histórico de Atendimentos** do workspace. {% stepper %} {% step %} ### 1. Acesse o Histórico de Atendimentos No menu superior da Hablla, acesse **Atendimento** e, em seguida, selecione a opção **Histórico de Atendimentos**. Nesta tela serão apresentados os atendimentos registrados no seu workspace. ![](https://cdn.hablla.com/ws_643d802021b6aa9234eb9797/services/6a7f6f4e373e5ee5b7b447f0/services-8b4624e6-6372-4a11-a0c0-dd405c4774bb.png) {% endstep %} {% step %} ### 2. Aplique os filtros Antes de utilizar a opção **Gerenciar Atendimentos**, é necessário definir quais atendimentos deverão fazer parte da operação. Para isso, clique em **Filtros** e configure obrigatoriamente: * **Status do Atendimento:** selecione **o status** ou **os status** dos atendimentos que deseja gerenciar. * **Setor:** selecione o setor ou os setores em que esses atendimentos estão. Entre os status disponíveis estão **Pendente**, **Na Fila**, **No Bot**, **Em Atendimento**, e **Feedback**. Após aplicar os filtros, o Histórico de Atendimentos será atualizado apresentando os registros correspondentes aos critérios informados. {% hint style="warning" icon="triangle-exclamation" %} Revise os atendimentos apresentados após aplicar os filtros. Certifique-se de que os critérios utilizados não incluíram atendimentos que ainda precisam permanecer em andamento. O sistema executará a ação solicitada sobre os atendimentos selecionados, portanto essa conferência é fundamental antes de prosseguir. {% endhint %} {% endstep %} {% step %} ### 3. Acesse Gerenciar Atendimentos Depois de aplicar os filtros obrigatórios, a opção **Gerenciar Atendimentos** ficará disponível no canto superior direito da tela. Confira novamente os resultados apresentados e, se estiverem corretos, clique em **Gerenciar Atendimentos** e uma nova janela será aberta para que você escolha qual ação deseja realizar. Atualmente, estão disponíveis duas opções: * [**Transferir Atendimentos**](#transferindo-atendimentos-em-massa) * [**Finalizar Atendimentos**](#finalizando-atendimentos-em-massa) ![](https://cdn.hablla.com/ws_643d802021b6aa9234eb9797/services/6a7f6f4e373e5ee5b7b447f0/modal-3c3688a2-66f8-4390-8f68-8c6d52be7043.png) {% endstep %} {% endstepper %} ## Finalizando Atendimentos em Massa Para encerrar múltiplos atendimentos, selecione a opção **Finalizar Atendimentos**. {% stepper %} {% step %} ### 1. Selecione os atendimentos Selecione os atendimentos que deverão ser finalizados. Você também pode utilizar a opção de seleção de todos os atendimentos disponíveis dentro dessa tela. {% hint style="danger" icon="triangle-exclamation" %} **Limite por solicitação:** É possível selecionar e finalizar no máximo **50 atendimentos por solicitação**. Caso seja necessário finalizar uma quantidade superior, repita o procedimento até concluir todos os atendimentos desejados. {% endhint %} {% endstep %} {% step %} ### 2. Informe o motivo da finalização Após selecionar os atendimentos, informe o **Motivo da Finalização**. Esse campo é obrigatório e deve indicar o motivo pelo qual os atendimentos selecionados estão sendo encerrados. {% endstep %} {% step %} ### 3. Confirme a ação Antes de liberar a execução, a Hablla solicitará uma **confirmação manual da ação**. Digite no campo de confirmação exatamente a palavra apresentada pelo sistema. Após preencher corretamente a confirmação solicitada, o botão responsável por executar a ação será liberado. {% hint style="danger" %} Confira novamente os atendimentos selecionados antes de confirmar. Após a solicitação da operação em massa, a ação **não poderá ser interrompida** ou **revertida**. {% endhint %}
{% endstep %} {% endstepper %} ## Transferindo Atendimentos em Massa O mesmo recurso também permite transferir múltiplos atendimentos simultaneamente. Para isso, acesse **Gerenciar Atendimentos** e selecione a opção **Transferir Atendimentos**. {% stepper %} {% step %} ### 1. Selecione os atendimentos Selecione os atendimentos que deverão ser transferidos. Você também pode utilizar a opção de seleção de todos os atendimentos disponíveis dentro dessa tela. {% hint style="danger" icon="triangle-exclamation" %} **Limite por solicitação:** É possível selecionar e transferir no máximo **50 atendimentos por solicitação**. Caso seja necessário finalizar uma quantidade superior, repita o procedimento até concluir todos os atendimentos desejados. {% endhint %} {% endstep %} {% step %} ### 2. Configure a transferência Defina as informações da transferência: * **Setor:** selecione o setor para o qual os atendimentos serão transferidos; * **Usuário:** opcionalmente, selecione um usuário específico para receber os atendimentos; * **Motivo:** informe obrigatoriamente o motivo da transferência. {% hint style="info" %} Caso nenhum usuário seja selecionado, os atendimentos serão direcionados para o setor definido e ficarão disponíveis na fila de atendimentos desse setor. {% endhint %} {% endstep %} {% step %} ### 3. Confirme a ação Antes de liberar a execução, a Hablla solicitará uma **confirmação manual da ação**. Digite no campo de confirmação exatamente a palavra apresentada pelo sistema. Após preencher corretamente a confirmação solicitada, o botão responsável por executar a ação será liberado. {% hint style="danger" %} Confira novamente os atendimentos selecionados antes de confirmar. Após a solicitação da operação em massa, a ação **não poderá ser interrompida** ou **revertida**. {% endhint %} Depois de revisar as informações, realize a **confirmação manual da ação** solicitada pela Hablla e confirme a transferência.
{% endstep %} {% endstepper %} ## Processamento da solicitação Tanto a finalização quanto a transferência em massa são **operações processadas em lote**. Isso significa que, após confirmar a solicitação, os atendimentos podem não ser atualizados imediatamente. O tempo de processamento pode variar de acordo com a quantidade de atendimentos envolvidos na operação. Após enviar a solicitação, a Hablla exibirá uma **notificação no canto superior direito da tela** informando sobre a operação. A solicitação também poderá ser acompanhada através da área de **Notificações** do workspace.
{% hint style="danger" icon="triangle-exclamation" %} Uma operação em massa não poderá ser interrompida após sua confirmação. Por isso, revise sempre os **filtros, atendimentos selecionados e ação escolhida** antes de confirmar a solicitação. {% endhint %} ## Tudo pronto :white\_check\_mark: Após enviar a solicitação, basta aguardar o processamento da operação. Quando utilizar o Gerenciamento de Atendimentos em massa, sempre revise e confira os atendimentos que serão afetados. Essa conferência ajuda a garantir que somente os atendimentos desejados recebam a alteração da operação em massa. # 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. # Exportando Pessoas O recurso de **Exportação de Pessoas** permite gerar um arquivo contendo os dados das pessoas cadastradas no seu workspace da Hablla. Você pode exportar **todas as pessoas cadastradas** ou utilizar os filtros disponíveis para gerar um arquivo contendo apenas os registros que atendam a determinados critérios. Esse recurso pode ser útil para análises externas, tratamento de dados, criação de relatórios, conferências ou outras situações em que seja necessário trabalhar com os dados das pessoas fora da Hablla. {% hint style="info" %} Para realizar a exportação, o usuário precisa possuir as **permissões necessárias para acessar e visualizar os dados de Pessoas** dentro do workspace. {% endhint %} ## Como exportar Pessoas {% stepper %} {% step %} ### 1. Acesse a página de Pessoas No menu superior da Hablla, clique em **Dados** e, em seguida, selecione a opção **Pessoas**. {% hint style="info" %} Se você estiver usando uma permissão que não seja de administrador, mas que tenha acesso ao gerenciamento de pessoas, você pode clicar na opção **Pessoas** {% endhint %} Nesta página serão apresentadas as pessoas cadastradas no seu workspace.
{% endstep %} {% step %} ### 2. Aplique os filtros desejados Antes de realizar a exportação, você pode utilizar os **Filtros** para definir quais pessoas deverão fazer parte do arquivo. Essa etapa é opcional. Caso nenhum filtro seja aplicado, a exportação considerará todas as pessoas do seu workspace para exportação. Você pode combinar diferentes filtros para localizar exatamente o conjunto de pessoas que deseja exportar. Entre os filtros disponíveis estão:
FiltroComo funciona
StatusPermite filtrar as pessoas de acordo com o status da person dentro do workspace.
DuplicadosPermite identificar pessoas que possuem alguma informação duplicada no workspace, como duas pessoas cadastradas com o mesmo número de telefone ou endereço de e-mail.
OrganizaçõesPermite filtrar as pessoas vinculadas a uma Organização cadastradas no workspace. As Organizações podem representar empresas ou outros grupos aos quais as pessoas estão associadas.
Campos PersonalizadosPermite utilizar os Campos Personalizados de Pessoas como critérios de busca. Selecione o campo que deseja utilizar e informe o valor correspondente. A forma de preenchimento do filtro poderá variar de acordo com o tipo do campo personalizado.
BloqueadosPermite filtrar pessoas de acordo com sua condição de bloqueio, possibilitando localizar tanto pessoas bloqueadas quanto pessoas que não estão bloqueadas no seu workspace.
DataPermite filtrar as pessoas por um período específico, utilizando como referência a data de Criação ou de Última Atualização da pessoa.
EtiquetasPermite localizar pessoas que possuem determinadas Etiquetas vinculadas. É possível selecionar uma ou mais etiquetas e, quando múltiplas etiquetas forem utilizadas, serão consideradas as pessoas que atendam a todas as etiquetas selecionadas.
DonosPermite filtrar as pessoas de acordo com o usuário definido como Dono. É possível selecionar um ou mais usuários para localizar as pessoas que possuem esses usuários como seus respectivos donos.
SeguidoresPermite filtrar as pessoas de acordo com os usuários vinculados como Seguidores. É possível selecionar um ou mais usuários para localizar as pessoas às quais eles estejam vinculados como seguidores.
**Entendendo o filtro por Data** Ao utilizar o filtro de **Data**, você poderá escolher entre duas referências: * **Criado em:** considera a data em que a pessoa foi originalmente cadastrada no workspace. * **Atualizado em:** considera a data da última modificação realizada nos dados da pessoa. Sempre que alguma informação do cadastro é alterada, essa modificação passa a ser considerada como sua última atualização. {% hint style="warning" %} **Confira os filtros antes de continuar.** Caso existam filtros aplicados, somente as pessoas correspondentes aos critérios definidos serão consideradas na exportação. {% endhint %} Após definir os registros que deseja exportar, clique no botão **Exportar Dados**, localizado na lateral esquerda da página, abaixo da descrição da seção de Pessoas. Uma nova janela será apresentada para configurar a exportação.
{% endstep %} {% step %} ### 3. Configurando sua Exportação Antes de iniciar a geração do arquivo, será necessário definir algumas informações bem rápidas. Falaremos um pouco de cada uma delas brevemente a seguir: * **Descrição**: Essa descrição será utilizada posteriormente para identificar a solicitação dentro da área de **Notificações** da Hablla. > No nosso exemplo, definiremos a descrição como "**`Exportação Pessoas`**". * **Extensão do Arquivo:** Escolha em qual formato você quer exportar a sua lista. Atualmente temos disponíveis três opções de arquivos. Sendo elas: > - **CSV**: Um formato de texto simples, excelente se você for importar essa lista em outros sistemas ou plataformas. OBS: O excel também aceita esse tipo de arquivo. > - **JSON**: Um formato mais técnico, geralmente usado por equipes de desenvolvimento para integrações. > - **XLSX**: O formato clássico do Excel. Escolha este se você quiser apenas abrir a planilha para ler e organizar os dados no seu computador.
{% endstep %} {% step %} ### 4. Exportação e download do arquivo Após conferir a descrição, o formato escolhido e a quantidade de pessoas que serão exportadas, clique em **Exportar**. A Hablla receberá sua solicitação e exibirá uma notificação no canto superior direito da tela informando que a exportação foi solicitada com sucesso. A geração do arquivo é realizada em segundo plano. Por isso, dependendo da quantidade de registros que precisam ser processados, o arquivo pode não ficar disponível para download imediatamente, portanto, recomendamos o acompanhamento após a solicitação. {% hint style="info" %} Exportações menores normalmente são processadas mais rapidamente, enquanto exportações com uma quantidade maior de registros podem levar mais tempo para serem concluídas. {% endhint %} Você não precisa permanecer na página de Pessoas enquanto o arquivo é processado. Para acompanhar a solicitação, acesse a área de **Notificações** do seu workspace clicando no ícone de **notificação** :bell: no canto superior direito da sua tela. {% endstep %} {% step %} ### 5. Baixe o arquivo Quando o processamento for concluído, a exportação ficará disponível na área de **Notificações**. Localize a exportação correspondente com o mesmo nome definido anteriormente no campo "**Descrição**" na configuração da exportação e clique no botão **Baixar**. O arquivo será baixado para o seu dispositivo no formato selecionado durante a configuração da exportação.
{% endstep %} {% endstepper %} ### Pronto :white\_check\_mark: Com o arquivo gerado e concluído o download, você terá os dados das pessoas exportadas de acordo com os critérios definidos anteriormente. Sempre que precisar exportar apenas uma parte da sua base, utilize os **Filtros** antes de solicitar a exportação. Dessa forma, você pode gerar arquivos mais específicos e trabalhar somente com os registros necessários para cada finalidade. # Importação de Pessoas Se você já possui uma base de contatos, clientes ou leads, não é necessário cadastrar cada um deles manualmente na Hablla. Nossa plataforma permite que você importe a sua lista completa de uma só vez, facilitando e acelerando o seu trabalho! Abaixo, preparamos um passo a passo simples de como acessar a área correta e iniciar a sua importação. ### Passo 1: Acessando a área de Pessoas Tudo começa no menu principal do seu *workspace*. Siga os passos: 1. No menu superior esquerdo, logo ao lado da logo da Hablla, clique no botão **Dados** para abrir o menu suspenso.
No menu que se abriu, clique na primeira opção da lista, chamada **Pessoas**. ### Passo 2: Iniciando a importação Após clicar em "Pessoas", você será direcionado para o painel principal de gerenciamento dos seus contatos. Nesta tela, logo abaixo da descrição, clique sobre o botão **Importar dados** para começarmos a sua importação de pessoas para a Hablla.
### Passo 3: A janela de Importação Ao clicar no botão Importar dados, uma nova janela (modal) se abrirá no centro da sua tela. É aqui que o processo de importação realmente acontece, dividido em etapas simples.
Nesta nova tela, você notará que a plataforma te guia por 4 passos. Vamos focar no primeiro e mais importante deles para começar. ### Passo 4: Baixando o modelo de planilha Para que a Hablla consiga ler e organizar perfeitamente as informações dos seus contatos (como nome, telefone, e-mail, etc.), os dados precisam estar padronizados. Para facilitar a sua vida, nós já criamos um arquivo com o formato exato que o sistema exige! 1. Na etapa 1 - Baixe o modelo de planilha, clique no botão Baixar planilha modelo. 2. Um arquivo de planilha será salvo no seu computador. 3. Abra este arquivo e comece a preencher (ou colar) os dados dos seus contatos nas colunas correspondentes. {% hint style="warning" icon="triangle-exclamation" %} Atenção: Para garantir que a sua importação ocorra sem nenhum erro, **não altere** ou **renomeie** o título de nenhuma coluna da planilha que você baixou. Preencha apenas os dados nas linhas abaixo dos títulos originais. {% endhint %}
### Passo 5: Preenchendo a planilha com seus contatos Ao abrir o arquivo Excel que você acabou de baixar, você notará que a primeira linha (o cabeçalho) já contém os nomes das colunas em inglês. Para facilitar, veja o que significa cada uma das colunas principais e como preenchê-las: * **Name (Nome)**: Digite o nome completo da pessoa que você deseja cadastrar. * **DDI (Código do País)**: É o código internacional de telefone. Se os seus contatos forem do Brasil, por exemplo, basta preencher com o número 55. * **Phone (Telefone)**: Insira o número de telefone do contato junto com o DDD local. No nosso exemplo, usamos um número fictício como *1199999-0000*. * **Email**: O endereço de e-mail da pessoa (preencha caso você tenha essa informação). * **SSN (Documento)**: Este é um campo destinado a documentos de identificação. Você pode usá-lo para registrar o CPF ou RG do contato, por exemplo. {% hint style="info" icon="lightbulb" %} Dica: Os campos de Email e SSN não são obrigatórios para a criação do contato, mas enriquecem o perfil do seu cliente dentro da Hablla! {% endhint %}
### Passo 6: Configurando e finalizando a importação Agora que a sua planilha está preenchida e salva no seu computador, retorne para a janela de importação que deixamos aberta na Hablla. Vamos configurar os últimos detalhes: 2\. Selecione a segmentação (Opcional) * Se você deseja organizar esses novos contatos em uma segmentação específica que você já possui, clique no campo e escolha a opção desejada. Se essa não for a sua intenção no momento, pode pular esta etapa tranquilamente! 3\. Faça o upload da planilha preenchida * Clique no botão Escolher arquivo. * Busque no seu computador a planilha que você acabou de preencher e selecione-a. 4\. Regras de importação Nesta etapa final, vamos definir como a plataforma deve lidar com os dados que você está trazendo, ajudando a manter sua base sempre organizada e sem bagunça. Primeiro, você deve escolher como tratar registros que porventura já estejam cadastrados: * Atualizar existentes (Recomendado): É a opção ideal para evitar contatos repetidos. O sistema reconhece se a pessoa já existe no seu workspace e aproveita o cadastro dela. * Duplicar Pessoas: Como o nome sugere, essa opção cria um novo contato na sua base, mesmo que aquela pessoa já esteja cadastrada. Recomendamos manter a opção anterior para não desorganizar sua lista, mas essa alternativa fica disponível para casos muito específicos da sua operação. Dados após importação Caso você tenha escolhido "Atualizar existentes" no passo acima, é aqui que você define como o sistema fará essa atualização: * Atualizar com novos dados: Se o contato já existir na sua base, as informações dele serão atualizadas e complementadas com os dados novos da sua planilha. * Manter dados antigos: O sistema reconhece que a pessoa já existe, mas preserva os dados que já estavam na Hablla, ignorando as informações novas da planilha para esse contato específico. Dono (Opcional) Não há nenhuma obrigatoriedade de preencher este campo. Defina um dono apenas se você desejar atrelar um membro da sua equipe como responsável específico por esses contatos logo no momento da importação.
Para finalizar, basta clicar no botão Importar, localizado no canto inferior direito da tela. E pronto, seus contatos começarão a ser adicionados ao seu workspace! ### Passo 7: Conferindo seus novos contatos importados Após clicar no botão de importar, a plataforma fará o trabalho pesado por você. Em instantes, o processamento será concluído e você já poderá visualizar a sua base de dados atualizada! Todos os contatos que estavam na sua planilha agora aparecerão listados diretamente no seu painel principal de Pessoas. Veja no exemplo abaixo como o contato que preenchemos na nossa planilha modelo já aparece perfeitamente cadastrado no *workspace*, com o nome, e-mail e telefone organizados.
Pronto! Agora você já sabe como trazer toda a sua base de clientes para a Hablla de forma ágil e centralizada. ## Boas Práticas para uma Importação de Sucesso Para garantir que a sua experiência seja perfeita e que a sua base de contatos fique muito bem organizada na Hablla, separamos algumas dicas de ouro: * Faça um pequeno teste primeiro: Se esta é a sua primeira vez importando dados para a plataforma, nossa maior recomendação é: **não importe sua lista inteira de uma vez**. Preencha a planilha modelo com apenas 1 a 10 contatos de teste. Faça o processo de importação e vá até a sua lista de Pessoas para conferir se os dados (telefone, e-mail, etc.) caíram certinhos em cada campo. Deu tudo certo? Ótimo, agora você pode importar o resto da sua lista gigante com total segurança! * Revise os formatos na planilha: Dê uma conferida rápida nos seus dados antes de fazer o upload. Verifique se os números de telefone estão com o DDI correto (ex: 55 para o Brasil) e se não há espaços em branco vazios no começo ou no final dos e-mails e nomes. * A Regra de Ouro continua: Nunca é demais lembrar que os títulos das colunas na planilha modelo (como *Name*, *Phone*, etc.) não devem ser renomeados. A plataforma precisa deles exatamente como estão para "ler" as informações corretamente. * Evite duplicatas: Sempre que possível, mantenha a regra de importação em Atualizar existentes. Isso evita que você crie contatos repetidos e mantém o seu *workspace* limpo e fácil de gerenciar. # 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"**. # Importação de Organizações ### Importando Organizações Assim como você pode importar a sua lista de clientes e contatos, a Hablla também permite que você importe a sua base de Organizações em massa. Isso é ideal para trazer de uma só vez todas as empresas, parceiros ou fornecedores com os quais você se relaciona para dentro do seu *workspace*. Veja abaixo o passo a passo de como acessar a área correta e iniciar a importação da sua lista. ### Passo 1: Acessando a área de Organizações O processo começa exatamente no mesmo lugar onde gerenciamos as Pessoas. Siga este caminho rápido: 1. Olhe para o menu superior da plataforma, logo ao lado da marca da Hablla. 2. Clique no botão que marca Dados para abrir o menu de opções. 3. No menu suspenso, clique na opção da lista chamada Organizações.
### Passo 2: Iniciando a importação de Organizações Ao clicar em "Organizações", você será direcionado para o painel de gerenciamento das empresas e parceiros do seu *workspace*. Nesta tela inicial, logo abaixo da descrição, você verá dois botões de ação rápida. Para começar a trazer a sua planilha de empresas para o sistema, clique no botão Importar dados.
### Passo 3: A janela de Importação e o Modelo de Planilha Ao clicar em Importar dados, a janela de configuração será aberta no centro da tela. Se você já importou Pessoas antes, vai notar que o processo aqui é muito familiar! O primeiro e mais importante passo é baixar o nosso arquivo padrão para preencher com os dados das suas empresas: 1. Na etapa 1 - Baixe o modelo de planilha, clique no botão Baixar planilha modelo. 2. Abra o arquivo Excel que foi salvo no seu computador e preencha as informações das organizações (nome da empresa, e-mail corporativo, telefone, etc.) respeitando as colunas. > ⚠️ Atenção: A Regra de Ouro continua! Para garantir que a importação das suas organizações ocorra sem erros, não altere ou renomeie o título de nenhuma coluna da planilha baixada. Apenas preencha os dados nas linhas abaixo dos títulos.
### Passo 4: Configurando e finalizando a importação Com a sua planilha de empresas preenchida e salva, retorne para a janela de importação na Hablla para concluirmos:
2\. Selecione a segmentação (Opcional) * Caso queira organizar essas novas empresas em uma segmentação específica, escolha a opção desejada neste campo. Se não for necessário, pode pular! 3\. Faça o upload da planilha preenchida * Clique no botão Escolher arquivo e selecione a planilha de organizações que você acabou de preencher no seu computador. 4\. Regras de importação Aqui definimos como o sistema lidará com os dados das empresas para manter tudo organizado: * Atualizar existentes (Recomendado): O sistema reconhece se a organização já existe no seu *workspace* e aproveita o cadastro dela, evitando duplicatas. * Duplicar Organizações: Cria um novo cadastro de empresa, mesmo que ela já exista na sua base. Recomendamos usar esta opção apenas em casos muito específicos. Dados após importação Se você escolheu "Atualizar existentes", defina como a atualização será feita: * Atualizar com novos dados: As informações da organização serão complementadas e atualizadas com os dados novos da sua planilha. * Manter dados antigos: O sistema preserva os dados que já estavam na Hablla, ignorando as informações novas da planilha para aquela empresa específica. Dono (Opcional) Defina um dono apenas se desejar atrelar um membro da sua equipe como responsável por essas organizações logo no momento da importação. Para finalizar, clique no botão Importar no canto inferior direito. Em instantes, todas as suas empresas e parceiros estarão disponíveis no seu painel de Organizações!
### Passo 5: Conferindo suas novas organizações importadas Após clicar no botão de importar, a plataforma fará o trabalho pesado por você. Em instantes, o processamento será concluído e você já poderá visualizar a sua base de dados atualizada! Todos os contatos que estavam na sua planilha agora aparecerão listados diretamente no seu painel principal de Organizações. Veja no exemplo abaixo como o contato que preenchemos na nossa planilha modelo já aparece perfeitamente cadastrado no *workspace*, com o nome, e-mail e telefone organizados.
Pronto! Agora você já sabe como trazer toda a sua base de clientes para a Hablla de forma ágil e centralizada. ### Boas Práticas para uma Importação de Sucesso Para garantir que a sua experiência seja perfeita e que a sua base de empresas e parceiros fique muito bem organizada na Hablla, separamos algumas dicas de ouro que valem sempre a pena relembrar: * Faça um pequeno teste primeiro: Se esta é a sua primeira vez importando organizações para a plataforma, nossa maior recomendação é: não importe sua lista inteira de uma vez. Preencha a planilha modelo com apenas 1 a 10 empresas de teste. Faça o processo de importação e vá até a sua lista de Organizações para conferir se os dados (telefone corporativo, e-mail, etc.) caíram certinhos em cada campo. Deu tudo certo? Ótimo, agora você pode fazer o upload do restante da sua lista com total segurança! * Revise os formatos na planilha: Dê uma conferida rápida nos seus dados antes de fazer o upload. Verifique se os números de telefone estão com o DDI correto (ex: 55 para o Brasil) e se não há espaços em branco acidentais no começo ou no final dos e-mails e nomes das empresas. * A Regra de Ouro continua: Nunca é demais lembrar que os títulos das colunas na planilha modelo não devem ser renomeados ou apagados. A plataforma precisa deles exatamente como estão para "ler" as informações corretamente. * Evite duplicatas: Sempre que possível, mantenha a regra de importação em Atualizar existentes. Isso evita que você crie cadastros de empresas repetidas e mantém o seu *workspace* limpo e fácil de gerenciar. # 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!** --- [Next Page](/llms-full.txt/1)