# Início

Guias passo a passo, novidades da plataforma e respostas para as dúvidas mais frequentes.

<h2 align="center"><mark style="color:$primary;">Como podemos te ajudar?</mark></h2>

<p align="center">Comece por um dos caminhos abaixo ou use a busca no topo, se já souber o que procura.</p>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td></td><td><strong>Primeiros Passos</strong></td><td>Os cadastros essenciais para deixar a plataforma pronta para atender, na ordem em que devem ser feitos.</td><td></td><td><a href="/spaces/pZmCVMQSKLCGEaknWHwh/pages/eFB1ygv2fpR0WBU6JwJt">/spaces/pZmCVMQSKLCGEaknWHwh/pages/eFB1ygv2fpR0WBU6JwJt</a></td><td><a href="/files/gdmsJPgiAsVX7ft2r7Pk">/files/gdmsJPgiAsVX7ft2r7Pk</a></td></tr><tr><td></td><td><strong>Novidades do Sistema</strong></td><td>Acompanhe os lançamentos, melhorias e correções publicados a cada mês.</td><td></td><td><a href="/spaces/pZmCVMQSKLCGEaknWHwh/pages/gGqmvdeqwS2jffkrO94v">/spaces/pZmCVMQSKLCGEaknWHwh/pages/gGqmvdeqwS2jffkrO94v</a></td><td><a href="/files/KrmWnzjFj1vtPlwKpHjr">/files/KrmWnzjFj1vtPlwKpHjr</a></td></tr><tr><td></td><td><strong>FAQ</strong></td><td>Respostas diretas para as dúvidas mais frequentes de quem usa a plataforma.</td><td></td><td><a href="/spaces/pZmCVMQSKLCGEaknWHwh/pages/XmL8bxDEqwlYa0aLxhV9">/spaces/pZmCVMQSKLCGEaknWHwh/pages/XmL8bxDEqwlYa0aLxhV9</a></td><td><a href="/files/CLHySDlQ8yYxZPxklP3T">/files/CLHySDlQ8yYxZPxklP3T</a></td></tr></tbody></table>


# Início

Guias de cada módulo da plataforma, do primeiro acesso à operação do dia a dia.

## Explore a documentação

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Primeiros Passos</strong></td><td>A ordem para configurar a plataforma do zero, do cadastro da conta ao primeiro atendimento</td><td></td><td><a href="/files/gFndqTlpskTlzvXuCUR7">/files/gFndqTlpskTlzvXuCUR7</a></td><td><a href="/pages/eFB1ygv2fpR0WBU6JwJt">/pages/eFB1ygv2fpR0WBU6JwJt</a></td></tr><tr><td><strong>Atendimento</strong></td><td>Gerencie conversas, use chatbots e organize a fila da sua equipe</td><td></td><td><a href="/files/6BrmrU4SYFlpwUDg4KtQ">/files/6BrmrU4SYFlpwUDg4KtQ</a></td><td><a href="/pages/tjVyCP4X0cgBBQE50dsW">/pages/tjVyCP4X0cgBBQE50dsW</a></td></tr><tr><td><strong>CRM</strong></td><td>Organize contatos, acompanhe negociações em painéis e distribua carteiras</td><td></td><td><a href="/files/Ajn7WmBtPuM5IYkLsCTm">/files/Ajn7WmBtPuM5IYkLsCTm</a></td><td><a href="/pages/LhUq1Ix1fsufH0a5pqru">/pages/LhUq1Ix1fsufH0a5pqru</a></td></tr><tr><td><strong>Sequências</strong></td><td>Monte réguas de mensagens automáticas e acompanhe o andamento por contato</td><td></td><td><a href="/files/4RKtER6QnqkIrZudaP0P">/files/4RKtER6QnqkIrZudaP0P</a></td><td><a href="/pages/d8Ab25HWLsYZOXU9oqYG">/pages/d8Ab25HWLsYZOXU9oqYG</a></td></tr><tr><td><strong>Relatórios</strong></td><td>Acompanhe indicadores em tempo real, histórico por período e consumo</td><td></td><td><a href="/files/yudZ4vtwKkMHnUEUnElN">/files/yudZ4vtwKkMHnUEUnElN</a></td><td><a href="/pages/FXbyRUQBSWafRfEg4QR2">/pages/FXbyRUQBSWafRfEg4QR2</a></td></tr><tr><td><strong>Ajustes</strong></td><td>Defina usuários, permissões, integrações e preferências da conta</td><td></td><td><a href="/files/Mc9cTuUUi4EPzx2U4QaT">/files/Mc9cTuUUi4EPzx2U4QaT</a></td><td><a href="/pages/qusdvR3kvgoMR86fer2Z">/pages/qusdvR3kvgoMR86fer2Z</a></td></tr></tbody></table>


# Primeiros Passos

Os cadastros essenciais para deixar a plataforma pronta para atender.

Começou a usar a plataforma e não sabe por onde começar? Este artigo vai te orientar do primeiro cadastro até o primeiro atendimento.

Abaixo estão os principais cadastros e configurações da plataforma, na ordem em que devem ser feitos. Cada etapa leva ao artigo com o passo a passo.

## Preencher os dados da conta

Comece em **Ajustes → Conta**, preenchendo os dados da empresa: nome, tipo, administrador responsável, e-mail e telefone de contato, e o endereço completo.

Em seguida defina o **horário de atendimento**. Ele parece um dado cadastral, mas governa duas coisas na operação.

**Os seus indicadores.** A plataforma só conta o tempo de espera dentro do expediente: uma mensagem que chega de madrugada começa a contar na abertura do dia seguinte, não na hora em que entrou. Sem o horário configurado, a contagem parte da criação do atendimento e inclui noites, fins de semana e feriados, o que infla o tempo de espera nos relatórios.

**As suas automações.** Ao vincular um chatbot ou agente de IA a um canal, você escolhe um para responder **dentro** do horário e outro para responder **fora** dele. É o horário de atendimento que decide qual dos dois entra em ação quando o cliente manda mensagem.

* [Dados da conta](/guide/documentacao/ajustes/conta/dados-da-conta)
* [Horário de atendimento](/guide/documentacao/ajustes/conta/horario-de-atendimento)

## Cadastrar os usuários

Antes de montar equipes, crie as pessoas que vão usar a plataforma. Cada usuário recebe um perfil, e é o perfil que define o que ela pode ver e fazer.

Vale ler sobre os perfis antes de cadastrar, para não precisar refazer depois.

* [Tipos de perfis de usuários](/guide/documentacao/ajustes/usuarios/tipos-de-perfis-de-usuarios)
* [Cadastrar usuários](/guide/documentacao/ajustes/usuarios/cadastrar-usuarios)

{% hint style="info" %}
A ordem em que você cadastra os usuários importa mais do que parece. Se um dia a equipe usar distribuição automática, o rodízio segue a data de cadastro, e essa ordem não pode ser alterada depois.
{% endhint %}

## Criar as equipes

A equipe agrupa usuários e é a unidade que recebe os atendimentos. Canais são associados a equipes, e recursos como distribuição e transbordo são configurados por equipe.

* [Cadastrar equipe](/guide/documentacao/ajustes/equipes/cadastrar-equipe)

## Conectar os canais

Com a estrutura montada, conecte os canais por onde as conversas vão chegar. Escolha o tipo de conexão conforme a sua operação.

* [WhatsApp (Oficial)](/guide/documentacao/faq/conexao-whatsapp)
* [WhatsApp (Não Oficial)](/guide/documentacao/faq/whatsapp-nao-oficial)
* [Instagram/Messenger](/guide/documentacao/faq/instagram-messenger)

## Criar os modelos de mensagem, se você conectou o WhatsApp Oficial

Esta etapa é exigência da API oficial da Meta. Nela, para falar com alguém que não enviou mensagem nas últimas 24 horas, você precisa usar um **modelo aprovado**. Nas conexões não oficiais isso não se aplica, e você pode pular para a etapa seguinte.

Crie os principais logo no início, por dois motivos. A aprovação da Meta leva tempo, e sem modelo aprovado você não consegue iniciar conversa. E eles são usados em vários lugares depois: campanhas, sequências, chatbot, mensagens agendadas e o próprio atendimento.

* [Modelos de Mensagem](/guide/documentacao/ajustes/modelo-de-mensagens)

## Trazer os clientes para a base

Cadastre os clientes que a sua equipe vai atender. É no contato que ficam o histórico das conversas, as etiquetas que organizam a sua base e os campos que você mesmo criar.

Se a sua carteira de clientes já existe em outro sistema ou numa planilha, importe em lote em vez de cadastrar um a um.

* [Cadastrar contato](/guide/documentacao/crm/contato/cadastrar-contato)
* [Importar Contatos em Lote](/guide/documentacao/crm/contato/importacao-de-contatos)

## Criar as etiquetas

A etiqueta é uma marcação que você aplica ao contato para segmentar a base. Um cliente pode receber quantas precisar, como "Aluno", "Inadimplente" ou "Plano Premium".

Ela é o que transforma uma lista de contatos em grupos que você consegue usar. Com etiqueta você filtra a base na tela de Contatos, escolhe quem entra em uma campanha ou sequência, separa os números nos relatórios de atendimento e exporta só uma parte da base. O chatbot também aplica e remove etiquetas sozinho, conforme o caminho que o cliente percorre.

Vale definir um conjunto pequeno e claro logo no início. Etiqueta criada solta, no meio da operação, tende a virar duplicata com nome parecido, e aí a segmentação para de funcionar.

Se você for importar a base por planilha, pode trazer as etiquetas junto: as que ainda não existirem são criadas automaticamente.

* [Gerenciar Etiquetas](/guide/documentacao/crm/contato/gerenciar-etiquetas)

## Configurar carteiras, se a operação usar

A carteira vincula um cliente a um responsável fixo. Sempre que esse cliente abrir uma conversa, ela cai na mesma pessoa, sem passar pela fila comum.

Use quando **o relacionamento importa mais do que a velocidade da resposta**, ou seja, quando é melhor esperar pelo vendedor que conhece a negociação do que ser atendido por qualquer um. É o caso típico de operações comerciais e de pós-venda.

Existem dois modelos: um com responsável único, para quando cada cliente tem um dono, e outro com carteira compartilhada entre vários atendentes, para quando a equipe inteira precisa conseguir responder.

Depende de contatos e usuários já cadastrados.

* [Carteiras](/guide/documentacao/crm/carteiras)

## Configurar a distribuição, se a operação usar

A distribuição reparte as conversas novas entre os usuários da equipe, uma de cada vez, em rodízio. Cada conversa fica visível só para quem foi designado.

Use quando **qualquer pessoa da equipe pode atender qualquer cliente**, e o que importa é equilibrar a carga em vez de deixar todo mundo disputando as mesmas conversas. É o caso típico de suporte e de primeiro atendimento.

Você pode combinar com o transbordo, que repassa a conversa ao próximo da fila se ninguém iniciar dentro de um prazo.

Depende de a equipe já ter usuários.

{% hint style="info" %}
As duas coisas convivem, e a **carteira tem precedência**. Um cliente carteirizado vai direto para o responsável dele, mesmo que a vez fosse de outra pessoa no rodízio. A distribuição atua nos clientes sem carteira.
{% endhint %}

* [Distribuição de Atendimentos](/guide/documentacao/apps/distribuicao-de-atendimentos)

## Começar a atender

Com tudo configurado, a operação entra no dia a dia: as conversas chegam, alguém assume, responde e conclui.

* [Como os atendimentos chegam até você](/guide/documentacao/atendimento/como-os-atendimentos-chegam-ate-voce)
* [Operações no Atendimento](/guide/documentacao/atendimento/operacoes-de-atendimento)
* [Ferramentas de Interação](/guide/documentacao/atendimento/ferramentas-de-interacao)

{% hint style="success" %}
A partir daqui, a plataforma já está funcionando. O que vem depois são os recursos que ampliam a operação, como campanhas, chatbot, agentes de IA, sequências e os painéis do CRM. Cada um tem sua própria seção no menu.
{% endhint %}


# Canais

Conecte WhatsApp, Instagram e Messenger à plataforma, e resolva os problemas mais comuns de conexão.

O canal é a porta por onde as conversas chegam. Cada tipo de conexão tem um processo próprio, com requisitos e limitações diferentes.

O **WhatsApp Oficial** conecta pela API da Meta e exige um portfólio empresarial. O **WhatsApp Não Oficial** conecta por serviços de terceiros, com processo mais simples e algumas restrições de uso. **Instagram e Messenger** conectam pelas contas da Meta.

{% content-ref url="/pages/fueHTBd87m78mUUZVFaz" %}
[WhatsApp (Oficial)](/guide/documentacao/faq/conexao-whatsapp)
{% endcontent-ref %}

{% content-ref url="/pages/zdNKATlx2OXz80gKVX9n" %}
[WhatsApp (Não Oficial)](/guide/documentacao/faq/whatsapp-nao-oficial)
{% endcontent-ref %}

{% content-ref url="/pages/TqIdML3c9MVlf68NOQZZ" %}
[Instagram/Messenger](/guide/documentacao/faq/instagram-messenger)
{% endcontent-ref %}


# WhatsApp (Oficial)

Guias para conectar seu número de WhatsApp à plataforma pela API Oficial da Meta, gerenciar conexões e resolver problemas comuns.

Esta seção contém guias para conectar seu número de WhatsApp à plataforma através da API Oficial da Meta. Você encontrará informações sobre os diferentes métodos de conexão (QR Code e Cloud API), além de instruções para gerenciar e remover conexões existentes.

{% content-ref url="/pages/VYkwQxos9PXmA84ibBEn" %}
[Portfólio Empresarial](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial)
{% endcontent-ref %}

{% content-ref url="/pages/wLaPBK4buwOEwSbpneFt" %}
[CloudAPI](/guide/documentacao/faq/conexao-whatsapp/cloudapi)
{% endcontent-ref %}

{% content-ref url="/pages/nohn6Nwug6rrUsftx6fi" %}
[CloudAPI QR Code (Coexistência)](/guide/documentacao/faq/conexao-whatsapp/cloudapi-qr-code)
{% endcontent-ref %}

{% content-ref url="/pages/Ata2Fh6sNscXxjw5jE1X" %}
[Pagamentos](/guide/documentacao/faq/conexao-whatsapp/pagamentos)
{% endcontent-ref %}

{% content-ref url="/pages/HiKMR3hduYzMFx9TpRIO" %}
[Página de suporte](/guide/documentacao/faq/conexao-whatsapp/acessar-pagina-de-suporte)
{% endcontent-ref %}

{% content-ref url="/pages/B4lmY6pX3P91JJ1ABHdT" %}
[Erros comuns](/guide/documentacao/faq/conexao-whatsapp/erros-e-problemas)
{% endcontent-ref %}


# Portfólio Empresarial

Guias para criar, configurar e gerenciar seu Portfólio Empresarial (Meta Business Manager).

O **Portfólio Empresarial** (Meta Business Manager) é uma plataforma centralizada para gerenciar todos os ativos digitais da sua empresa, incluindo páginas do Facebook, contas de anúncios, contas do Instagram, contas de WhatsApp e catálogos de produtos. Esta seção contém guias para criar, configurar e gerenciar seu portfólio empresarial.

{% content-ref url="/pages/qPCYj9fUsWYSkKm80QbJ" %}
[Criar portfólio empresarial](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/criar-portfolio-empresarial)
{% endcontent-ref %}

{% content-ref url="/pages/gRaCpAGA6QPEeXvXMAZm" %}
[Verificar portfólio empresarial](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/verificar-portfolio-empresarial)
{% endcontent-ref %}

{% content-ref url="/pages/iViQ3pNIuXvanRt5kw18" %}
[Informações do portfólio](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/informacoes-do-portfolio)
{% endcontent-ref %}

{% content-ref url="/pages/WRKdlA4MQNtWywWhjDvt" %}
[Incluir administradores](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/incluir-administradores)
{% endcontent-ref %}

{% content-ref url="/pages/oVgdSnEiMCElEduRDeT0" %}
[Alterar logomarca do portfólio](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/alterar-logomarca-do-portfolio)
{% endcontent-ref %}

{% content-ref url="/pages/y781661h7PuhSu1QfT5h" %}
[Desativar autenticação em dois fatores](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/desativar-autenticacao-em-dois-fatores)
{% endcontent-ref %}

{% content-ref url="/pages/5ldUXXuXxCTR3MKciogg" %}
[Verificar domínio](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/verificar-dominio)
{% endcontent-ref %}

{% content-ref url="/pages/IM6U4gM1oEdLRqsir48U" %}
[Boas práticas para criação do portfólio](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/boas-praticas-para-criacao-do-portfolio)
{% endcontent-ref %}

{% content-ref url="/pages/9bunezPWyUEtpB8GdSOo" %}
[Excluir portfólio empresarial](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/excluir-portfolio-empresarial)
{% endcontent-ref %}


# Boas práticas para criação do portfólio

Diretrizes para criar e configurar seu portfólio empresarial de forma segura, evitando bloqueios e restrições da Meta.

Ao criar um **portfólio empresarial**, é importante seguir algumas diretrizes para evitar que a conta seja sinalizada por "automação" ou atividade incomum pela Meta. Este artigo reúne as principais recomendações para garantir uma configuração segura.

## Autenticidade do perfil pessoal

O portfólio empresarial deve ser criado a partir de um **perfil pessoal real e ativo**. A Meta sinaliza contas criadas apenas para abrir um portfólio como inautênticas.

* **Contas reais e ativas:** Use um perfil pessoal com nome autêntico e que já tenha algum tempo de atividade na plataforma.
* **Verificação de identidade:** Confirme sua identidade no perfil pessoal (enviando um documento oficial) antes de realizar ações administrativas mais complexas.
* **Autenticação de dois fatores (2FA):** É obrigatório que todos os administradores tenham o 2FA ativado. Esse é um dos principais sinais de segurança verificados pelos sistemas da Meta.

## Processo de configuração

Evite realizar muitas ações logo após a criação do portfólio. O ideal é seguir uma ordem gradual:

1. Criar o portfólio empresarial.
2. Aguardar um período de maturação (alguns dias).
3. Configurar as informações da empresa.
4. Gradualmente adicionar ativos e usuários.

**Adição de administradores**

* Comece apenas com o proprietário principal.
* Após a conta estar estabelecida, adicione novos administradores.
* Certifique-se de que todos utilizem perfis reais e seguros.
* Para incluir novos administradores, siga os passos em: [Incluir administradores](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/incluir-administradores)

**Verificação da empresa**

Caso você utilize recursos avançados, como a API Oficial do WhatsApp, é recomendável iniciar o processo de verificação do portfólio empresarial para comprovar a legitimidade da sua empresa perante a Meta. Para verificar o seu portfólio empresarial, siga os passos descritos em: [Verificar portfólio empresarial](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/verificar-portfolio-empresarial)

## O que evitar

* **Perfis compartilhados:** Evite que várias pessoas utilizem a mesma senha em um único perfil pessoal. Cada administrador deve possuir seu próprio acesso individual ao portfólio.
* **Conexões em massa:** Evite conectar muitos ativos simultaneamente (páginas, contas de anúncios, números de WhatsApp, etc.) em um portfólio recém-criado.
* **Ações em excesso:** Não adicione vários administradores, páginas e contas de anúncios no mesmo dia. Ações em grande volume em um portfólio novo podem acionar alertas de segurança da Meta.

{% hint style="info" %}
**Considerações Adicionais:**

* Seguir essas boas práticas reduz significativamente o risco de bloqueio ou restrição da conta.
* Caso o portfólio seja bloqueado, consulte o artigo [Revisão de banimento](/guide/documentacao/faq/conexao-whatsapp/erros-e-problemas/solicitar-revisao-de-banimento) para saber como solicitar uma análise.
  {% endhint %}


# Criar portfólio empresarial

Passo a passo para criar seu portfólio empresarial no Meta Business Manager e começar a gerenciar seus ativos digitais.

O **Meta Business Manager** é uma plataforma que ajuda empresas a gerenciar suas **páginas do Facebook**, **contas de anúncios** e **permissões de usuários** de forma centralizada e segura. Com um portfólio empresarial, você pode controlar suas campanhas publicitárias, contas de WhatsApp e ativos de forma profissional.

{% hint style="success" %}
**Pré-requisitos:**

* Ter uma **conta pessoal no Facebook**.
  {% endhint %}

## Passo 1: Acessar o site do Meta Business Manager

Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**

* Você precisa estar logado com uma conta pessoal do Facebook para acessar o painel, mesmo que o portfólio seja da sua empresa.
* No canto superior esquerdo, clique no nome do portfólio atual (ou na seta ao lado) para abrir o menu de seleção de portfólios, como mostrado na imagem abaixo.

![](/files/8LZj01Eq7JfkgqMvXuOO)

## Passo 2: Criar o portfólio empresarial

Ao acessar o site do **Meta Business Manager**, clique em **Criar um portfólio empresarial**.

Preencha o formulário com as informações solicitadas:

* **Nome do portfólio empresarial**: O nome oficial da sua empresa ou marca.
* **Nome**: O nome do responsável pela conta (geralmente você ou alguém da sua equipe).
* **Sobrenome**: O sobrenome do responsável pela conta (geralmente você ou alguém da sua equipe).
* **E-mail comercial**: Coloque o **e-mail da empresa** ou um **e-mail profissional** que você usará para gerenciar o **portfólio empresarial**.

Após preencher as informações, clique em **Criar**.

![](/files/UqjRw2AS5YywovH3IpNb)

## Passo 3: Adicionar pessoas ao portfólio

Adicione pessoas a este portfólio empresarial para que comecem a gerenciar os mesmos itens no Meta Business Suite. Esse passo é opcional.

* Informe o e-mail da pessoa que deseja adicionar.
* Defina o tipo de acesso.
* Clique em avançar, ou caso não queira adicionar ninguém, basta pular esse passo.

<figure><img src="/files/XFvl9SLt0Bg80IPyqCLV" alt=""><figcaption></figcaption></figure>

## Passo 4: Validar seu portfólio comercial

* Confira as informações na tela.
* Clique em **Confirmar**.

<figure><img src="/files/eRTwoyCdSFAOwkznQzZD" alt=""><figcaption></figcaption></figure>

Seu **portfólio empresarial** foi criado! Agora você pode começar a gerenciar suas **páginas**, **contas de anúncios** e muito mais.

Se precisar adicionar mais **páginas** ou **contas de anúncios**, pode fazer isso diretamente nas **configurações do portfólio empresarial.**

![](/files/dQ7Xs7T7UN628G8ALLAf)

{% hint style="info" %}
**Considerações Adicionais:**

* Criar um **portfólio empresarial** é um passo fundamental para quem deseja ter **controle total** sobre suas **campanhas de anúncios** no **Facebook** e **Instagram**, **contas de WhatsApp**, além de organizar todos os **ativos da empresa** de forma eficiente.
  {% endhint %}


# Verificar portfólio empresarial

Guia completo para verificar seu portfólio empresarial na Meta e obter acesso a funcionalidades avançadas.

A verificação do **portfólio empresarial** é essencial para aumentar a segurança e a credibilidade do seu negócio dentro das plataformas da Meta. Esse processo permite acesso a funcionalidades avançadas e melhora a confiança de clientes e parceiros.

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso com controle total do **portfólio empresarial.**
* Ter um **site válido** e funcional associado ao seu negócio.
* Ter um **domínio verificado** na Meta.
* Possuir informações comerciais precisas, como razão social, CNPJ e endereço.
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Iniciar a verificação

* Selecione a opção "**Centro de Segurança"**, localize a opção "**Verificação da Empresa**".
* Clique em "**Iniciar Verificação**".

![](/files/fZgv15JncmO1baSuhaoi)

## Passo 3: Começar o processo

* Uma nova aba será aberta. Clique em **"Começar"**.

![](/files/Swe8RnvW5QBwhTjY5tfy)

## Passo 4: Enviar as informações da empresa

* Informe em qual país a empresa está localizada.
* Informe o Tipo da empresa (individual, corporação, etc).
* Informe se sua empresa tem registro oficial.
* Informe o **nome legal da empresa** conforme registrado.
* Forneça um **CNPJ válido** (para empresas brasileiras).
* Envie um **comprovante de endereço** ou outro documento oficial.
* Caso solicitado, envie **documentação adicional** para confirmação.

## Passo 5: Revisar e avançar

* Após preencher todos os dados solicitados, clique em **Avançar**.
* Uma tela de revisão será exibida. Confira os detalhes e clique em **Avançar**.

![](/files/YtiGKLQQVPSFRGxPQkFd)

## Passo 6: Acompanhar a verificação

Após enviar os documentos, acompanhe o status da verificação dentro do **Centro de Segurança**. O processo pode levar alguns dias e, caso haja pendências, a Meta enviará uma notificação com instruções.

Caso sua solicitação seja recusada, revise os documentos enviados e tente novamente seguindo as recomendações fornecidas pela Meta.

{% hint style="info" %}
**Considerações Adicionais:**

* Certifique-se de que todas as informações da empresa estejam **atualizadas e corretas**.
* Utilize **documentos oficiais legíveis e em boa qualidade**.
* Se necessário, entre em contato com o suporte da Meta para assistência adicional.
  {% endhint %}


# Verificar domínio

Como verificar o domínio da sua empresa no Meta Business Manager para liberar funcionalidades avançadas.

A verificação de domínio confirma que sua empresa é a proprietária legítima do site informado no **portfólio empresarial**. Esse processo é exigido pela Meta para liberar funcionalidades avançadas, como a personalização de links de mensagens e a verificação do portfólio.

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso com controle total do **portfólio empresarial**.
* Possuir um **site ativo** com **certificado de segurança (HTTPS)**.
* Ter acesso ao **painel de hospedagem** do site (para adicionar um registro DNS ou fazer upload de um arquivo HTML).
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar a seção de domínios

* No menu lateral esquerdo, localize e clique em **"Adequação e segurança para marcas".**
* Em seguida, selecione **"Domínios"**.

<figure><img src="/files/ugw59v3H0sMdxUj0Xmht" alt=""><figcaption></figcaption></figure>

## Passo 3: Adicionar o domínio

* Clique em **"Adicionar"**
* Clique em **"Criar domínio"**.

<figure><img src="/files/vCsxrfitXwkE07HzVUF0" alt=""><figcaption></figcaption></figure>

## Passo 4: Inserir domínio

* Insira o domínio do site da sua empresa (por exemplo: `www.suaempresa.com.br`).
* Clique em **Adicionar.**

<figure><img src="/files/5nrorEFprLEoLVmIsjcZ" alt=""><figcaption></figcaption></figure>

## Passo 5: Escolher o método de verificação

A Meta oferece três métodos para verificar a propriedade do domínio:

* **Verificação por meta-tag HTML:** Adicione uma tag `<meta>` fornecida pela Meta na seção `<head>` da página inicial do seu site.
* **Verificação por arquivo HTML:** Faça o upload de um arquivo HTML fornecido pela Meta na raiz do seu site.
* **Verificação por registro DNS (TXT):** Adicione um registro TXT fornecido pela Meta nas configurações de DNS do seu domínio.

{% hint style="info" %}
**Dica:** O método mais comum e recomendado é a **verificação por registro DNS (TXT)**, pois não exige alterações no código do site.
{% endhint %}

## Passo 6: Aplicar a verificação

* Após escolher o método e aplicar as configurações necessárias, volte à tela de verificação no Meta Business Manager.
* Clique em **"Verificar domínio"**.

<figure><img src="/files/olcOQhEgzSXvSSluU5Vu" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
A propagação do registro DNS pode levar até **72 horas**. Se a verificação falhar na primeira tentativa, aguarde e tente novamente.
{% endhint %}

## Passo 7: Confirmar a verificação

Após a verificação ser concluída com sucesso, o domínio aparecerá com o status **"Verificado"** na lista de domínios do seu portfólio empresarial.

{% hint style="info" %}
**Considerações Adicionais:**

* A verificação de domínio é um **requisito para a verificação do portfólio empresarial**.
* Caso o site da empresa mude de endereço, será necessário verificar o novo domínio.
* Mantenha o registro DNS ou a meta-tag ativa. Se for removida, a verificação pode ser invalidada.
  {% endhint %}


# Informações do portfólio

Como acessar e editar as informações da sua empresa no Meta Business Manager.

O **portfólio empresarial** no **Meta Business Manager** é a seção onde você organiza todos os ativos e recursos digitais da sua empresa, como **páginas do Facebook**, **contas de anúncios**, **contas do Instagram**, **contas de WhatsApp** e **catálogos de produtos**.

{% hint style="success" %}
**Pré-requisitos:**

* Ter uma **conta pessoal no Facebook**
* Ter acesso ao **Meta Business Manager.**
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar as informações da empresa

* Na lateral esquerda no topo, clique em **Informações da empresa.**

<figure><img src="/files/uFpQ9NjPYFQKPXkmWcbP" alt=""><figcaption></figcaption></figure>

## Passo 3: Editar as informações da empresa

* Na primeira seção, clique no ícone para editar as informações da sua empresa.
* Faça o upload da **Foto do portfólio empresarial.**
* Preencha **Nome da empresa** e **Página principal.**

<figure><img src="/files/w9PYWr6SylpKQNABW4US" alt=""><figcaption></figcaption></figure>

## Passo 4: Preencher os detalhes da empresa

* Na segunda seção, clique em **Editar**.
* Preencha todos os campos abaixo corretamente, pois é imprescindível que esses dados estejam completos e que o **site da empresa** esteja ativo e com **certificado de segurança**.

<figure><img src="/files/6oytuMkqy3DCjCrsYiqU" alt=""><figcaption></figcaption></figure>

![](/files/wLAfwjjYrUROjjlioJ4R)

* Após o preenchimento, clique em **Salvar**.

## Passo 5: Conferir as informações da empresa

![](/files/FAAV2k4DJ0ppgmDjIrPR)

{% hint style="info" %}
**Considerações Adicionais:**

* Mantenha as informações da empresa sempre atualizadas para garantir o bom funcionamento das integrações e dos ativos vinculados ao portfólio.
  {% endhint %}


# Incluir administradores

Passo a passo para convidar novos administradores ao seu portfólio empresarial na Meta.

Administradores no **portfólio empresarial** têm permissões avançadas para gerenciar os ativos da empresa, adicionar novos usuários, atribuir funções e realizar configurações gerais. É importante garantir que apenas pessoas de confiança recebam essa função, pois elas terão acesso completo às configurações da conta.

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso com controle total do **portfólio empresarial.**
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Convidar pessoas

* No painel principal, clique na opção **Pessoas**.
* Em seguida, selecione a opção **+ Convidar Pessoas.**

![](/files/PQpynHDc9J5YccZQ9Qjr)

## Passo 3: Informar o e-mail do convidado

* Uma nova aba se abrirá. Preencha o e-mail da pessoa que será convidada para o **portfólio empresarial**.
* Clique em **Avançar**.

![](/files/OGkX8KPEFpY403idEwsz)

## Passo 4: Definir o perfil de acesso

Na aba seguinte, defina o **perfil de acesso** do convidado. Você pode escolher entre:

* **Parcial (Básico):** Permissões limitadas para tarefas específicas.
* **Apps e Integrações:** Acesso voltado para gerenciar aplicativos e integrações da empresa.
* **Controle Total:** Permissão completa para gerenciar todos os ativos e configurações do **portfólio empresarial.**

Após definir o perfil, clique em **Avançar**.

![](/files/w0kEOx7vDYxbSKvOZavO)

## Passo 5: Definir os ativos de negócio

* Na aba, defina quais **ativos de negócio** o convidado terá acesso, como **páginas**, **contas de anúncios**, **catálogos de produtos** ou outros recursos disponíveis.
* Após definir, clique em **Avançar**.

![](/files/CVHOdUm0vKqdC1B5smvY)

## Passo 6: Revisar e enviar o convite

* Na última aba, revise todas as **informações preenchidas no convite** para garantir que estão corretas antes de enviá-lo.
* Clique em **enviar convite**.

![](/files/kBX2EXBpRiyDgSZljhOl)

## Passo 7: Confirmação do envio

* Uma tela de confirmação do envio do convite será exibida.
* Após isso, a lista de usuários do **portfólio empresarial** será atualizada, exibindo o novo convidado com o status '**Pendente**', até que ele aceite o convite.

![](/files/Ol2OzE3h8GQVHnvjwEtZ)

{% hint style="info" %}
**Considerações Adicionais:**

* **Conceda acesso com responsabilidade:** adicione administradores apenas quando necessário e certifique-se de que sejam pessoas de confiança.
* **Revise regularmente os acessos:** é recomendável revisar periodicamente a lista de usuários para garantir que somente pessoas autorizadas tenham acesso.
* **Permissões específicas:** caso não queira conceder permissões totais, você pode adicionar a pessoa com um período predefinido.
  {% endhint %}


# Alterar logomarca do portfólio

Guia para alterar a foto de perfil e a logomarca do WhatsApp no portfólio empresarial da Meta.

Alterar a logomarca no **portfólio empresarial** da Meta ajuda a manter a identidade visual da sua empresa atualizada nos diferentes canais de comunicação. Veja abaixo como realizar essa alteração.

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso com controle total do **portfólio empresarial**.
* **Formatos de Arquivo**: Utilize formatos como **PNG, JPEG** ou **SVG**
* **Tamanho do Arquivo**: Mantenha o tamanho do arquivo menor que **200 KB**
* **Dimensões**: Para uso em redes sociais e sites, um tamanho comum é **1024 x 1024 pixels**
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar a configuração do WhatsApp

* No menu lateral esquerdo, localize e clique em "**Contas do WhatsApp**".
* Em seguida, role o cursor da lateral direita até o fim e clique em "**Gerenciador de WhatsApp**".

<figure><img src="/files/ZDdyB9siIcvZnTchi7Wu" alt=""><figcaption></figcaption></figure>

## Passo 3: Acessar o gerenciador do WhatsApp

* Uma nova aba será exibida. Clique em **"Número de telefone".**
* Em seguida, selecione o ícone de **engrenagem** localizado ao lado do número de telefone.

![](/files/0u4rrG2XjNxyIaY1GCbS)

## Passo 4: Editar o perfil do WhatsApp

* Dentro das configurações do número selecionado, localize a seção **"Perfil"**.
* Clique no menu Perfil e, logo abaixo do texto **Foto do perfil**, clique no botão escolher arquivo.

![](/files/cjwdkcoV48DsKsXdIXhC)

## Passo 5: Alterar descrição e informações adicionais

* Para alterar descrição ou demais informações, role o cursor e na opção **"Descrição"** você pode inserir as informações que deseja.

![](/files/lV9CrEinrTbQgFjtxLh7)

{% hint style="info" %}
**Considerações Adicionais:**

* Ao seguir os passos acima, a logomarca e as informações do perfil do WhatsApp da sua empresa estarão atualizadas em todas as plataformas.
  {% endhint %}


# Desativar autenticação em dois fatores

Como desativar temporariamente a autenticação em dois fatores (2FA) no portfólio empresarial da Meta.

A autenticação em dois fatores (2FA) é uma camada adicional de segurança exigida pela Meta para acessar ativos no **portfólio empresarial**. Em algumas situações, como quando um novo membro da equipe precisa ser adicionado ou quando há dificuldades de acesso à conta, pode ser necessário **desativar temporariamente essa exigência**.

{% hint style="danger" %}
Importante: Essa alteração afeta **todas as pessoas que têm acesso ao Portfólio empresarial**. Recomendamos reativar a exigência assim que o processo necessário for concluído.
{% endhint %}

{% hint style="success" %}
**Pré-requisitos:**

* Ter **perfil de administrador do Portfólio empresarial**.
* Ter acesso ao [**Gerenciador de Negócios da Meta**](https://business.facebook.com/).
* A autenticação em dois fatores deve já estar **ativada para ao menos um usuário**, caso contrário, a opção de desativação não estará visível.
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar o gerenciador do WhatsApp

* No menu lateral esquerdo, localize e clique em "**Contas do WhatsApp**".
* Em seguida, role o cursor da lateral direita até o fim e clique em "**Gerenciador de WhatsApp**".

<figure><img src="/files/ZDdyB9siIcvZnTchi7Wu" alt=""><figcaption></figcaption></figure>

## Passo 3: Selecionar o número de telefone

* Uma nova aba será exibida. Clique em **"Número de telefone"**.
* Em seguida, selecione o ícone de **engrenagem** localizado ao lado do número de telefone.

![](/files/0u4rrG2XjNxyIaY1GCbS)

## Passo 4: Localizar a confirmação em duas etapas

* Dentro das configurações do número selecionado, localize a seção **"confirmação em duas etapas"**.

<figure><img src="/files/IYgsAF6eerUU7vuQMHA8" alt=""><figcaption></figcaption></figure>

## Passo 5: Desativar a confirmação

* Clique na opção **"Desativar confirmação em duas etapas"**.

![](/files/D4qrcDNXWnQgvrubZTjg)

## Passo 6: Confirmar a desativação

* Um pop-up será exibido na tela. Clique em **"OK"** para prosseguir e receber o código de confirmação.

![](/files/2850b0uyDUsFriInDWnf)

## Passo 7: Verificar o e-mail

* Verifique se o e-mail com as instruções foi recebido e siga as orientações indicadas.

<figure><img src="/files/kpcwYGi1UsGR42DLZRs7" alt=""><figcaption></figcaption></figure>

## Passo 8: Confirmar os dados

* Uma nova tela será exibida com a confirmação dos dados.
* Clique na opção **"Desativar a confirmação em duas etapas"** para concluir o processo.

<figure><img src="/files/Uj2hFZxFEkkqkgnfHDYB" alt=""><figcaption></figcaption></figure>

## Passo 9: Confirmação final

* Será exibido um pop-up de confirmação da desativação.

<figure><img src="/files/lsfyD1oeHPCIMbHkIcVc" alt="" width="391"><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* A autenticação em dois fatores **não é obrigatória para o uso do Gerenciador de Negócios**, mas pode ser exigida em alguns processos, como a criação de contas de anúncio ou configurações da API.
* Reative a 2FA após concluir o processo desejado, para garantir a segurança da conta.
  {% endhint %}


# Excluir portfólio empresarial

Como excluir um portfólio empresarial no Meta Business Manager e quais cuidados tomar antes de realizar essa ação.

Excluir um **portfólio empresarial** é uma ação permanente que remove todos os ativos vinculados à conta, incluindo **páginas**, **contas de anúncios**, **contas de WhatsApp** e **catálogos de produtos**. Antes de prosseguir, certifique-se de que realmente deseja realizar essa exclusão.

{% hint style="danger" %}
**Atenção:** A exclusão do portfólio empresarial é **irreversível**. Todos os ativos, permissões e históricos vinculados serão perdidos. Se o seu número de WhatsApp estiver conectado a este portfólio, ele será desvinculado e poderá levar até **24 a 48 horas** para ser liberado para uso em outro portfólio.
{% endhint %}

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso com **controle total** do **portfólio empresarial**.
* Garantir que não há **pendências financeiras** em contas de anúncios vinculadas.
* **Desvincular** os números de WhatsApp e outros ativos que deseja preservar antes de excluir.
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar as informações do portfólio

* No menu lateral esquerdo, clique em **"Informações da empresa"**.
* Nessa tela, você verá os dados do seu portfólio empresarial.

<figure><img src="/files/QcHbyinPfScJ3FZRjFYp" alt=""><figcaption></figcaption></figure>

## Passo 3: Solicitar a exclusão

* No canto superior direito localize a opção **"Excluir portfólio empresarial permanentemente"**.
* Clique nessa opção.

<figure><img src="/files/snavhBTofh8Lkhqt1pBL" alt=""><figcaption></figcaption></figure>

## Passo 4: Confirmar a exclusão

* A Meta exibirá um aviso informando as consequências da exclusão. Leia atentamente e, se tiver certeza, confirme a ação.

<figure><img src="/files/D7ZC3Ofk1KUKKuyaLJQW" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Se houver **contas de anúncios com saldo pendente** ou **campanhas ativas**, será necessário resolver essas pendências antes de concluir a exclusão.
{% endhint %}

## Passo 5: Aguardar o processamento

Após a confirmação, o portfólio entrará em um período de exclusão. Durante esse período, alguns ativos podem levar até **24 a 48 horas** para serem completamente removidos.

{% hint style="info" %}
**Considerações Adicionais:**

* Antes de excluir, considere **transferir ativos** (páginas, números de WhatsApp) para outro portfólio empresarial, caso deseje mantê-los.
* Se a exclusão ocorreu por engano, entre em contato com o [suporte da Meta](https://www.facebook.com/business/help) o mais rápido possível. Em alguns casos, a ação pode ser revertida dentro de um prazo limitado.
* **Nunca exclua o portfólio como tentativa de resolver um banimento.** Isso pode transformar um bloqueio temporário em permanente.
  {% endhint %}


# CloudAPI

Guias para conectar, configurar e gerenciar seu canal WhatsApp via Cloud API (API Oficial da Meta).

A **Cloud API** é a API oficial da Meta para o WhatsApp Business. Com ela, sua empresa pode enviar e receber mensagens de forma segura e escalável, usando a infraestrutura direta da Meta. Nessa modalidade de conexão, o número fica dedicado exclusivamente à API, portanto não é possível continuar utilizando o aplicativo WhatsApp Business com o mesmo número. Esta seção reúne os guias para conectar o canal, ajustar o perfil comercial, alterar o display name, realizar portabilidade de número e remover o número do portfólio.

{% content-ref url="/pages/nwcUPSHpX9vjr4cRlhTG" %}
[Conectar Canal](/guide/documentacao/faq/conexao-whatsapp/cloudapi/conexao-whatsapp-cloud-api)
{% endcontent-ref %}

{% content-ref url="/pages/8m0gMieQIw6Xi6P7fYDM" %}
[Portabilidade de número](/guide/documentacao/faq/conexao-whatsapp/cloudapi/portabilidade-de-numero)
{% endcontent-ref %}

{% content-ref url="/pages/WJ40zPKXgDb2CVlDPlhQ" %}
[Display name](/guide/documentacao/faq/conexao-whatsapp/cloudapi/alterar-display-name)
{% endcontent-ref %}

{% content-ref url="/pages/YU5e22oW60SvMhNy0hth" %}
[Perfil do WhatsApp](/guide/documentacao/faq/conexao-whatsapp/cloudapi/alterar-perfil-do-whatsapp)
{% endcontent-ref %}

{% content-ref url="/pages/6eooXdShS6L9tC8njEAO" %}
[Remover número](/guide/documentacao/faq/conexao-whatsapp/cloudapi/remover-numero-do-portfolio)
{% endcontent-ref %}


# Conectar Canal

Passo a passo para conectar seu número de WhatsApp à plataforma pela Cloud API da Meta.

A conexão **WhatsApp Cloud API** da **plataforma** é o método tradicional utilizado para vincular sua conta de WhatsApp à plataforma de forma segura e eficiente. Esse processo é essencial para garantir a comunicação entre a API e o WhatsApp Business, permitindo o envio e recebimento de mensagens dentro do sistema.

{% hint style="success" %}
**Pré-requisitos:** Antes de iniciar a conexão **WhatsApp Cloud API**, certifique-se de atender aos seguintes requisitos:

* **Número disponível:** Ter um número de telefone cadastrado no **WhatsApp Business**.
* **Desconexão do Aplicativo:** O número não pode estar conectado ao aplicativo WhatsApp no celular. Se estiver, você deverá desconectar a conta no app antes de finalizar o processo.
* **Portfólio Empresarial:** Ter um Gerenciador de Negócios (Meta Business Suite) configurado.
* **Perfil Administrador:** Ser um usuário com perfil de administrador na plataforma e no Facebook.
* **Recebimento de Código:** Ter acesso ao número para receber o código de verificação via SMS ou Ligação Telefônica.
  {% endhint %}

## Passo 1: Iniciando a Integração

* No menu superior da plataforma, clique em Ajustes -> Conta.

<figure><img src="/files/S8OW9vVBgZyV92CCDcvt" alt=""><figcaption></figcaption></figure>

* Clique na aba **Canais de Atendimento** e em seguida clique no botão de adição **(+)**, navegue até WhatsApp CloudAPI e selecione Cloud Meta.

<figure><img src="/files/YD3hFiOB95lZjctTyWVL" alt=""><figcaption></figcaption></figure>

## Passo 2: Configuração do Número

* Selecione a opção Conectar novo número.

{% hint style="warning" %}
**Atenção:** Ao vincular o número na Cloud API, você não poderá mais utilizá-lo no aplicativo do WhatsApp.
{% endhint %}

<figure><img src="/files/4dNE8C4qtoEmsSngrpjk" alt=""><figcaption></figcaption></figure>

* Na tela de parceria, clique em Entrar com Facebook para iniciar o onboarding oficial.

![](/files/DFXyAH79NqtspUmehJdD)

<figure><img src="/files/PS7mMfRGw5CUOs9ugh2u" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/O6vXK6VBka3qKG7CtoaF" alt=""><figcaption></figcaption></figure>

## Passo 3: Autenticação e Dados Empresariais

* Realize o login na conta do Facebook que administra seu Gerenciador de Negócios.
* Selecione o Portfólio empresarial correspondente.
* Confira os dados da empresa (Nome, Site e País) e clique em Avançar.

## Passo 4: Selecionar portfólio

* Selecione o **"Portfólio empresarial"** e confira os **dados da empresa** (nome, site e país).
* Em seguida clique em **"Avançar"**.

<figure><img src="/files/fvjB1UBaOqAfPDyKDiaQ" alt="" width="345"><figcaption></figcaption></figure>

* Informe o número do País (BR+55) e insira o número que deseja conectar.

![](/files/R9q34dPj7Dpq8lopJ5qP)

* Clique em **Avançar**.

## Passo 5: Confirme o código OTP

* A Meta enviará um código para o **"aplicativo do WhatsApp"**.
* Insira o código recebido e clique em **"Avançar"**.

<div data-full-width="true"><img src="/files/1pnnBM1F1k3MxlpN4C0e" alt=""></div>

## Passo 6: Confirmar nome da conta

* Confirme o **Display name** e o **fuso horário.**
* Em seguida clique em **"Avançar"**.

![](/files/QwRGkTFYZZubuYm8gGJL)

#### Validação do Número (Migração)

* Informe o código do país (BR +55) e insira o número que deseja conectar.
* Importante: O sistema detectará se o número está ativo em um aparelho. Você precisará confirmar a saída do aplicativo móvel para prosseguir.
* Escolha o método de recebimento do código de verificação de 6 dígitos: SMS ou Ligação Telefônica.
* Insira o código recebido para finalizar a criação da sua WABA (WhatsApp Business Account).
* Recebimento do código de verificação. Uma mensagem será enviada para o **WhatsApp Business** com um código de 6 dígitos.
* Insira o código de 6 dígitos recebido no WhatsApp Business e clique em **"Verificar"**.
* Clique em [**adicionar forma de pagamento**](/guide/documentacao/faq/conexao-whatsapp/pagamentos/configurar-pagamento) em seguida clique em **"Continuar"**.

![](/files/SQtYobu3UmINs7hpBj37)

## Passo 7: Selecione o número que está integrando

* Para finalizar a conexão, selecione o número que está integrando.
* Em seguida clique em **"Continuar".**

<figure><img src="/files/0Pc4tk0NwkNjYTbB5h70" alt=""><figcaption></figcaption></figure>

## Passo 8: Finalize a integração

* Clique em **"Finalizar"** para concluir o processo.

![](/files/Luky4jxeiK0dzvTBeaAl)

{% hint style="info" %}
**Considerações Adicionais:**

* **Este é o método de conexão recomendado quando o número não é elegível para conexão via QR Code.** A **Meta** avalia o histórico de uso do número e pode determinar que alguns números não são elegíveis para a conexão via QR Code. Caso isso aconteça, você deve utilizar este método (WhatsApp Cloud API).
* **Atualmente, o WhatsApp Desktop para Windows não é compatível com a Cloud API.** As mensagens enviadas e recebidas pelo WhatsApp Desktop deixarão de funcionar.
* **Neste método, o número precisará ser desconectado do WhatsApp Business App.** Diferente da conexão via QR Code, este método não permite o uso simultâneo do número no app e na API.
* **Neste momento, a sincronização de contatos, números e conversas ainda não está disponível.**
* Algumas funcionalidades não são suportadas na API Oficial, como **Canais, Status, Grupos, enquetes, eventos e localização em tempo real**.
* O número conectado via método convencional **não pode ser usado simultaneamente no WhatsApp Business App**.
  {% endhint %}

### O que altera no app WhatsApp Business

* **Não será possível usar o número no WhatsApp Business App enquanto estiver conectado à API.**
* Todos os outros dispositivos como **WhatsApp Web** serão desconectados, mas poderão ser reconectados após o vínculo;
* **Não será possível mais editar e excluir mensagens;**
* Mensagens que desaparecem e visualização única **não poderão** ser mais usadas;

**Documentação,** [**clique aqui**](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users)**.**


# Portabilidade de número

Como migrar seu número da API Oficial de outro provedor para a plataforma, mantendo histórico e qualidade.

Se sua empresa já utiliza um número conectado à API Oficial do WhatsApp com outro provedor e deseja migrar para a **plataforma**, é possível realizar a portabilidade do número sem perder o histórico de qualidade e mantendo a infraestrutura oficial da Meta.

Veja abaixo o passo a passo para garantir uma transição segura e dentro das diretrizes da Meta.

### O que é a portabilidade entre provedores da API Oficial?

Portabilidade, neste caso, significa migrar seu número da API Oficial de um provedor atual para a infraestrutura de API usada pela **plataforma**. É um processo técnico homologado pela Meta que permite que sua empresa mantenha o mesmo número, preservando o histórico de mensagens, qualidade e reputação da conta.

{% hint style="success" %}
**Pré-requisitos:**

* O número já está conectado à API Oficial da Meta com outro provedor;
* O número está vinculado a uma conta do **portfólio empresarial verificado;**
* Você tem acesso de administrador ao Gerenciador de Negócios da Meta;
* A **autenticação em dois fatores** da **WABA** está desativada.
* O número que será migrado deve estar ativo e habilitado para receber chamadas telefônicas e SMS, pois o código de verificação da Meta será enviado por um desses meios durante o processo de portabilidade.
* O display name precisa estar **aprovado**.
  {% endhint %}

{% hint style="danger" %}
**Atenção:** Antes de iniciar o processo de portabilidade, recomendamos verificar se o número exibe corretamente o ***display name*** (nome de exibição). Para isso, envie uma mensagem a partir de um número que nunca tenha interagido com ele.
{% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Conferir se o Portfólio empresarial é verificado

* Na lateral esquerda clique em **'Informações da empresa'**.
* Verifique o **Status de verificação da empresa**. Mais informações sobre como acessar o portfólio empresarial em: [Informações do portfólio](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/informacoes-do-portfolio)

![](/files/DDRyA1iY3PIW5oqmJpS9)

{% hint style="info" %}
Caso seu portfólio não esteja verificado, veja aqui como fazer a[ **verificação do portfólio empresarial**](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/verificar-portfolio-empresarial)
{% endhint %}

## Passo 3: Desative a autenticação em dois fatores.

* Siga os passos descritos neste manual para [Desativar a autenticação em dois fatores.](/guide/documentacao/faq/conexao-whatsapp/portfolio-empresarial/desativar-autenticacao-em-dois-fatores)

![](/files/D4qrcDNXWnQgvrubZTjg)

## Passo 4: Inicie a conexão de um número por portabilidade.

* Acesse a plataforma, clique em **"Ajustes" -> "Conta".**
* Clique na aba **"Canais de Atendimento"**, selecione o **botão "+"** para iniciar uma nova conexão com o WhatsApp via Cloud API.

![](/files/kkAilbWg8rS3hLkOPobB)

* Na tela seguinte selecione a opção de **Migrar número.**
* Em seguida clique em **Iniciar**.

![](/files/spJIRLDWrxVFvPLLV1o5)

* Na tela seguinte, revise atentamente as instruções para realizar a portabilidade. Se estiver tudo correto, clique em **"Continuar"** para prosseguir com o processo.

![](/files/wPNVl1k6LkbEWgQv3nP0)

* Digite o número a ser migrado.
* Clique em **Continuar**.

![](/files/qRyltuVzfbgipmNobfWj)

* Na tela seguinte faça login no **Facebook**.
* Clique em **Entrar com Facebook.**

<figure><img src="/files/PZmppxJNPdupHXK0idpy" alt=""><figcaption></figcaption></figure>

* Confirme a conta que deseja utilizar para o login.

<figure><img src="/files/83M3gPxqciBiUWYD8iAs" alt="" width="340"><figcaption></figcaption></figure>

* Após aceitar os termos de conexão com a Hunion.io, clique em **"Começar"** para prosseguir.

<figure><img src="/files/MtrUM2CbQraki6eFQI9I" alt="" width="348"><figcaption></figcaption></figure>

* Confira os dados da empresa e em seguida clique em **avançar.**

<figure><img src="/files/Uy617THsTvVwOHPGDl7D" alt="" width="344"><figcaption></figcaption></figure>

* Crie uma nova **Waba** para a qual o número será transferido, em seguida clique em **Avançar**.

<figure><img src="/files/XoKLZs2nVghnE2xutA55" alt="" width="414"><figcaption></figcaption></figure>

* Após aceitar os termos de acesso que a Hunion.io terá, clique em **"Continuar"** para prosseguir.

![](/files/AAPqXGB0eT8fD7lot9lY)

* Um novo pop-up será exibido informando que o processo foi concluído.
* Clique em **"Concluir"** para finalizar.

![](/files/QBA79ztbwVfHenwRoOO2)

* Retornando à plataforma, clique em **"Confirmação de configuração de pagamento"** ou acesse o Gerenciador de Negócios para definir a forma de pagamento.
* Após concluir essa etapa, clique em **"Continuar".**

![](/files/Bli6nKOGbR5mJHzMvxxO)

* Uma nova aba se abrirá clique em **"Confirmação de desativação da autenticação de dois fatores"** ou acesse o **Gerenciador de Negócios** para desativar a autenticação.
* Após concluir essa etapa, clique em **"Continuar".**

<figure><img src="/files/ojspCZjH4oJBydsjcJSU" alt=""><figcaption></figcaption></figure>

* Em seguida, selecione o meio pelo qual deseja receber o código de verificação.
* Clique em **"Continuar".**

<figure><img src="/files/vtY26skpsTVaTqs9hzOZ" alt=""><figcaption></figcaption></figure>

* Informe o código de verificação recebido e clique em **"Continuar"** para prosseguir com o processo.

![](/files/j1f9ax8jOVdX6HUOAI3k)

* Clique em **"Finalizar"** para concluir a configuração.

![](/files/Q3mr7ScFGa8mL2wlhu0v)

{% hint style="info" %}
**Considerações Adicionais:**

* É possível, e recomendado, migrar o número de **WABA** (conta do WhatsApp Business) porém NÃO é possível migrar o número de Portfólio Empresarial. Após a migração, o número continuará associado ao mesmo Gerenciador de Negócios em que já estava.
* Na Meta não tem como fazer migração / portabilidade de conta empresarial. Se sua intenção for mudar o número para outra BM, será necessário [desconectar o número da API Oficial](/guide/documentacao/faq/conexao-whatsapp/cloudapi/remover-numero-do-portfolio) e então fazer uma nova integração como se fosse um número novo.
* Se o número em implantação estiver conectado à URA (Unidade de Resposta Audível), será necessário desativar a URA para receber o código de verificação.
  {% endhint %}

{% hint style="info" %}
**O que é preservado na portabilidade?**

Ao fazer a portabilidade corretamente, são mantidos:

* A reputação da conta (qualidade);
* Os números verificados no Gerenciador de Negócios;
* Os templates (mensagens padrão) previamente aprovados;
* O histórico de relacionamento com a Meta.
  {% endhint %}


# Display name

Como alterar o nome de exibição (Display Name) do seu número de WhatsApp na API oficial da Meta.

O nome de exibição (Display Name) é a identificação pública do seu número de WhatsApp na API oficial. Ele aparece para os seus clientes e, por isso, deve estar alinhado à identidade da empresa. Se você precisa ajustar o nome exibido, a alteração pode ser feita diretamente no Gerenciador de Negócios (Business Manager) da Meta, seguindo os passos abaixo.

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso de administrador à conta do **portfólio empresarial** onde o número está cadastrado.
* Ter acesso ao **Gerenciador do WhatsApp Business** dentro do **portfólio empresarial**.
* O número já deve estar conectado à API oficial da Meta.
* A alteração do nome de exibição passará por uma nova análise da Meta, podendo levar até **48h úteis**.
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, clique em **"Configurações de Negócio"**.

<figure><img src="/files/RL1JOOM0AWj97jexwv4D" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar contas do WhatsApp

* No menu lateral esquerdo, localize e clique em "**Contas do WhatsApp**”.
* Em seguida, role o cursor da lateral direita até o fim e clique em “**Gerenciador de WhatsApp**”.

<figure><img src="/files/ZDdyB9siIcvZnTchi7Wu" alt=""><figcaption></figcaption></figure>

## Passo 3: Gerenciador do WhatsApp

* Uma nova aba será exibida. Clique em **"Número de telefone".**
* Em seguida, selecione o ícone de **engrenagem** localizado ao lado do número de telefone.

![](/files/0u4rrG2XjNxyIaY1GCbS)

## Passo 4: Edite as informações do perfil

* Uma nova tela será exibida. Selecione a opção **Perfil**, logo abaixo aparecerá a opção **Nome de Exibição.**
* Clique em **Editar.**

![](/files/YsyI25JL6zvdy23cMQBY)

* Digite o nome que deseja utilizar, não se esqueça de verificar se o nome segue as [diretrizes de nomenclatura do WhatsApp](https://web.facebook.com/business/help/338047025165344?_rdc=1&_rdr).
* Em seguida clique em **“Enviar”.** A alteração será analisada pela **Meta**.

<figure><img src="/files/56elchdMNQKKG5C3Hy94" alt="" width="554"><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* O novo nome de exibição [**deve seguir as diretrizes da Meta**,](https://web.facebook.com/business/help/338047025165344?_rdc=1&_rdr) que incluem estar relacionado ao nome da empresa e não conter termos genéricos ou que possam induzir o usuário ao erro.
* Durante a análise, o número continuará funcionando normalmente.
* Caso o nome de exibição seja reprovado, será necessário realizar uma nova solicitação com ajustes.
* Essa alteração **não afeta o número de telefone, histórico de mensagens ou as conexões da API**.
  {% endhint %}


# Perfil do WhatsApp

Como alterar foto, descrição, endereço e outras informações do perfil do WhatsApp no portfólio empresarial.

Alterar o perfil do WhatsApp no **portfólio empresarial** é essencial para manter as informações da sua empresa atualizadas, garantindo uma comunicação eficaz e profissional com seus clientes. O perfil do WhatsApp inclui dados como nome, descrição, endereço e site, e pode ser modificado diretamente pela plataforma.

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso com controle total do **portfólio empresarial.**
  {% endhint %}

### O que é o perfil do WhatsApp?

O perfil do WhatsApp é a informação visível para os clientes ao interagirem com sua empresa pelo aplicativo. Ele inclui:

* **Nome de exibição:** O nome da sua empresa.
* **Descrição:** Uma breve descrição dos serviços ou produtos oferecidos.
* **Endereço:** Localização da empresa.
* **Site:** URL do site oficial.

## Passo 1: Acessar o gerenciador de negócios.

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* Certifique-se de estar utilizando a conta vinculada ao WhatsApp que deseja editar.
* No painel principal do **portfólio empresarial**, clique em **"Configurações de Negócio"**.

<figure><img src="/files/RL1JOOM0AWj97jexwv4D" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar contas do WhatsApp

* No menu lateral esquerdo, localize e clique em "**Contas do WhatsApp**”.
* Em seguida, role o cursor da lateral direita até o fim e clique em “**Gerenciador de WhatsApp**”.

<figure><img src="/files/ZDdyB9siIcvZnTchi7Wu" alt=""><figcaption></figcaption></figure>

## Passo 3: Gerenciador do WhatsApp

* Uma nova aba será exibida. Clique em **"Número de telefone".**
* Em seguida, selecione o ícone de **engrenagem** localizado ao lado do número de telefone.

<figure><img src="/files/0u4rrG2XjNxyIaY1GCbS" alt=""><figcaption></figcaption></figure>

## Passo 4. Edite o Perfil do WhatsApp

Dentro das configurações do número selecionado, localize a seção **"Perfil"**.

Atualize os campos necessários, como:

* **Inserir foto de perfil:** escolha um arquivo com a imagem desejada.
* **Nome de Exibição:** Insira o nome que será exibido para os clientes, siga os passos em [Display name](/guide/documentacao/faq/conexao-whatsapp/cloudapi/alterar-display-name).
* **Descrição:** Informe ou atualize a descrição da empresa.
* **Categoria:** Informe ou atualize a área de atuação da empresa.
* **Endereço e Localização:** Altere o endereço comercial, se necessário.
* **Site:** Insira ou atualize a URL oficial da empresa.

![](/files/hG5xRnq2zU8QSP4dEWLJ)

## Passo 5: Salve as informações alteradas

* Após realizar as edições desejadas, clique em **salvar**.

<figure><img src="/files/tpKaMnzBrPLnAEgy87n0" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Pontos de Atenção:**

* **Análise de Nome de Exibição:** A Meta pode levar até 24 horas para aprovar alterações no nome de exibição, garantindo que ele siga as diretrizes da plataforma.
* **Consistência:** Certifique-se de que as informações editadas estão consistentes com os dados da sua empresa, como CNPJ, endereço e site.
* **Revisões Periódicas:** Atualize o perfil sempre que houver mudanças no nome, endereço ou descrição da empresa, para manter a comunicação alinhada com sua marca.
  {% endhint %}

{% hint style="info" %}
**Considerações Adicionais:**

* Alterar o perfil do WhatsApp no **portfólio empresarial** é um processo simples, mas que exige atenção aos detalhes para garantir que as informações transmitam profissionalismo e estejam em conformidade com as políticas da **Meta**.
  {% endhint %}


# Remover número

Como remover um número de telefone da conta do WhatsApp Business (WABA) no Meta Business Manager.

Em determinadas situações, pode ser necessário **remover um número de telefone da conta do WhatsApp Business (WABA)** dentro do **Business Manager da Meta**, seja para substituição, reorganização de estrutura ou reonboarding. A remoção do número libera o uso dele em uma nova conexão com a API oficial, mas deve ser feita com atenção para evitar perda de dados.

{% hint style="success" %}
**Pré-requisitos:**

* Ter **acesso de administrador** ao **portfólio empresarial** onde o número está configurado.
* O número deve estar vinculado a uma **conta de WhatsApp Business (WABA)** ativa.
* Verifique se não há **cobranças** ou **pendências financeiras** atreladas ao número antes de prosseguir com a remoção.
* Tenha ciência de que, ao remover o número, **todas as mensagens, sessões e templates relacionados a ele serão perdidos**.
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Acesse Contas do WhatsApp

* No menu lateral esquerdo, localize e clique em "**Contas do WhatsApp**”.
* Em seguida, role o cursor da lateral direita até o fim e clique em “**Gerenciador de WhatsApp**”.

<figure><img src="/files/IvSqlkxwqZe6MHKQe8zd" alt=""><figcaption></figcaption></figure>

## Passo 3: Gerenciador do WhatsApp

* Uma nova aba será exibida.
* Clique no ícone de **lixeira** localizado ao lado do número de telefone.

![](/files/quk3vB4Lq5ElJDG2u5CZ)

## Passo 4: Confirmar exclusão

{% hint style="danger" %}
Este processo é irreversível. Leia atentamente as instruções exibidas na tela antes de prosseguir com a exclusão.
{% endhint %}

* Uma janela pop-up será exibida para confirmar a exclusão do número.
* Clique em **“Avançar”** para prosseguir com a remoção.

![](/files/lsPFscsfudCt0VD9ZwnP)

## Passo 5: Excluir a WABA (WhatsApp Business Account)

* Após remover o número da conta, acesse novamente o[ Gerenciador de Negócios da Meta](https://business.facebook.com/).
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.
* No menu lateral, clique em "**Contas do WhatsApp**" e selecione a **WABA** que deseja excluir.
* Em seguida, clique no ícone de três pontinhos no canto superior direito da tela.
* Será exibido um menu de opções. Selecione "**Remover do Portfólio Empresarial"** para iniciar o processo de exclusão.
* Uma janela pop-up será exibida para confirmar a exclusão da conta. Clique em **“Excluir conta”** para prosseguir com a remoção.

![](/files/A4gAdHsq9l6uAzf7X8h4)

{% hint style="info" %}
**Considerações Adicionais:**

* Após a remoção, o número **poderá ser reconectado** por QR Code oficial ou outro método suportado, respeitando as diretrizes da Meta.
* É recomendável fazer **backup de informações importantes antes da exclusão**, se necessário.
* A remoção não cancela automaticamente cobranças associadas ao uso da API, por isso é importante verificar a **fatura ativa** no Gerenciador de Pagamentos da empresa.
* Se a intenção é **migrar o número para outra conta da Meta ou provedor**, confirme que ele esteja totalmente desvinculado e tenha superado o tempo de retenção da Meta (em alguns casos, até 30 dias).
  {% endhint %}


# CloudAPI QR Code (Coexistência)

Guias para conectar, gerenciar e desconectar seu canal WhatsApp via Cloud API com leitura de QR Code.

A conexão via **Cloud API com QR Code** permite vincular seu número de WhatsApp à plataforma de forma rápida, escaneando um código QR diretamente pelo celular. Essa modalidade funciona em **coexistência**, ou seja, o número continua disponível no aplicativo WhatsApp Business ao mesmo tempo em que opera pela plataforma. Esta seção reúne os guias para conectar o canal, desativar contas de anúncio vinculadas e desconectar o número quando necessário.

{% content-ref url="/pages/me181AB0zISomz9AuAtS" %}
[Conectar Canal](/guide/documentacao/faq/conexao-whatsapp/cloudapi-qr-code/conexao-via-qr-code)
{% endcontent-ref %}

{% content-ref url="/pages/Mw7WSfgOWmsAKB4bdiII" %}
[Desativar contas de anúncio](/guide/documentacao/faq/conexao-whatsapp/cloudapi-qr-code/desativar-contas-de-anuncio)
{% endcontent-ref %}

{% content-ref url="/pages/pVYT2yxQS5cc7OvdOsGY" %}
[Desconectar](/guide/documentacao/faq/conexao-whatsapp/cloudapi-qr-code/remover-conexao-qr-code)
{% endcontent-ref %}


# Conectar Canal

Passo a passo para conectar seu número de WhatsApp à plataforma via QR Code (modo de coexistência).

A conexão via **QR Code (Coexistencia)** na **API Oficial** da **plataforma** é o método utilizado para vincular sua conta de WhatsApp à plataforma de forma segura e eficiente. Esse processo é essencial para garantir a comunicação entre a API e o WhatsApp Business, permitindo o envio e recebimento de mensagens dentro do sistema.

O processo completo envolve duas etapas principais: primeiro, adicionar o número ao portfólio empresarial através do Meta Business Manager e, em seguida, realizar a conexão na plataforma via QR Code.

{% hint style="success" %}
**Pré-requisitos:** Antes de iniciar a conexão via **QR Code**, certifique-se de atender aos seguintes requisitos:

* Ter um número de telefone cadastrado no **WhatsApp Business**.
* Ter um **Portfólio empresarial.**
* Ser um usuário com perfil de **administrador** na **plataforma**.
* Ter a página do **Facebook** atrelada a conta do **WhatsApp Business**.
* Ter acesso ao aplicativo **WhatsApp Business** no celular para receber o **código da Meta** e escanear o **QR Code**.
  {% endhint %}

## Conectar na plataforma via QR Code

Após adicionar o número ao portfólio empresarial, siga os passos abaixo para conectar na plataforma.

**Passo 1: Acesse a Integração do WhatsApp:** No menu principal da **plataforma**, clique em **"Ajustes"**. Em seguida, acesse **"Conta"**

<figure><img src="/files/n4ze8P4mzVHMruMs9V3G" alt=""><figcaption></figcaption></figure>

**Passo 2:** Em seguida clique em **“Canais de Atendimento”** e por fim no **ícone “** ![](/files/MkVq6xA8gMWZ2mkzdnsz)**”.**

![](/files/rofVCC6zZAHNsxPXor6M)

**Passo 3:** **Gerar o QR Code:** Dentro da seção de **“Canais de Atendimento”**, clique em **"WhatsApp QR Code" e “Cloud Meta (QRCode)”**.

![](/files/ULwfZrTB47QZZKn1iWhG)

**Passo 4:** Clique em **“Entrar com Facebook”.**

![](/files/DFXyAH79NqtspUmehJdD)

**Passo 5:** Faça login com sua conta **Facebook.**

![](/files/aknQVW0g9YCc2ShsKGAt) ![](/files/5S32oIpvJaFgFIBNhfha)

**Passo 6:** Selecione o “**Portfólio empresarial ”** e confira os **dados da empresa** (nome, site e país), em seguida clique em **“Avançar”**.

<figure><img src="/files/fvjB1UBaOqAfPDyKDiaQ" alt="" width="345"><figcaption></figcaption></figure>

**Passo 7:** Selecione sua configuração. Marque a opção "**Conecte seu app WhatsApp Business”** existente e clique em **“Avançar**”.

![](/files/OylRzJhLsOBvoYWJTGDm)

**Passo 8:** Informe o número do País (BR+55) e insira o número que deseja conectar.

![](/files/R9q34dPj7Dpq8lopJ5qP)

**Passo 9:** A Meta enviará um código para o “**aplicativo do WhatsApp”**. Insira o código recebido e clique em “**Avançar”**.

<div data-full-width="true"><img src="/files/1pnnBM1F1k3MxlpN4C0e" alt=""></div>

**Passo 10:** Confirme o **Display name** e o **fuso horário** em seguida clique em **“Avançar”**.

![](/files/QwRGkTFYZZubuYm8gGJL)

**Passo 11:** Conexão com a Hunion. Clique em **“continuar”** para seguir com a conexão.

![](/files/ilVaqTGlQdRRptn3xU31)

**Passo 12:** Leitura do **QR Code**. Chegará uma mensagem no **App do WhatsApp Business** para que você faça a leitura do **QR Code**.

![](/files/f5YgIFcBXUJjbP73rcf4)

**Passo 13:** Clique na mensagem recebida e leia o **QR Code**.

![](/files/R41JVLgU5IV41u016HlV)

**Passo 14:** Clique em [**adicionar forma de pagamento**](/guide/documentacao/faq/conexao-whatsapp/pagamentos/configurar-pagamento) em seguida clique em **"Continuar"**.

![](/files/SQtYobu3UmINs7hpBj37)

**Passo 15:** Para finalizar a conexão, selecione o número que está integrando e em seguida clique em **“Continuar”.**

<figure><img src="/files/0Pc4tk0NwkNjYTbB5h70" alt=""><figcaption></figcaption></figure>

**Passo 16:** Clique em **“Finalizar”** para concluir o processo.

![](/files/Luky4jxeiK0dzvTBeaAl)

{% hint style="info" %}
**Considerações Adicionais:**

* **Nem todos os números são elegíveis para conexão.** A **Meta** avalia o histórico de uso do número antes de permitir a vinculação à API Oficial. Caso o número não seja elegível, uma mensagem de aviso será exibida durante o processo de conexão, e o cliente deverá utilizar a conexão padrão.
* **O WhatsApp Desktop para Windows não será compatível após a migração.** As mensagens enviadas e recebidas pelo WhatsApp Desktop deixarão de funcionar.
* **Neste momento, a sincronização de contatos, números e conversas ainda não está disponível.**
* Algumas funcionalidades, como **Canais, Status, enquetes, eventos e localização em tempo real**, não são suportadas na **API Oficial**, porém ainda é possível continuar utilizando no APP.
* **O uso de modelos de mensagem e a janela de conversa/cobrança continuam seguindo as regras da API Oficial**, mas há a possibilidade de abrir a janela diretamente pelo app sem a necessidade de usar mensagens modelo.
* Após **reiniciar a conversa** com um contato pelo App, é necessário esperar o mesmo responder para continuar a conversa pela plataforma.
* Após **14 dias de inatividade**, a conexão será automaticamente desativada.
* **É possível vincular e desvincular o número a qualquer momento.**
  {% endhint %}

### O que altera no app WhatsApp Business

* **Não será possível** criar novas Listas de Transmissão, as listas de transmissão existentes se tornarão somente leitura.
* Todos os outros dispositivos como **WhatsApp Web** serão desconectados, mas poderão ser reconectados após o vínculo;
* Após o vínculo, **não será possível mais editar e excluir mensagens;**
* Mensagens que desaparecem e visualização única **não poderão** ser mais usadas;

**Documentação,** [**clique aqui**](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users)**.**


# Desativar contas de anúncio

Como localizar e desativar contas de anúncio criadas automaticamente durante a conexão via QR Code.

Durante o processo de conexão de um número de WhatsApp à **API Oficial da Meta via QR Code**, pode acontecer a criação automática de uma **conta de anúncios (Ads Account)** dentro do **Business Manager (BM)** vinculado ao número. Essa conta não é necessária para o uso da API e pode ser desativada para manter a organização do BM e evitar acúmulo de contas inativas.

{% hint style="success" %}
**Pré-requisitos:**

* Acesso ao **Business Manager** com permissões administrativas.
* Acesso à seção de **Configurações de Negócios** da Meta.
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* Faça login com o usuário administrador da conta.
* Selecione o **Business Manager (BM)** onde a conta de anúncio foi criada.
* Na lateral esquerda clique na opção: **Configurações.**

<figure><img src="/files/QzLiirh8FRqgbj6Py2Y6" alt=""><figcaption></figcaption></figure>

* Uma nova página será exibida, role a aba para baixo e selecione a opção **Configurações da conta de anúncio.**

<figure><img src="/files/8Bkmfmu95gpLc2NAwNPE" alt=""><figcaption></figcaption></figure>

## Passo 2: Desativar conta de anúncios

* Uma nova aba será exibida. Logo abaixo da seção "**Pagamentos da empresa".**
* Localize a opção **"Desativar conta de anúncios"** e clique nela.

<figure><img src="/files/SdPTgXHrB5ls63IfMDp8" alt=""><figcaption></figcaption></figure>

* Um pop-up será exibido. Selecione o motivo mais adequado para a desativação da conta.
* Em seguida, clique em **"Desativar conta de anúncios"**.
* A tela será atualizada e a conta removida.

<figure><img src="/files/vPcXJiZ3IESpl79FtKUM" alt="" width="496"><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* A criação automática da conta de anúncio pela Meta é parte do processo padrão e não interfere na funcionalidade do número conectado.
* Durante a conexão por QR Code Oficial, a Meta cria automaticamente uma nova conta de anúncios. Quando o limite de contas é atingido, novas conexões são bloqueadas. Para liberar espaço, desative manualmente as contas de anúncio que não estão em uso.
  {% endhint %}


# Desconectar

Como desconectar um número de WhatsApp conectado via QR Code pelo aplicativo WhatsApp Business.

Em determinadas situações, pode ser necessário **remover um número de telefone da conta WhatsApp Business** dentro do **aplicativo WhatsApp Business**, seja para substituição, reorganização de estrutura ou reonboarding. A remoção do número libera o uso dele em uma nova conexão com a API oficial, mas deve ser feita com atenção para evitar perda de dados.

{% hint style="success" %}
**Pré-requisitos:**

* Ter **acesso de administrador** ao **Portfólio empresarial** onde o número está configurado.
* Ter acesso ao aparelho onde o número está conectado via **QR Code.**
* Tenha ciência de que, ao remover o número, **todas as mensagens, sessões e templates relacionados a ele serão perdidos**.
  {% endhint %}

## Passo 1: Acesse o aplicativo WhatsApp Business no celular.

* Na tela inicial Toque nos três pontinhos no canto superior direito.

<figure><img src="/files/KTTYSsUYW4vTVoFhxezW" alt="" width="204"><figcaption></figcaption></figure>

* Clique na opção **Configurações**.

![](/files/ZH0vFpoIEdDQPecYsqVy)

* Clique na opção **Conta**.

<figure><img src="/files/BNj2tcFGYW8V0iYFmbJp" alt="" width="203"><figcaption></figcaption></figure>

* Clique na opção **Plataforma Comercial**

<figure><img src="/files/lMMvq3hRzhjm8YbqcWMU" alt="" width="260"><figcaption></figcaption></figure>

## Passo 2: Desconectar

* O parceiro Hunion será exibido na tela.
* Clique na opção "**Toque para desconectar".**

![](/files/tQSWUIfezPtf53tjG6MC)

* Aparecerá uma nova tela com a opção **desconectar**, clique em **avançar**

<figure><img src="/files/ZMtLE1imKvvhayeNd2if" alt="" width="195"><figcaption></figcaption></figure>

* Aparecerá uma nova tela com a confirmação da desconexão.
* Clique em **Desconectar.**

![](/files/Ygqd2Fi5VKiN2R8zdfzX)

* Por fim, a tela de **nova conexão será exibida**, confirmando que a **conexão anterior foi encerrada** e permitindo que um novo dispositivo seja conectado.

![](/files/Bu9lluvXBgECd6fwUVwV)

{% hint style="info" %}
**Considerações Adicionais:**

* Após a remoção, o número **poderá ser reconectado** por QR Code oficial ou outro método suportado, respeitando as diretrizes da Meta.
* É recomendável fazer **backup de informações importantes antes da exclusão**, se necessário.
* Essa ação encerra o acesso via QR Code (como o WhatsApp Web ou outras ferramentas que usam esse método).
* Se a intenção é **migrar o número para outra conta da Meta ou provedor**, confirme que ele esteja totalmente desvinculado e tenha superado o tempo de retenção da Meta (em alguns casos, até 30 dias).
  {% endhint %}


# Pagamentos

Guias para configurar pagamentos e consultar extratos de conversas na API Oficial do WhatsApp.

Esta seção contém guias para configurar e gerenciar os pagamentos relacionados ao uso da API Oficial do WhatsApp Business, incluindo a configuração de formas de pagamento e a consulta de extratos de pagamento de conversas.

{% content-ref url="/pages/GLw7o6NWhqC8VVTIBiGf" %}
[Configurar](/guide/documentacao/faq/conexao-whatsapp/pagamentos/configurar-pagamento)
{% endcontent-ref %}

{% content-ref url="/pages/c4adkLsIsiE4RFWsIujC" %}
[Extrato](/guide/documentacao/faq/conexao-whatsapp/pagamentos/consultar-extrato-de-pagamento)
{% endcontent-ref %}


# Configurar

Como cadastrar uma forma de pagamento no Meta Business Manager para utilizar a API Oficial do WhatsApp.

Para utilizar a API Oficial do WhatsApp Business, é necessário cadastrar uma forma de pagamento válida na sua conta do **Meta Business Manager**. Este processo é essencial para que você possa enviar mensagens e utilizar os recursos oferecidos pela API. A seguir, apresentamos um guia passo a passo para ajudá-lo a adicionar um cartão de crédito à sua conta.

{% hint style="success" %}
**Pré-requisitos:**

* Ter uma conta na **Meta Business** configurada e vinculada ao seu número do WhatsApp.
* Ser um **administrador** ou possuir permissões adequadas para acessar as informações de faturamento.
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No menu lateral, clique em **Configurações do Negócio.**

<figure><img src="/files/SpEVsxwDqlKY6TZLeflZ" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar Conta do WhatsApp

* Na BM, selecione **Conta do WhatsApp**.
* Em seguida, no canto inferior direito, acesse **Configurações de Pagamento**.

<figure><img src="/files/YXJONPDT2UWz2gWL4oUG" alt=""><figcaption></figcaption></figure>

## Passo 3: Configurar Formas de Pagamento

Nesta etapa, você conectará um método de pagamento ao seu portfólio empresarial para que ele possa ser compartilhado entre as contas conectadas.

* No menu lateral esquerdo, selecione a opção **Formas de pagamento**.
* No painel central, localize a seção **"Adicionar forma de pagamento da empresa"** e clique no botão **Adicionar.**

**Dica:** Certifique-se de que você possui as permissões necessárias para gerenciar informações financeiras antes de tentar realizar alterações nesta tela.

{% hint style="warning" %}

#### Atenção: Local Obrigatório para Cadastro

É fundamental que a forma de pagamento seja configurada exclusivamente através da aba **Formas de pagamento** no menu lateral.

* **Não utilize** a opção "Contas" para realizar este cadastro.
* **Motivo:** Formas de pagamento adicionadas pela seção "Contas" **não serão validadas corretamente** pelo sistema, o que impedirá o processamento das cobranças e resultará na interrupção do funcionamento dos serviços.
  {% endhint %}

<figure><img src="/files/vZQh5hn01xFvACuFD1Xp" alt=""><figcaption></figcaption></figure>

## Passo 4: Preencher Localização e Moeda

* Uma janela de configuração será exibida.
* Preencha os campos com atenção, pois **essas informações não poderão ser alteradas após definidas:**
* **País/Região:** Selecione **Brasil.**
* **Moeda:** Escolha obrigatoriamente **Dólar americano (USD).**
  * ***Nota:** A Meta utiliza o dólar como base e realiza a conversão automática para Real na fatura do seu cartão.*
* **Fuso Horário:** Selecione o fuso correspondente à sua região (ex: **São Paulo, América GMT-03:00**).
* Após preencher, clique em **Avançar.**

![](/files/xXamk9foAaAlndZ9h4AF)

## Passo 5: Inserir os Dados do Cartão de Crédito

Agora, você precisará fornecer os detalhes do seu cartão de crédito ou débito:

* **Número do Cartão**: Digite os 16 dígitos que aparecem na frente do seu cartão.
* **Data de Validade**: Insira o mês e o ano de validade do cartão, geralmente encontrados na frente do cartão.
* **Código de Segurança (CVV)**: Este é um número de três dígitos localizado no verso do cartão.
* **Nome do Titular**: Digite o nome exatamente como aparece no cartão.

Após inserir todas as informações corretamente, clique em **"Salvar"** para concluir o processo.

![](/files/jP4YQaRzfvixWaNGq98p)

## Passo 6: Vincular Forma de Pagamento à Conta do WhatsApp

Após cadastrar o cartão no portfólio, você deve vinculá-lo especificamente à sua conta do **WhatsApp Business:**

* Abaixo da seção de cartões, clique na aba **Contas do WhatsApp Business.**
* Selecione a conta desejada (ex: Wts-Automacao).
* Clique no botão **Adicionar forma de pagamento** no rodapé da página.
* Selecione o cartão que você acabou de cadastrar e confirme a vinculação.

<figure><img src="/files/ZsFUkHyPqckmgWCitrtw" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

#### Considerações Adicionais Importantes

* **Habilitação Internacional:** O cartão deve estar liberado para **compras internacionais**, pois o processamento ocorre em dólar (USD).
* **Conversão de Câmbio:** O valor final na fatura dependerá da cotação do dólar no dia do fechamento, acrescido de impostos (como IOF).
* **Apoio Oficial:** Para mais detalhes, acesse a [Central de Ajuda da Meta](https://www.facebook.com/business/help/488291839463771).
  {% endhint %}


# Extrato

Como acessar e consultar o extrato de pagamento de conversas do WhatsApp na Meta Business.

A Meta Business permite acompanhar os custos das conversas realizadas através da API oficial do WhatsApp. Consultar o extrato de pagamento é essencial para monitorar os gastos e garantir um melhor controle financeiro dentro da plataforma. Neste guia, você aprenderá como acessar e visualizar os detalhes do extrato de pagamento de conversas na Meta Business.

{% hint style="success" %}
**Pré-requisitos:**

* Ter uma conta na **Meta Business** configurada e vinculada ao seu número do WhatsApp.
* Ser um **administrador** ou possuir permissões adequadas para acessar as informações de faturamento.
* Ter um método de pagamento cadastrado e ativo na **Meta Business**.
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios <a href="#passo-1-acessar-o-gerenciador-de-negocios" id="passo-1-acessar-o-gerenciador-de-negocios"></a>

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No menu lateral, clique em **Configurações do Negócio.**

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar Conta do WhatsApp

* Na BM, selecione **Conta do WhatsApp**.
* Em seguida, no canto inferior direito, acesse **Configurações de Pagamento**.

![](/files/sVds5uSr2z73hoFuKZck)

## Passo 3: Acesse atividade de pagamento.

**Visualize o Extrato de Pagamento:**

* Dentro da aba de **Cobrança e pagamentos**, localize a opção **Atividade de pagamento.**
* Escolha o **período** que deseja consultar.
* O extrato detalhará a quantidade de conversas pagas, o valor cobrado e a categoria da conversa (como conversas de atendimento ou marketing).

**Baixe ou Exporte os Dados:**

* Caso precise manter um registro, clique na opção **Baixar extrato**.
* O arquivo será gerado em formato PDF ou CSV para análise detalhada.

![](/files/rKtKpOSvngkuKpggDrIc)

{% hint style="info" %}
**Considerações Adicionais:**

* Consultar o extrato de pagamento regularmente permite um melhor planejamento financeiro e evita surpresas com cobranças inesperadas.
  {% endhint %}


# Página de suporte

Como acessar a página inicial de suporte no Meta Business Manager para verificar restrições e obter ajuda.

O Meta Business Manager é uma plataforma gratuita que permite gerenciar e acompanhar as atividades comerciais nas suas contas do Facebook e Instagram de maneira integrada. Através dela, é possível acessar ferramentas de marketing, analisar insights e interagir com seu público de forma eficiente. Para obter suporte ou esclarecer dúvidas sobre o uso do Meta Business Manager, você pode acessar a página inicial de suporte dedicada.

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso ao **portfólio empresarial.**
  {% endhint %}

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Acesse a Página Inicial do suporte para empresas

* Uma tela com várias opções será exibida.
* Acesse o menu **"Gerenciamento".**
* Clique em **"Página Inicial do Suporte para Empresas"**.

![](/files/LLbx84yjnWBafDd5Nwof)

## Passo 3: Verifique as restrições

* Nesta página, será possível verificar se há alguma restrição no **portfólio empresarial**, na **página de anúncios** ou na **conta do WhatsApp.**

![](/files/SelHsjLmWEpqKfq8Yjb6)

{% hint style="info" %}
**Considerações Adicionais:**

* A página inicial de suporte da Meta dentro da Business Manager é um recurso vital para manter suas operações funcionando sem problemas. Certifique-se de ter as permissões necessárias para acessar o **portfólio empresarial**.
  {% endhint %}


# Erros comuns

Informações sobre erros comuns da Meta, banimentos e como resolver problemas com o WhatsApp Business.

Esta seção contém informações sobre os principais erros e problemas que podem ocorrer ao utilizar o WhatsApp Business via API Oficial, incluindo códigos de erro da Meta e orientações sobre banimentos.

{% content-ref url="/pages/KA3vJ30c2NWrNpFv90FD" %}
[Códigos de Erros](/guide/documentacao/faq/conexao-whatsapp/erros-e-problemas/codigos-de-erros-da-meta)
{% endcontent-ref %}

{% content-ref url="/pages/P8K7Qk3K4ZXfbouhblg8" %}
[Meu número foi banido](/guide/documentacao/faq/conexao-whatsapp/erros-e-problemas/meu-numero-foi-banido)
{% endcontent-ref %}

{% content-ref url="/pages/4gr7szYbBTptgoa7BOfu" %}
[Revisão de banimento](/guide/documentacao/faq/conexao-whatsapp/erros-e-problemas/solicitar-revisao-de-banimento)
{% endcontent-ref %}


# Códigos de Erros

Descrição dos principais códigos de erro da Meta e orientações para entender suas causas e soluções.

Ao integrar ou utilizar serviços da Meta, alguns códigos de erro podem ser retornados pela plataforma. Neste artigo, você encontrará a descrição desses códigos, organizados em ordem numérica, com orientações para entender suas causas e possíveis soluções.

## Erro 100: Mensagem Não Suportada

<figure><img src="/files/cH8YVpkUkH48nctrqlC7" alt=""><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

Esse erro geralmente acontece quando há problemas nos parâmetros enviados na requisição ou nas permissões necessárias para executar a ação na API da Meta. Ele pode ocorrer quando o sistema tenta acessar um recurso inexistente, utiliza dados inválidos ou quando o aplicativo não possui as permissões necessárias.

**Causas mais comuns**

* **Parâmetros inválidos ou ausentes:** a requisição enviada para a API contém parâmetros incorretos, incompletos ou em formato inválido. Por exemplo, ao tentar acessar um recurso utilizando um ID inválido ou sem informar todos os campos obrigatórios.
* **Recurso inexistente ou inacessível:** a tentativa de acessar um recurso que não existe ou que não está disponível para o aplicativo.
* **Permissões insuficientes:** o aplicativo pode não possuir as permissões necessárias para executar determinada ação, como enviar mensagens ou acessar determinados dados.
* **Problemas com URLs:** quando a mensagem contém links, URLs malformadas ou que não seguem os requisitos da Meta podem impedir o processamento da requisição.

**Como resolver**

* **Verifique os parâmetros da requisição:** confirme se todos os parâmetros obrigatórios estão presentes e se os dados enviados estão no formato correto.
* **Confirme as permissões do aplicativo:** verifique se o aplicativo possui todas as permissões necessárias para realizar a ação desejada. Caso necessário, revise ou conceda as permissões no painel da Meta: [Processo Para Conceder Permissão](/guide/documentacao/ajustes/conta/processo-de-dar-permissao-para-reconectar-o-numero)
* **Valide os recursos utilizados:** certifique-se de que os recursos ou IDs informados realmente existem e que estão acessíveis para o aplicativo.
* **Teste as URLs utilizadas:** se a mensagem contiver links, valide as URLs para garantir que estão corretamente formatadas. Ferramentas de verificação da Meta podem ajudar a identificar problemas com os links antes do envio: [Facebook Sharing Debugger](https://developers.facebook.com/tools/debug/)

## Erro 130472: Experimento da Meta

<figure><img src="/files/0LtiCuXjTjVAK8ZNNnIp" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

Esse erro pode ocorrer porque a Meta selecionou aproximadamente 1% dos números de telefone conectados ao WhatsApp Cloud API no mundo para participarem de um experimento controlado. O objetivo desse teste é avaliar como o recebimento de mensagens de marketing impacta a experiência dos usuários finais no WhatsApp.

**O que isso significa na prática?**

Para os números incluídos nesse experimento, o envio de modelos de mensagem da categoria Marketing pode ser temporariamente limitado ou bloqueado, mesmo que sua conta WABA (WhatsApp Business Account) esteja:

* corretamente configurada;
* com saldo disponível;
* com templates aprovados pela Meta;
* sem qualquer infração às políticas da plataforma.

A restrição não está relacionada a erro de configuração ou penalização da conta, mas sim a um teste conduzido pela própria Meta.

**O que a Meta está avaliando?**

A Meta realiza esse tipo de experimento para ajustar seus algoritmos e políticas de envio de mensagens. Entre os pontos analisados estão:

* o impacto de mensagens de marketing na satisfação do usuário;
* taxas de entrega, leitura, bloqueio e denúncias;
* possíveis ajustes nos limites de envio de mensagens de marketing.

{% hint style="info" %}
Esses experimentos são temporários, porém a Meta não divulga um prazo oficial para o encerramento do teste.
{% endhint %}

**Soluções e alternativas**

Se você precisar se comunicar com um contato que esteja incluído nesse experimento, algumas estratégias podem ajudar:

1. **Utilize modelos da categoria Utilidade:** o bloqueio está focado principalmente em mensagens de Marketing. Sempre que possível, tente iniciar a conversa utilizando modelos da categoria Utilidade, como confirmação de pedido, envio de boleto ou lembretes de agendamento.
2. **Aguarde o usuário iniciar a conversa (janela de 24 horas):** a restrição se aplica ao envio iniciado pela empresa. Caso o cliente envie uma mensagem primeiro, será aberta uma janela de atendimento de 24 horas, na qual você poderá responder normalmente.
3. **Utilize canais alternativos para iniciar o contato:** se o assunto for urgente, você pode entrar em contato com o cliente por outros canais, como telefone, SMS ou e-mail, e solicitar que ele envie uma mensagem no WhatsApp.

{% hint style="info" %}
**Pontos importantes:**

* **Não é um erro da plataforma ou do provedor (BSP):** a restrição vem diretamente da API da Meta.
* **Não é uma penalização:** o bloqueio não está relacionado à qualidade do número ou a denúncias de usuários.
* **Não é possível solicitar remoção do teste:** como se trata de um experimento automático e aleatório da Meta, não há opção de opt-out para sair manualmente desse grupo.
  {% endhint %}

## Erro 130497: Conta Comercial Impedida de Enviar Mensagens

**Por que esse erro ocorre?**

O erro 130497 indica que a conta do WhatsApp Business está sujeita a uma restrição geográfica de envio de mensagens. Essa limitação ocorre quando a Meta não consegue validar corretamente a localização da empresa, geralmente devido a informações incompletas ou configuradas incorretamente no Meta Business Manager.

Diferente do que muitas pessoas imaginam, a Meta não identifica automaticamente o país da empresa apenas pelo prefixo do número de telefone (por exemplo, +55 para o Brasil). Quando o campo **"País"** não está preenchido ou está configurado incorretamente nas informações da empresa no **Business Manager**, o sistema pode aplicar restrições de envio entre países, mesmo quando a comunicação ocorre dentro do mesmo país.

**Como resolver**

1. Acesse o **Meta Business Manager**.
2. Vá até **Configurações do negócio**.
3. Selecione **Informações da empresa**.
4. Localize o campo **País** e verifique se ele está preenchido corretamente (por exemplo: **Brasil**).
5. Caso o campo esteja vazio ou incorreto, clique em **Editar**, selecione o país correto e **salve as alterações**.
6. Após a atualização, aguarde o período de propagação da configuração na Meta.

Após a atualização das informações da empresa no Business Manager e a propagação das alterações pela Meta, o envio de mensagens tende a ser normalizado automaticamente.

## Erro 131000: Erro Desconhecido

<figure><img src="/files/WcVnNG5AhAFxTXlQ9lu2" alt=""><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131000 ocorre quando há uma falha técnica no processamento do envio de mensagens pela API do WhatsApp da Meta. Esse tipo de erro normalmente está relacionado a problemas temporários de comunicação entre os sistemas, configurações incorretas ou instabilidades momentâneas nos serviços da Meta.

**Possíveis causas**

* Instabilidade temporária nos servidores da Meta: [**status da API da Meta**](https://metastatus.com/)**;**
* Falhas de comunicação entre a plataforma utilizada e a API do WhatsApp;
* Configurações incorretas na integração com a API.

**Como resolver**

* **Verifique o status da API da Meta:** confirme se há relatos de instabilidade ou manutenção nos serviços da Meta que possam estar afetando o envio de mensagens.
* **Verifique sua conexão com a internet:** certifique-se de que a conexão utilizada para acessar a plataforma está funcionando corretamente.
* **Tente enviar a mensagem novamente:** em muitos casos, esse erro é temporário e pode ser resolvido ao realizar uma nova tentativa de envio após alguns instantes.

{% hint style="info" %}
Se esse erro ocorrer logo após a conexão de um número na API Oficial, pode ser necessário reconfigurar a integração.

Nesse caso:

1. Acesse o **portfólio empresarial (Meta Business Manager)**.
2. Exclua as informações relacionadas à conexão do número.
3. Realize novamente o processo de conexão do número à API Oficial.

Após a reconexão, o envio de mensagens tende a voltar ao funcionamento normal.
{% endhint %}

## Erro 131026: Número Não Registrado no WhatsApp

<figure><img src="/files/uRu0taP5tXFEsrCq5OyS" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131026 ocorre quando há uma tentativa de envio de mensagem para um número que não está registrado no WhatsApp. O sistema não consegue entregar a mensagem porque o número informado não possui uma conta ativa na plataforma.

**Causas mais comuns**

* **Número não possui conta no WhatsApp:** o número informado não está associado a nenhuma conta ativa no WhatsApp.
* **Mudança de número pelo usuário:** o destinatário pode ter alterado o número utilizado no WhatsApp e não atualizou essa informação com sua empresa.
* **Erro ao digitar o número:** o número pode ter sido inserido incorretamente, com dígitos a mais, a menos ou no formato incorreto.
* **Conta desativada:** o usuário pode ter desativado temporariamente ou permanentemente sua conta do WhatsApp.

**Como resolver**

1. **Verifique se o número está correto:** confirme se o número foi informado corretamente, se está no formato internacional incluindo o código do país (ex.: **+55** para Brasil) e se contém o nono dígito, quando aplicável. Confirme com o cliente se o número utilizado é o mesmo registrado no WhatsApp.
2. **Verifique se o número possui WhatsApp:** você pode validar isso tentando iniciar uma conversa diretamente pelo aplicativo WhatsApp ou utilizando o link **<https://wa.me/\\[número>]**. Se o número não estiver registrado no WhatsApp, a conversa não poderá ser iniciada.
3. **Teste o envio para outro número:** envie o mesmo Template de Mensagem (TM) para outro número que você sabe que está ativo no WhatsApp. Se a mensagem for enviada com sucesso, o problema está no número original. Se a mensagem não for enviada, o problema pode estar relacionado ao template de mensagem ou à configuração da conta.

## Erro 131031: Conta Restrita ou Bloqueada

<figure><img src="/files/6loOoXNf2uqVn9wlxucU" alt=""><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131031 ocorre quando a conta do WhatsApp Business está restrita ou bloqueada pela Meta. Essa situação normalmente indica que a conta pode ter violado alguma política ou regra de uso do WhatsApp Business. Quando isso acontece, a Meta pode limitar temporariamente ou bloquear o envio de mensagens até que a situação seja analisada ou regularizada.

**Causas mais comuns**

* **Violação das políticas da Meta:** envio de mensagens que não seguem as diretrizes do WhatsApp Business, como conteúdo inadequado ou comunicação não autorizada pelos usuários.
* **Reclamações de usuários:** um número elevado de bloqueios ou denúncias de spam por parte dos destinatários pode impactar negativamente a qualidade da conta e levar a restrições.
* **Atividades consideradas suspeitas:** uso inadequado da API, como envio excessivo de mensagens em massa ou automações agressivas, pode fazer com que a Meta aplique restrições preventivas na conta.

**Como resolver**

Para entender o motivo da restrição e verificar possíveis orientações da Meta, siga os passos abaixo:

1. Acesse o **Meta Business Manager**.
2. Na barra lateral esquerda, clique no ícone de **menu**.
3. Clique em **Página Inicial do Suporte para Empresas**.
4. Verifique se há notificações, alertas ou mensagens da Meta relacionadas à conta ou ao erro.

<figure><img src="/files/g6BPS21FhpaLzjmHljQJ" alt="" width="563"><figcaption></figcaption></figure>

**Boas práticas para regularizar a conta**

* **Revise as políticas de uso:** certifique-se de que sua conta está em conformidade com as Políticas Comerciais e as Políticas de Mensagens da Meta. Evite enviar mensagens não solicitadas ou conteúdos que possam ser interpretados como spam pelos destinatários.
* **Responda às notificações da Meta:** verifique se há notificações ou solicitações de ação no Gerenciador de Negócios. Caso existam, siga as orientações fornecidas pela Meta. Em muitos casos, a Meta pode solicitar informações adicionais ou ajustes nas práticas de envio.
* **Corrija possíveis práticas inadequadas:** reduza o envio de mensagens para listas grandes de contatos que não interagiram recentemente com sua empresa, priorize mensagens relevantes e garanta que o opt-in (consentimento do cliente para receber mensagens) esteja devidamente coletado e documentado.

## Erro 131042: Falha no Processamento de Pagamento

<figure><img src="/files/JVtJYCNGfOUpTiiYj7sL" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131042 ocorre quando a Meta enfrenta dificuldades para processar o pagamento utilizando o cartão cadastrado na conta do portfólio empresarial (Business Manager). Na maioria dos casos, o problema está relacionado a falhas no processamento do pagamento pela própria Meta, o que impede a realização do débito, mesmo quando o cartão cadastrado está válido e ativo.

**Possíveis causas**

* Inconsistências temporárias no sistema de cobrança da Meta;
* Falha ao processar o valor total pendente;
* Problemas com o método de pagamento configurado na conta.

**Como resolver**

1. **Confirme os dados do cartão:** verifique se as informações do cartão cadastradas no Business Manager estão corretas e atualizadas. Confirme se há saldo ou limite disponível para a cobrança.
2. **Tente realizar o pagamento manualmente:** no Gerenciador de Negócios, acesse **Contas > Contas do WhatsApp > Configurações de pagamento** e verifique o saldo pendente. Se houver um valor em aberto, tente realizar o pagamento manualmente. Caso o pagamento do valor total não seja processado, tente ajustar o valor manualmente para um valor ligeiramente menor e realize a cobrança novamente.
3. **Atualize ou adicione um novo método de pagamento:** acesse **Contas > Contas do WhatsApp > Configurações de pagamento**, clique em **"Adicionar forma de pagamento"**, insira os dados do cartão e clique em **"Salvar"**. Após atualizar ou adicionar um novo método de pagamento, aguarde alguns minutos para que a Meta processe a alteração.

## Erro 131047: Mais de 24h Sem Contato

<figure><img src="/files/Vza4heJfuqcjUKaxuxpC" alt=""><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131047 ocorre quando uma empresa tenta enviar uma mensagem fora da janela de atendimento de 24 horas do WhatsApp. De acordo com as políticas do WhatsApp, após 24 horas desde a última mensagem enviada pelo cliente, a empresa não pode mais responder livremente na conversa. A partir desse momento, novas mensagens só podem ser enviadas utilizando um modelo de mensagem (template) previamente aprovado pela Meta.

Essa regra existe para evitar comunicações não solicitadas e preservar uma boa experiência para os usuários do WhatsApp.

**Como resolver**

Para retomar o atendimento, é necessário enviar um modelo de mensagem aprovado pela Meta. Após o cliente responder a essa mensagem, a janela de atendimento de 24 horas será reaberta, permitindo que a conversa continue normalmente.

{% hint style="info" %}
Esse erro também pode ocorrer se o número do contato for editado durante uma conversa ativa. Por exemplo, se durante o atendimento houver a necessidade de corrigir o número do cliente, como adicionar o nono dígito ou atualizar o telefone informado, o sistema pode interpretar a alteração como um novo contato sem histórico recente de interação, resultando no erro de janela de 24 horas.
{% endhint %}

## Erro 131048: Parâmetro Ausente ou Inválido

<figure><img src="/files/mg36SBYFVZPh43iwz2PU" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131048 ocorre quando há algum problema na estrutura da mensagem enviada ou quando a conta atinge limitações relacionadas à qualidade ou ao volume de envio de mensagens. Esse erro pode acontecer quando parâmetros obrigatórios estão ausentes ou inválidos, ou quando a Meta identifica comportamentos que podem indicar envio excessivo de mensagens ou possível atividade de spam.

**Causas mais comuns**

* **Parâmetro ausente ou inválido:** a mensagem enviada pode não conter todas as informações necessárias ou pode incluir dados em formato incorreto, o que impede o processamento da requisição pela API da Meta.
* **Limite de qualidade ou spam atingido:** o WhatsApp pode aplicar restrições temporárias quando identifica que a conta possui baixa classificação de qualidade. Isso pode ocorrer quando muitos usuários bloqueiam o número ou denunciam as mensagens como spam.
* **Limite de taxa de envio:** também pode ocorrer quando há um volume muito alto de mensagens enviadas em um curto período, ultrapassando os limites definidos pela Meta.

**Como resolver**

* **Verifique os parâmetros da mensagem:** confirme se todos os campos obrigatórios da mensagem estão presentes e se os dados enviados estão no formato correto.
* **Reduza o volume de envios:** caso o erro esteja relacionado a limites de envio, diminua a quantidade de mensagens enviadas a partir do mesmo número em um curto intervalo de tempo.
* **Verifique a qualidade da conta:** no **WhatsApp Manager**, consulte o status de qualidade do número para verificar se há alertas relacionados a bloqueios ou denúncias por parte dos usuários.
* **Evite mensagens repetitivas:** evite enviar mensagens idênticas ou muito frequentes, pois esse comportamento pode ser interpretado pela Meta como spam.

## Erro 131049: Limite de Marketing por Destinatário

<figure><img src="/files/EEMCACqcVKHMR1N2oDdd" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

Esse erro acontece quando você tenta enviar um modelo de mensagem para iniciar ou reiniciar uma conversa com o cliente. Não se trata de um erro da plataforma, mas sim de uma restrição aplicada diretamente pela Meta. Em determinadas situações, a Meta identifica que um número de telefone recebeu muitas mensagens de marketing em um curto período. Para preservar uma boa experiência para os usuários do WhatsApp, a Meta pode bloquear temporariamente o envio de novas mensagens de marketing para esse número.

A própria mensagem de erro retornada pela Meta inclui um link para a documentação oficial com mais detalhes sobre essa limitação: [documentação da Meta](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates#user-marketing-template-message-limits)

**Como agir ao receber esse erro**

Ao receber esse código de erro, não é recomendado tentar reenviar a mesma mensagem imediatamente. Você pode:

* Enviar uma **mensagem do tipo Utilidade**, se fizer sentido para a comunicação.
* **Aguardar um período maior antes de tentar novamente**, pois o limite aplicado pela Meta pode permanecer ativo por diferentes períodos de tempo.

**Boas práticas para evitar esse bloqueio**

* **Varie os tipos de mensagem:** evite enviar apenas mensagens de marketing. Sempre que possível, utilize também mensagens do tipo Utilidade, quando forem relevantes para o cliente.
* **Evite envios excessivos em curto período:** o envio frequente de mensagens de marketing para o mesmo número em um intervalo pequeno de tempo aumenta a probabilidade de bloqueio.
* **Aguarde o desbloqueio automático:** caso o bloqueio ocorra, será necessário aguardar o período determinado pela Meta, que pode variar de algumas horas até alguns dias.

## Erro 131051: Mensagem Não Suportada pela API

<figure><img src="/files/efyZEdP666uts8GMjkQV" alt=""><figcaption></figcaption></figure>

**O que significa essa mensagem?**

A mensagem **"Mensagem não suportada pela API"** aparece quando um contato envia um tipo de conteúdo que não é compatível com a API oficial da Meta, utilizada nas integrações com WhatsApp, Instagram ou Messenger. Nesses casos, a plataforma não consegue exibir ou processar o conteúdo recebido.

Esse comportamento é esperado e controlado diretamente pela Meta, não sendo algo que possa ser alterado ou corrigido pela plataforma. Mesmo que o conteúdo específico não possa ser exibido, a conversa não é perdida. Todas as demais mensagens trocadas permanecem normalmente disponíveis no histórico do atendimento.

**Exemplos de conteúdos que podem gerar essa mensagem**

* **Reações a mensagens** (como emojis de reação no WhatsApp);
* **Figurinhas animadas** ou stickers personalizados não compatíveis;
* **Áudios temporários** ou formatos específicos de notas de voz;
* **Arquivos ou formatos muito recentes**, ainda não suportados pela API oficial;
* **Mensagens enviadas por bots ou automações externas** que utilizam recursos não compatíveis com a integração.

**O que fazer quando essa mensagem aparecer?**

* Informe ao cliente que o formato do conteúdo enviado não é compatível com a integração oficial.
* Solicite que ele reenvie a informação em outro formato, como texto, imagem, áudio padrão ou documento.
* Oriente o contato a evitar o envio de reações, figurinhas animadas ou formatos não convencionais, caso o problema ocorra com frequência.

{% hint style="info" %}
Esse comportamento não indica um erro da plataforma, mas sim uma limitação da API oficial da Meta, responsável por definir quais tipos de conteúdo podem ser processados por integrações externas.
{% endhint %}

## Erro 131056: Limite de Volume de Envios Atingido

<figure><img src="/files/gtFBu57jjg85RJKsJMm2" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

Esse erro ocorre, principalmente, quando muitas mensagens de marketing são enviadas para o mesmo contato em um curto período de tempo. A plataforma continua funcionando normalmente, porém a Meta pode aplicar restrições temporárias no envio de mensagens de marketing para determinados números.

A Meta possui mecanismos de controle para evitar que usuários recebam um volume excessivo de mensagens de marketing. Quando o sistema identifica que um número recebeu muitas mensagens desse tipo em um intervalo curto, o envio de novas mensagens de marketing pode ser temporariamente pausado para aquele destinatário. Essa medida é aplicada automaticamente pela Meta.

**Como resolver**

* **Reduza a quantidade de mensagens enviadas para cada contato:** evite enviar muitas mensagens de marketing para o mesmo número em um curto intervalo de tempo.
* **Varie os tipos de mensagens enviadas:** em vez de utilizar apenas mensagens de marketing, sempre que possível utilize também mensagens do tipo Utilidade, que normalmente possuem regras de envio mais flexíveis.
* **Monitore o status de envio das mensagens:** acompanhe os relatórios ou status de entrega das mensagens. Caso identifique bloqueios frequentes, considere reduzir o volume de envios e aguardar o período de desbloqueio automático aplicado pela Meta.

## Erro 131060: Mensagem Indisponível (Coexistência e CTWA)

<figure><img src="/files/wkTBGcOAg8Gg6Nyw9dRu" alt=""><figcaption></figcaption></figure>

**O que está acontecendo?**

Ao operar canais de WhatsApp Business, especialmente em cenários que utilizam anúncios **Click-to-WhatsApp (CTWA)** em ambientes de **Coexistência (COEX)**, você pode se deparar com um aviso no atendimento indicando o erro 131060. Esse comportamento está relacionado a uma limitação conhecida da infraestrutura do WhatsApp.

O erro ocorre devido a um atraso na classificação da conversa pelos servidores do WhatsApp. Quando um cliente inicia uma conversa com um número de WhatsApp Business, o aplicativo precisa primeiro exibir uma mensagem de sistema de segurança, conhecida como **aviso azul**, que informa ao usuário que a conversa está sendo gerenciada por um serviço da Meta.

**Por que ocorre o erro?**

Se o cliente envia uma mensagem antes que o aviso azul apareça no aplicativo, o WhatsApp ainda trata aquela conversa como um chat comum do aplicativo Small and Medium Business (SMB). Nesse cenário:

* a plataforma recebe o evento de envio da mensagem,
* porém o conteúdo da mensagem não é compartilhado com a API Oficial (Cloud API).

Como resultado, a mensagem chega ao sistema sem conteúdo, gerando o erro 131060 no histórico da conversa.

**Por que isso acontece mais em anúncios (CTWA)?**

A maioria das ocorrências acontece em fluxos iniciados por Click-to-WhatsApp, quando o usuário clica em anúncios do Facebook ou Instagram que direcionam para o WhatsApp. Isso ocorre devido à combinação de alguns fatores:

* **Velocidade de ação:** o usuário clica no anúncio e a mensagem automática pré-definida é enviada quase imediatamente.
* **Primeiro contato com a empresa:** geralmente é a primeira vez que o cliente conversa com o número da empresa, e ele ainda não possui o contato salvo na agenda.
* **Processamento inicial da criptografia:** a criptografia de ponta a ponta e a identificação da conversa comercial ainda estão sendo processadas pela infraestrutura da Meta.

{% hint style="info" %}
Embora não exista uma confirmação oficial da Meta sobre todos os fatores envolvidos, observamos que dispositivos mais antigos, conexão de internet instável e alto volume de mensagens simultâneas podem aumentar a incidência desse comportamento.
{% endhint %}

**Como mitigar esse cenário**

De acordo com a orientação atual da Meta, a única forma de evitar esse comportamento em fluxos iniciados por anúncios Click-to-WhatsApp é migrar o número completamente para a Cloud API (API Oficial), deixando de utilizar o modo de Coexistência com o aplicativo físico do WhatsApp.

{% hint style="info" %}
**Posicionamento oficial da Meta:**

Nossa equipe técnica escalou esse comportamento diretamente para a equipe de produto da Meta. O retorno oficial foi que se trata de um comportamento conhecido da plataforma, ocorre devido ao atraso na exibição da mensagem de sistema, e o impacto é maior em números que utilizam Coexistência (COEX) com alto volume de tráfego.

A Meta informou que pretende documentar esse cenário oficialmente, revisar a descrição do erro e avaliar melhorias na arquitetura para reduzir ou eliminar essa limitação no futuro. Este artigo será atualizado caso novas orientações ou soluções sejam disponibilizadas pela Meta.
{% endhint %}

## Erro 132001: Modelo Não Existe

<figure><img src="/files/j3U3BHndOMj6woBAvnGl" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 132001 ocorre quando há uma tentativa de envio de um modelo de mensagem (template) que não está registrado ou não é reconhecido pela API do WhatsApp. O sistema não conseguiu localizar o modelo solicitado na base de templates disponíveis na Meta.

**Causas mais comuns**

* **Modelo de mensagem excluído:** o template pode ter sido removido no WhatsApp Manager (Gerenciador de Negócios) e, por isso, não está mais disponível para envio.
* **Nome do modelo incorreto:** o nome do modelo pode ter sido informado de forma incorreta, impedindo que a API identifique o template correspondente.
* **Modelo ainda em análise:** o template pode estar em processo de aprovação pela Meta e, enquanto estiver nesse status, não poderá ser utilizado para envio.
* **Modelo rejeitado:** se o modelo foi reprovado pela Meta, ele não poderá ser utilizado até que seja ajustado e aprovado novamente.

**Como resolver**

* **Sincronize os modelos de mensagem:** solicite a um usuário com perfil de **Administrador** que realize a sincronização dos modelos de mensagem com a Meta, garantindo que todos os templates estejam atualizados na plataforma.
* **Crie um novo modelo de mensagem:** se o modelo não existir mais ou estiver com problemas, crie um novo template e aguarde a aprovação da Meta.
* **Reenvie o modelo para aprovação:** caso o modelo esteja reprovado ou ainda em análise, revise o conteúdo conforme necessário e envie novamente para aprovação.
* **Siga as diretrizes da Meta para templates:** certifique-se de que o modelo atende às [diretrizes para modelos de mensagem](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/), evitando novas reprovações.

## Erro 135000: Falha ao Enviar Mensagem

<figure><img src="/files/9bvzxDHDMi5ElIiRjj5S" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 135000 pode ocorrer quando um atendente tenta enviar um modelo de mensagem (template) durante um atendimento e o envio falha. Esse problema geralmente está relacionado a inconsistências na sincronização ou validação do modelo de mensagem junto à Meta. Em alguns casos, o modelo pode estar aprovado na Meta, mas não estar corretamente sincronizado ou atualizado na plataforma, o que impede o envio.

**Como resolver**

Uma das formas mais comuns de resolver esse problema é realizar a sincronização dos modelos de mensagem com a Meta. Essa ação deve ser realizada por um usuário com perfil de **Administrador**.

Se o problema persistir, siga os passos abaixo:

1. **Acesse os Modelos de Mensagem:** localize o modelo que está sendo utilizado no painel de **Modelos de Mensagem de Atendimento**.
2. **Duplique o modelo de mensagem:** crie uma cópia do modelo que apresentou o erro. Você pode manter o mesmo conteúdo ou realizar pequenos ajustes, se necessário.
3. **Envie o novo modelo para aprovação:** após duplicar o modelo, envie-o para aprovação da Meta e aguarde até que ele seja aprovado.
4. **Teste o envio novamente:** depois da aprovação, utilize o modelo duplicado para realizar um novo teste de envio da mensagem.

{% hint style="info" %}
Se o modelo duplicado funcionar normalmente, pode ser útil duplicar outros modelos que apresentem comportamento semelhante, garantindo que todos estejam atualizados e sincronizados corretamente com a Meta. Isso ajuda a evitar falhas no envio e mantém o fluxo de comunicação funcionando sem interrupções.
{% endhint %}


# Meu número foi banido

O que fazer quando seu número comercial é banido no WhatsApp, tipos de banimento e como solicitar uma revisão.

Se o seu número comercial foi banido no WhatsApp, é importante entender o tipo de banimento e agir corretamente para aumentar as chances de recuperação. Este artigo explica as causas mais comuns, os tipos de banimento e o que fazer em cada situação.

{% hint style="danger" %}
**Ação imediata:** Ao receber um banimento, **não exclua o portfólio empresarial**, **não desconecte o número** e **não tente conectar o número em outra conta**. Essas ações podem transformar um bloqueio temporário em permanente.
{% endhint %}

## Tipos de banimento

Existem dois tipos principais de banimento no WhatsApp Business API:

### Banimento por spam (temporário)

Ocorre quando o WhatsApp detecta comportamentos que violam as políticas de uso, como:

* Envio de mensagens em massa sem consentimento (opt-in).
* Alto volume de denúncias ou bloqueios por parte dos destinatários.
* Uso de conteúdo repetitivo ou considerado spam.

Esse tipo de banimento geralmente tem **duração de 24 horas a 7 dias** e pode ser revertido automaticamente ou mediante solicitação de revisão.

### Banimento permanente

Ocorre em casos mais graves, como:

* Reincidência após banimentos anteriores.
* Violação severa das políticas do WhatsApp (conteúdo ilegal, golpes, phishing).
* Uso de APIs não oficiais ou ferramentas que violam os termos de serviço.

{% hint style="warning" %}
O banimento permanente pode afetar apenas o **número (WABA)** ou todo o **portfólio empresarial (BM)**, dependendo da gravidade da violação.
{% endhint %}

## O que fazer ao ser banido

## Passo 1: Não tomar ações precipitadas

* **Não exclua** o portfólio empresarial.
* **Não desconecte** o número da plataforma.
* **Não tente reconectar** o número em outro portfólio.

## Passo 2: Identificar o motivo

Verifique o e-mail associado ao portfólio empresarial. A Meta envia notificações com o motivo do banimento.

* Também é possível verificar a qualidade do número nas **Configurações do Negócio** > **Contas do WhatsApp**.
* Clique em **Phone numbers** e veja a qualidade do canal.

<figure><img src="/files/M30S5b3gf77yGAYWcETY" alt=""><figcaption></figcaption></figure>

## Passo 3: Solicitar uma revisão

* Acesse o formulário de recurso da Meta e envie uma solicitação de revisão.
* Para o passo a passo completo, consulte o artigo [Revisão de banimento](/guide/documentacao/faq/conexao-whatsapp/erros-e-problemas/solicitar-revisao-de-banimento)

{% hint style="info" %}
**Dica para a solicitação:** Seja claro e objetivo. Descreva o uso legítimo do número, os cuidados que a empresa toma para respeitar as políticas do WhatsApp e qualquer ação corretiva que será implementada. Evite textos genéricos.
{% endhint %}

## Passo 4: Aguardar a resposta

* O prazo de análise da Meta varia de **24 horas a 48horas**.
* Durante esse período, o número permanecerá indisponível.

## Como prevenir banimentos

* **Obtenha o opt-in:** Envie mensagens apenas para contatos que consentiram em recebê-las.
* **Monitore a qualidade:** Acompanhe a classificação de qualidade do número no painel do WhatsApp Manager. Se a qualidade cair para **"Baixa"**, reduza o volume de envios.
* **Evite conteúdo repetitivo:** Varie o conteúdo das mensagens e personalize sempre que possível.
* **Respeite os limites de envio:** Não ultrapasse os limites de mensagens do seu nível de qualidade.
* **Use apenas a API oficial:** Ferramentas não oficiais ou APIs de terceiros não autorizadas aumentam significativamente o risco de banimento.

{% hint style="info" %}
**Considerações Adicionais:**

* Em caso de banimento por spam, a maioria dos números é recuperada após a revisão, desde que as políticas sejam seguidas.
* Banimentos permanentes têm chances reduzidas de reversão. A prevenção é sempre a melhor abordagem.
* Se o portfólio empresarial inteiro for banido, será necessário criar um novo portfólio e iniciar o processo de configuração do zero.
  {% endhint %}


# Revisão de banimento

Passo a passo para solicitar revisão de banimento ou bloqueio da conta do WhatsApp Business na Meta.

{% hint style="success" %}
**Pré-requisitos:**

* Ter uma conta na **Meta Business** configurada e vinculada ao seu número do WhatsApp.
* Ser um **administrador** ou possuir permissões adequadas para acessar as informações de faturamento.
  {% endhint %}

### O que significa um banimento ou bloqueio?

Quando uma conta de WhatsApp conectada via **API oficial da Meta** é banida ou bloqueada, ela perde a capacidade de **enviar e/ou receber mensagens** através da **plataforma**. Isso pode ocorrer por diversas razões, como:

* Quebra das **Políticas de Comércio** ou [**Diretrizes da Comunidade da Meta**](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement?locale=pt_BR);
* **Volume elevado de bloqueios** por parte de contatos;
* Uso de linguagem ou conteúdo considerado ofensivo ou sensível;
* Campanhas em massa sem opt-in dos contatos.

### Como identificar o bloqueio?

Você pode perceber o bloqueio por meio de:

* Mensagens com erro de envio e alertas no painel da **plataforma;**
* Aviso de status "bloqueado" ou "banido" na seção **Apps > WhatsApp API**;
* Notificações ao tentar reconectar o canal;
* Mensagens retornadas com erros como: **"Esta conta foi banida"** ou **"Violation of WhatsApp Business Policy"**.

### Passo a passo para solicitar revisão do bloqueio

Se sua conta foi bloqueada indevidamente, siga este processo para solicitar uma **revisão diretamente na Meta**:

## Passo 1: Acessar o gerenciador de negócios

* Acesse o [**Gerenciador de Negócios da Meta**](https://business.facebook.com/)**.**
* No painel principal do **portfólio empresarial**, selecione a empresa correta e clique no ícone de **engrenagem**.

<figure><img src="/files/jjrOPkFnPY76SOsJxbAv" alt=""><figcaption></figcaption></figure>

## Passo 2: Abra o Gerenciador do WhatsApp

* Clique em **Contas do WhatsApp.**
* Selecione a conta afetada.
* Role o cursor até encontrar a opção **Status da Conta**.
* Nesse campo, será exibido o **status atual da conta**, permitindo que você verifique se está ativa ou se há alguma pendência.

![](/files/Qj7rvgKpX0jJjqTFZLmm)

## Passo 3: Verifique o status da conta

* Você verá o status como:

<div align="left"><img src="/files/vu6cQqwfaIJBul3u9hRk" alt=""></div>

<div align="left"><img src="/files/KDxFhi0cJOvRzTNHN6Dx" alt=""></div>

## Passo 4: Solicitar a revisão e desbloqueio.

* Se a conta estiver **bloqueada ou desabilitada,** acesse a [**página inicial de suporte**](/guide/documentacao/faq/conexao-whatsapp/acessar-pagina-de-suporte) para solicitar a revisão e desbloqueio.
* Clique nas **três barras** no canto superior esquerdo.
* Em seguida, abrirá um menu, selecione **"Página inicial de suporte"** para acessar as informações do bloqueio.

<figure><img src="/files/Mlor8ScGmcB40bYjCrvG" alt="" width="563"><figcaption></figcaption></figure>

## Passo 5: Procure por página inicial do suporte

* Role o cursor até a seção onde constam as informações das contas de **WhatsApp**.
* Em seguida, clique sobre o **status da conta** que deseja verificar.

<figure><img src="/files/efdYjnjhP6jFNIpuXyFa" alt=""><figcaption></figcaption></figure>

## Passo 6: Verificar motivo do banimento

Ao clicar no status da conta dentro do **Meta Business Manager,** você será redirecionado para uma página dedicada a exibir os detalhes do bloqueio ou desabilitação da conta. Nela, é possível conferir:

* O motivo do bloqueio, conforme informado pelo sistema;
* A data em que a restrição foi aplicada;
* As ações disponíveis no momento, como a opção “Request Review” (Pedir Análise) para contestar a decisão.

![](/files/4dY7UOKMa3H4esu9FyBu)

## Passo 7: Solicitar revisão

* Para solicitar a revisão, clique no botão **“Pedir Análise”** e siga as instruções na tela para submeter seu pedido.
* Ao concluir, aguarde o posicionamento da equipe do Meta, que analisará sua solicitação e retornará com um parecer.

Explique que a conta está sendo usada para fins legítimos (atendimento ao cliente, vendas, suporte etc.);

<figure><img src="/files/3PnpuKsgJ1mdGOrvJ7yv" alt="" width="554"><figcaption></figcaption></figure>

### Após o envio <a href="#yfj03qlst6o5" id="yfj03qlst6o5"></a>

* A Meta geralmente conclui a análise e retorna com uma decisão em até **48 horas úteis**, embora possa levar mais tempo dependendo da complexidade do caso ou da demanda do suporte.
* A resposta será enviada para o **e-mail cadastrado** no Gerenciador de Negócios;
* Caso a revisão seja **aprovada**, a conta será reativada automaticamente.

{% hint style="warning" %}
**Dicas importantes:**

* **Nunca utilize listas de transmissão ou mensagens em massa sem consentimento (opt-in).**
* Mantenha uma linguagem neutra e profissional nas interações com os clientes.
* Evite envio repetitivo de mensagens automáticas com conteúdo promocional.
* Se o bloqueio for frequente, revise suas práticas de envio e estratégias de abordagem.
  {% endhint %}

{% hint style="info" %}
**Considerações Adicionais:**

* Nem sempre o bloqueio implica a suspensão total: às vezes, apenas funções específicas são limitadas, mas você ainda pode solicitar uma revisão.
* Se o botão de solicitação não estiver disponível, verifique se sua conta possui **autenticação de dois fatores ativada**, pois isso é exigido em alguns casos para liberar o pedido de revisão.
* Mantenha-se atento aos prazos informados. Geralmente há um período limite para enviar o pedido de revisão.
  {% endhint %}


# WhatsApp (Não Oficial)

Esta seção apresenta os procedimentos para conectar seu número do WhatsApp à plataforma utilizando APIs não oficiais. Os guias a seguir detalham as etapas necessárias para cada método de integração.

As conexões não oficiais permitem vincular seu número de WhatsApp à plataforma por meio de APIs de terceiros, como **Z-API** e **EvolutionAPI**. Essas integrações utilizam a leitura de QR Code para conectar o número, funcionando de forma semelhante ao WhatsApp Web. Esta seção reúne os guias de conexão para cada método disponível e informações sobre as restrições desse tipo de integração.

{% content-ref url="/pages/x8JBaguVo2niuaCJwXnZ" %}
[Z-API (Conta Própria)](/guide/documentacao/faq/whatsapp-nao-oficial/z-api-conta-propria)
{% endcontent-ref %}

{% content-ref url="/pages/qcouoaEuyLE6QLHaz9kX" %}
[Z-API (Integrado)](/guide/documentacao/faq/whatsapp-nao-oficial/z-api-integrado)
{% endcontent-ref %}

{% content-ref url="/pages/y3DfdoNfrhAfveNGfQ93" %}
[EvolutionAPI](/guide/documentacao/faq/whatsapp-nao-oficial/evolutionapi)
{% endcontent-ref %}

{% content-ref url="/pages/7AYLRdeCtMjrfnd13ZbF" %}
[Restrições em Conexões Não Oficiais](/guide/documentacao/faq/whatsapp-nao-oficial/restricoes-em-conexoes-nao-oficiais)
{% endcontent-ref %}


# Z-API (Conta Própria)

Guia passo a passo para conectar um canal Z-API com conta própria à plataforma.

Neste tutorial, será apresentado o processo de criação de um canal Z-API com Conta Própria. Nessa modalidade, o usuário utiliza uma instância da Z-API contratada diretamente junto ao provedor, sendo responsável pelo gerenciamento da conta e pelo faturamento do serviço.

Essa opção é ideal para usuários que desejam maior autonomia e controle sobre a administração da integração.

{% hint style="success" %}
**Pré-requisitos:**

* Ter uma **conta na plataforma.**
* Somente os usuários com perfil de Administrador podem fazer a conexão dos canais não oficiais.
* Ter uma conta na Z-API.
  {% endhint %}

## Passo 1: Acessar as configurações da conta

1. Acesse o menu **Ajustes.**
2. Clique em **Conta.**

<figure><img src="/files/ayrFraU0BcxFsUs2UAN4" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar os canais de atendimento

1. Clique na aba **Canais de atendimento**.

<figure><img src="/files/ib0YX2hmzw7c6F1PSmJ1" alt=""><figcaption></figcaption></figure>

## Passo 3: Adicione o canal

1. Na tela de Canais de atendimento, clique no ícone com destaque em azul.
2. Passe o mouse sobre **WhatsApp QRCode**.
3. Selecione a opção **Z-API (Conta própria)** como mostra a imagem abaixo.

<figure><img src="/files/TiZhiEr4GdbWJX6xGF6w" alt=""><figcaption></figcaption></figure>

## Passo 4: Inicie a integração

1. Para iniciar o processo de integração clique no botão **Iniciar** como mostra a imagem abaixo.

<figure><img src="/files/VqCfja6aUjFD2Qnq9wnB" alt=""><figcaption></figcaption></figure>

## Passo 5: Preencha as informações da sua instância

1. Informe o **ID da instância.**
2. Informe o **Token da instância.**
3. Informe o **Token de segurança.**
4. Preenchidas todas as informações, clique em **Continuar.**

<figure><img src="/files/aCGGHMzf8dnhTpFh4MMn" alt=""><figcaption></figcaption></figure>

**Veja abaixo onde encontrar essas informações no seu painel Z-API:**

* Acesse o seu portal Z-API.
* Clique na aba **Instâncias Web.**
* Copie o ID e Token da conta.

<figure><img src="/files/j90eDnkbl6rfqkLXK1gK" alt=""><figcaption></figcaption></figure>

* **O token da conta é exibido apenas no momento de sua criação**. Caso você não o tenha salvo, será necessário gerar um novo token para prosseguir com a configuração.
* Para gerar um novo token acesse a aba de segurança e clique no ícone indicado pela seta como mostra a imagem abaixo.

<figure><img src="/files/eql9xCp8lEmZ9q70QTSZ" alt=""><figcaption></figcaption></figure>

* Após clicar no ícone indicado, selecione uma opção para o recebimento do código OTP e depois confirme a escolha.

<figure><img src="/files/ZVK9HMnVP9GxLYpmr9Ci" alt=""><figcaption></figcaption></figure>

* Preencha o código recebido.
* Copie seu novo token.
* Confirme que leu o texto na tela.
* Finalize a ação.

<figure><img src="/files/eURa193plMRiIQpswYNX" alt=""><figcaption></figcaption></figure>

## Passo 6: Acesse o aplicativo do WhatsApp

1. Em seu aparelho, procure pelo ícone de configuração do WhatsApp.
2. Procure por **Dispositivos conectados.**
3. Clique no botão **Conectar um dispositivo**.
4. Clique em **Continuar**.

<figure><img src="/files/S9vDR92ecub5Y8Az8OBz" alt=""><figcaption></figcaption></figure>

## Passo 7: Ler o QRCode na tela

1. Leia o QRCode na tela com seu aparelho.
2. Clique em **Continuar**.

<figure><img src="/files/sIBpj1RS5cyi2gFtPozg" alt=""><figcaption></figcaption></figure>

## Passo 8: Finalizar o processo de conexão

1. Após seguir todos os passos acima, clique em **Finalizar**.

<figure><img src="/files/dUmpGwrNHgwyl6mStHzB" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* A integração dos **canais não oficiais** à **plataforma** permite uma gestão mais eficiente das interações com seus clientes, centralizando as mensagens em um único ambiente.
* Ao seguir os passos apresentados neste artigo, você garante que suas contas estejam corretamente conectadas, evitando falhas na comunicação e otimizando o atendimento.
  {% endhint %}


# Z-API (Integrado)

Guia passo a passo para conectar um canal Z-API integrado à plataforma, com faturamento direto pela plataforma.

Neste tutorial, será apresentado o processo de conexão de um canal Z-API Integrado. Essa modalidade se diferencia pelo modelo de faturamento, que é realizado diretamente pela plataforma, dispensando a contratação e o gerenciamento de uma conta própria na Z-API.

Essa opção é ideal para usuários que buscam praticidade e rapidez na configuração, permitindo disponibilizar novos canais de forma simples e eficiente.

{% hint style="success" %}
**Pré-requisitos**:

* Ter uma **conta na plataforma.**
* Somente os usuários com perfil de Administrador podem fazer a conexão dos canais não oficiais.
  {% endhint %}

## Passo 1: Acessar as configurações da conta

1. Acesse o menu **Ajustes.**
2. Clique em **Conta.**

<figure><img src="/files/ayrFraU0BcxFsUs2UAN4" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar os canais de atendimento

1. Clique na aba **Canais de atendimento**.

<figure><img src="/files/ib0YX2hmzw7c6F1PSmJ1" alt=""><figcaption></figcaption></figure>

## Passo 3: Adicione o canal

1. Na tela de Canais de atendimento, clique no ícone com destaque em azul.
2. Passe o mouse sobre **WhatsApp QRCode**.
3. Selecione a opção **Z-API** como mostra a imagem abaixo.

<figure><img src="/files/OCMgJWEnm40Kcp03Mms7" alt=""><figcaption></figcaption></figure>

## Passo 4: Inicie a integração

1. Para iniciar o processo de integração clique no botão **Iniciar** como mostra a imagem abaixo.

<figure><img src="/files/VqCfja6aUjFD2Qnq9wnB" alt=""><figcaption></figcaption></figure>

## Passo 5: Acesse o aplicativo do WhatsApp

1. Em seu aparelho, procure pelo ícone de configuração do WhatsApp.
2. Procure por **Dispositivos conectados.**
3. Clique no botão **Conectar um dispositivo**.
4. Clique em **Continuar**.

<figure><img src="/files/S9vDR92ecub5Y8Az8OBz" alt=""><figcaption></figcaption></figure>

## Passo 6: Ler o QRCode na tela

1. Leia o QRCode na tela com seu aparelho.
2. Clique em **Continuar**.

<figure><img src="/files/sIBpj1RS5cyi2gFtPozg" alt=""><figcaption></figcaption></figure>

## Passo 7: Finalizar o processo de conexão

1. Após seguir todos os passos acima, clique em **Finalizar**.

<figure><img src="/files/dUmpGwrNHgwyl6mStHzB" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* A integração dos **canais não oficiais** à **plataforma** permite uma gestão mais eficiente das interações com seus clientes, centralizando as mensagens em um único ambiente.
* Ao seguir os passos apresentados neste artigo, você garante que suas contas estejam corretamente conectadas, evitando falhas na comunicação e otimizando o atendimento.
  {% endhint %}


# EvolutionAPI

Guia passo a passo para conectar um canal EvolutionAPI à plataforma utilizando sua própria infraestrutura.

Neste tutorial, será apresentado o processo de conexão de um canal utilizando a Evolution API. Nessa modalidade, o usuário utiliza uma instância da Evolution API hospedada em sua própria infraestrutura, sendo responsável pelo gerenciamento da aplicação, das instâncias e da disponibilidade do serviço.

Essa opção é ideal para usuários que buscam maior autonomia, flexibilidade e controle sobre o ambiente de integração.

{% hint style="success" %}
**Pré-requisitos**:

* Ter uma **conta na plataforma.**
* Somente os usuários com perfil de Administrador podem fazer a conexão dos canais não oficiais.
* Possuir uma instância da **Evolution API** instalada e devidamente configurada em sua própria infraestrutura.
  {% endhint %}

## Passo 1: Acessar as configurações da conta

1. Acesse o menu **Ajustes.**
2. Clique em **Conta.**

<figure><img src="/files/ayrFraU0BcxFsUs2UAN4" alt=""><figcaption></figcaption></figure>

## Passo 2: Acessar os canais de atendimento

1. Clique na aba **Canais de atendimento**.

<figure><img src="/files/ib0YX2hmzw7c6F1PSmJ1" alt=""><figcaption></figcaption></figure>

## Passo 3: Adicione o canal

1. Na tela de Canais de atendimento, clique no ícone com destaque em azul.
2. Passe o mouse sobre **WhatsApp QRCode**.
3. Selecione a opção **EvolutionAPI** como mostra a imagem abaixo.

<figure><img src="/files/JANTirfvcjNWvSKsEwPH" alt=""><figcaption></figcaption></figure>

## Passo 4: Inicie a integração

1. Para iniciar o processo de integração clique no botão **Iniciar** como mostra a imagem abaixo.

<figure><img src="/files/PRcQ51ATghkTpSeEnPO0" alt=""><figcaption></figcaption></figure>

## Passo 5: Preencha as informações da sua instância

1. Informe o **Endereço do servidor.**
2. Informe o **Nome da instância.**
3. Informe o **Token da instância.**
4. Após preenchidas todas as informações, clique em **Continuar.**

<figure><img src="/files/pTiuNRVQ94LWXpl8pMpg" alt=""><figcaption></figcaption></figure>

**Veja abaixo onde encontrar essas informações no seu painel Evolution:**

* Acesse o seu portal **Evolution**.
* Vá na aba de instâncias.
* Copie o Endereço do servidor (URL).
* Nome da instância.
* Token da instância.

<figure><img src="/files/TN22uYs33QUGNBVQy0Yr" alt=""><figcaption></figcaption></figure>

## Passo 6: Acesse o aplicativo do WhatsApp

1. Em seu aparelho, procure pelo ícone de configuração do WhatsApp.
2. Procure por **Dispositivos conectados.**
3. Clique no botão **Conectar um dispositivo**.
4. Clique em **Continuar**.

<figure><img src="/files/RJnbnmHF26CnL5CDYZIC" alt=""><figcaption></figcaption></figure>

## Passo 7: Ler o QRCode na tela

1. Leia o QRCode na tela com seu aparelho.
2. Clique em **Continuar**.

<figure><img src="/files/OoZcs2XB4OXemEvzfaLr" alt=""><figcaption></figcaption></figure>

## Passo 8: Finalizar o processo de conexão

1. Após seguir todos os passos acima, clique em **Finalizar**.

<figure><img src="/files/yg9EFi6uZ4rbFKXAUT8q" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* A integração dos **canais não oficiais** à **plataforma** permite uma gestão mais eficiente das interações com seus clientes, centralizando as mensagens em um único ambiente.
* Ao seguir os passos apresentados neste artigo, você garante que suas contas estejam corretamente conectadas, evitando falhas na comunicação e otimizando o atendimento.
  {% endhint %}


# Restrições em Conexões Não Oficiais

Entenda os riscos, restrições e bloqueios que podem ocorrer ao usar conexões não oficiais (Z-API e similares) no WhatsApp.

Conexões não oficiais (como **Z-API** e ferramentas similares) utilizam métodos que simulam o uso do WhatsApp Web para conectar números à plataforma. Por não serem autorizadas pela Meta, essas conexões estão sujeitas a **restrições, bloqueios temporários (soft bans)** e até **banimentos permanentes**.

{% hint style="danger" %}
**Importante:** Não nos responsabilizamos por bloqueios ou banimentos decorrentes do uso de conexões não oficiais. O uso da **API Oficial do WhatsApp** é sempre a opção recomendada.
{% endhint %}

## O que é um soft ban?

O soft ban é um bloqueio temporário aplicado pelo WhatsApp quando detecta comportamento considerado suspeito. Diferente do banimento permanente, o soft ban geralmente não exibe uma mensagem de erro clara, e o número simplesmente para de enviar ou receber mensagens corretamente.

Um dos indicadores mais comuns é o **erro z301** (em ferramentas como Z-API), que sinaliza que o número foi temporariamente restrito.

## Fatores que causam restrições

Os principais fatores que levam a restrições e soft bans em conexões não oficiais são:

* **Diferença de localização (IP):** O número está registrado em uma cidade, mas a conexão é feita a partir de um servidor em outra região ou país. Essa divergência é um dos principais sinais detectados pelo WhatsApp.
* **Tempo de resposta do chatbot:** Respostas instantâneas e padronizadas (abaixo de 1 segundo) são facilmente identificadas como automação.
* **Alto volume de mensagens:** Enviar muitas mensagens em um curto intervalo de tempo, especialmente para contatos que nunca interagiram com o número.
* **Bloqueios em massa:** Quando muitos destinatários bloqueiam ou denunciam o número em um curto período.
* **Múltiplos IPs ou dispositivos:** Conectar o mesmo número em várias instâncias ou alternar frequentemente entre servidores.
* **Instabilidades na conexão:** Quedas frequentes e reconexões repetidas geram padrões de uso anormais.
* **Falta de aquecimento do número:** Números novos que iniciam com alto volume de mensagens sem um período de uso gradual.

## Consequências possíveis

* **Soft ban temporário:** O número fica restrito por horas ou dias. Geralmente se resolve sozinho após um período de inatividade.
* **Banimento permanente:** Em casos de reincidência ou violação grave, o número pode ser banido permanentemente sem possibilidade de recurso.
* **Perda do número:** Em banimentos permanentes via conexão não oficial, a Meta não oferece suporte para recuperação, pois o uso da ferramenta já configura uma violação dos termos de serviço.

## O que fazer em caso de soft ban

### Passo 1: Desconectar o número

* Desconecte o número da ferramenta não oficial imediatamente. Não tente reconectar.

### Passo 2: Aguardar

* Espere pelo menos **24 a 48 horas** antes de qualquer tentativa de reconexão. Em alguns casos, pode ser necessário aguardar até **72 horas**.

### Passo 3: Reduzir o volume

* Ao reconectar, reduza significativamente o volume de mensagens e aumente gradualmente ao longo de dias.

## Recomendação

Para evitar esses riscos, a melhor alternativa é migrar para a **API Oficial do WhatsApp**, que oferece:

* Conexão autorizada e estável.
* Sem risco de soft ban ou banimento por uso de ferramenta não oficial.
* Suporte da Meta para resolução de problemas.
* Maior limite de envio de mensagens conforme a qualidade do número.

{% hint style="info" %}
**Considerações Adicionais:**

* Soft bans são cada vez mais frequentes, pois o WhatsApp aprimora constantemente seus mecanismos de detecção.
* Mesmo seguindo "boas práticas" com conexões não oficiais, o risco de bloqueio nunca é eliminado, apenas reduzido.
* Se o número já sofreu múltiplos soft bans, é altamente recomendável migrar para a API oficial antes que ocorra um banimento permanente.
  {% endhint %}


# Instagram/Messenger

Guias para conectar, renovar e solucionar problemas do Instagram e Messenger na plataforma.

Para começar a atender seus contatos pelo Instagram e Messenger, conecte seu perfil do Instagram e sua página do Facebook seguindo o guia de **Conexão**. Essa permissão dura 60 dias. Quando ela expirar, use o guia de **Renovar token** para restabelecer o acesso sem perder o histórico da integração.<br>

{% content-ref url="/pages/oPfi6c4VK7zzer7J2pSW" %}
[Conectar Canal](/guide/documentacao/faq/instagram-messenger/cadastrar-instagram-facebook-messenger)
{% endcontent-ref %}

{% content-ref url="/pages/u2kQhsEHUIcdJMY2wHL4" %}
[Renovar Token](/guide/documentacao/faq/instagram-messenger/renovar-token-do-instagram-e-messenger)
{% endcontent-ref %}

{% content-ref url="/pages/7VTImlqjDyDulGARnPDH" %}
[Instagram: Mensagens Não Chegam](/guide/documentacao/faq/instagram-messenger/mensagens-do-instagram-nao-chegam)
{% endcontent-ref %}


# Conectar Canal

Guia passo a passo para conectar o Instagram e o Messenger à plataforma e centralizar o atendimento aos seus contatos.

A integração do Instagram e do Messenger à plataforma permite que sua equipe centralize os atendimentos e ganhe eficiência no suporte ao cliente. Com essa conexão, todas as mensagens recebidas nesses canais ficam disponíveis diretamente na plataforma, facilitando o gerenciamento das conversas e agilizando as respostas. A seguir, veja os pré-requisitos e o passo a passo completo para realizar a conexão.

{% hint style="success" %}
**Pré-requisitos:**

* Ter perfil de **Administrador** na plataforma, pois apenas Administradores podem conectar o Instagram e/ou o Messenger.
* Ter uma conta comercial no Instagram vinculada a uma página do Facebook.
* Ser administrador da conta no Meta Business Manager.
* Ter o Messenger da página do Facebook ativado.
  {% endhint %}

## Passo 1: Acessar Canais de Atendimento

1. No menu principal, clique em **"Ajustes" > "Conta" > "Canais de atendimento"**.
2. Clique no ícone de conexão.

<figure><img src="/files/dYtWgICj3VpGfYJkqCRm" alt=""><figcaption></figcaption></figure>

## Passo 2: Selecionar e iniciar a integração

1. Selecione a rede social que deseja integrar (Instagram e/ou Messenger).
2. Clique em **"Iniciar"**.

<figure><img src="/files/D3W91sasbCltAkVsLwWN" alt=""><figcaption></figcaption></figure>

## Passo 3: Entrar com o Facebook

1. Clique em **"Entrar com Facebook"**.
2. Faça login na conta do Facebook em que o Messenger e/ou o Instagram estão conectados ao Business Manager (BM).

<figure><img src="/files/3NWNgQZdxTwnkNcwPYbK" alt=""><figcaption></figcaption></figure>

## Passo 4: Confirmar a conta

1. Clique em **"Continuar como \[Nome da conta do Facebook]"**.

<figure><img src="/files/IhKrOBT349f5EPeh4nF2" alt=""><figcaption></figcaption></figure>

## Passo 5: Selecionar as páginas

1. Selecione as **páginas** que deseja integrar à plataforma.
2. Clique em **"Continuar"**.

{% hint style="danger" %}
**Atenção:** nesta etapa, mantenha habilitados **todos** os perfis aos quais a plataforma já tem acesso, não apenas os que você deseja integrar nesta conta específica.\
Se você remover um perfil que já está associado a outra conta, a plataforma perde o acesso a esse perfil por completo, e não somente na conta atual.\
Na próxima etapa você poderá selecionar quais perfis devem ser integrados especificamente à conta atual.
{% endhint %}

<figure><img src="/files/WSVlnemoZ0GOsKa8xlzu" alt=""><figcaption></figcaption></figure>

## Passo 6: Selecionar as empresas

1. Selecione as **empresas** que deseja integrar à plataforma.
2. Clique em **"Continuar"**.

<figure><img src="/files/khB1n5GuLDMFJaVt73JT" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Atenção:** assim como no passo anterior, mantenha habilitados **todos** os perfis aos quais a plataforma tem acesso, não somente os da conta atual. Remover o vínculo de um perfil associado a outra conta faz com que a plataforma perca o acesso a ele por completo.
{% endhint %}

## Passo 7: Selecionar as contas a conectar

1. Selecione as contas do Instagram e/ou Messenger que deseja conectar à plataforma.
2. Clique em **"Continuar"**.

<figure><img src="/files/4HA2Oja1tKNphZQyUwGP" alt=""><figcaption></figcaption></figure>

## Passo 8: Revisar e confirmar

1. Revise as informações exibidas na tela e clique em **"Salvar"**.
2. Clique em **"Entendi"** para confirmar a conexão.

<figure><img src="/files/NOrffrHbjMUudKAM5XPW" alt=""><figcaption></figcaption></figure>

## Passo 9: Retornar e finalizar

1. Você será redirecionado à plataforma para concluir o processo; as redes sociais conectadas aparecerão na tela. Clique em **"Continuar"**.
2. Clique em **"Finalizar"** para concluir a integração.

<figure><img src="/files/b6vh0JY9g8be4BXTju4K" alt=""><figcaption></figcaption></figure>

## Passo 10: Conferir o resultado

Após concluir todos os passos, a tela de **Canais de atendimento** exibirá as redes sociais conectadas.

{% hint style="info" %}
**Considerações Adicionais:**

* A integração do Instagram e Messenger à plataforma permite uma gestão mais eficiente das interações com seus clientes, centralizando as mensagens em um único ambiente.
* A cada 60 dias, o token de conexão das redes sociais expira e é necessário renová-lo.
* A janela de conversa das redes sociais permanece aberta por 7 dias. Para reiniciar a conversa com o contato após esse período, é necessário utilizar o aplicativo do Instagram/Messenger diretamente.
* Não é possível iniciar uma conversa com um contato do Instagram ou Messenger pela plataforma, apenas responder a mensagens já recebidas.
* As interações com contatos originados do Instagram e do Messenger não são cobradas.
  {% endhint %}


# Renovar Token

Guia passo a passo para renovar o token de permissão do Instagram e do Facebook Messenger e manter a integração ativa na plataforma.

Na integração com o **Instagram** e o **Facebook Messenger**, é necessário renovar o token de permissão a cada 60 dias. Esse token é fornecido pela Meta e tem prazo de validade determinado. Quando expira, as mensagens param de ser recebidas até que a renovação seja feita. Neste artigo, mostramos o passo a passo para renovar o token de forma rápida e segura.

{% hint style="info" %}
Quando chegar o momento de renovar o token, a plataforma exibirá automaticamente uma mensagem de alerta assim que você fizer login na conta.
{% endhint %}

{% hint style="success" %}
**Pré-requisitos:**

* Ter perfil de **Administrador** na plataforma, pois apenas administradores podem realizar a conexão do Instagram e/ou Messenger.
* Ter uma conta comercial no Instagram vinculada a uma página do Facebook.
* Ser administrador da conta no Meta Business Manager.
* Ter o Messenger da página do Facebook ativado.
* Ter o Instagram integrado à página do Facebook.
  {% endhint %}

## Passo 1: Iniciar a renovação

* No alerta de renovação exibido ao fazer login na plataforma.
* Clique na opção **"Alterar permissões"**.

<figure><img src="/files/6H6Qnz6dcRpNeeLneldA" alt=""><figcaption></figcaption></figure>

## Passo 2: Iniciar a integração

* Na tela de integração exibida, clique em **"Iniciar"** para prosseguir com a renovação do token.

<figure><img src="/files/E9g3JZhuWPhT94fFxKBL" alt=""><figcaption></figcaption></figure>

## Passo 3: Entrar com o Facebook

* Clique em **"Entrar com o Facebook"** para prosseguir com a autenticação.

<figure><img src="/files/FHwuxGiJnjKMsZZMQZV3" alt=""><figcaption></figcaption></figure>

## Passo 4: Selecionar as páginas

* Selecione as **páginas** que deseja integrar à plataforma.
* Clique em **"Continuar"**.

{% hint style="danger" %}
**Atenção:** nesta etapa, mantenha habilitados **todos** os perfis aos quais a plataforma já tem acesso, não apenas os que você deseja integrar nesta conta específica.\
Se você remover um perfil que já está associado a outra conta, a plataforma perde o acesso a esse perfil por completo, e não somente na conta atual.\
Na próxima etapa você poderá selecionar quais perfis devem ser integrados especificamente à conta atual.
{% endhint %}

<figure><img src="/files/ST4d9iEEt1wi0cLdp4ZP" alt=""><figcaption></figcaption></figure>

## Passo 5: Selecionar as empresas

* Selecione as **empresas** que deseja integrar à plataforma.
* Clique em **"Continuar"**.

<figure><img src="/files/Dk4bUfbFViIt2LULxKz3" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Atenção:** assim como no passo anterior, mantenha habilitados **todos** os perfis aos quais a plataforma tem acesso, não somente os da conta atual. Remover o vínculo de um perfil associado a outra conta faz com que a plataforma perca o acesso a ele por completo.
{% endhint %}

## Passo 6: Selecionar as contas a conectar

* Selecione as contas do Instagram e/ou Messenger que deseja conectar à plataforma.
* Clique em **"Continuar"**.

<figure><img src="/files/hJkWPafnFRRMiiwiLaNS" alt=""><figcaption></figcaption></figure>

## Passo 7: Selecione a conta

* Você será redirecionado à plataforma para concluir o processo; as redes sociais conectadas aparecerão na tela.
* Clique em **"Continuar"**.

<figure><img src="/files/b6vh0JY9g8be4BXTju4K" alt=""><figcaption></figcaption></figure>

## Passo 8: Finalizar

* Clique em **"Finalizar"** para concluir o processo de renovação.

<figure><img src="/files/ag6rhYe0cXIrJhbPPpEV" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* Manter o token de permissão atualizado é essencial para garantir o bom funcionamento das integrações com Instagram e Facebook Messenger na plataforma.
* É importante que o responsável pela conta tenha as permissões corretas no Gerenciador de Negócios da Meta.
* Recomendamos revisar periodicamente as conexões e garantir que os tokens estejam ativos para evitar interrupções no atendimento.
  {% endhint %}


# Instagram: Mensagens Não Chegam

Ajuste as configurações do Instagram e do Facebook para que nenhuma mensagem fique de fora do atendimento.

Quando uma conta do Instagram está mal configurada, o próprio aplicativo pode filtrar ou bloquear mensagens antes que elas cheguem à plataforma, mesmo com a integração ativa. Este artigo reúne os ajustes necessários para eliminar essas barreiras, divididos em duas frentes: primeiro no aplicativo do Instagram, depois no painel do Facebook vinculado à conta.

{% hint style="success" %}
**Pré-requisitos:**

* Acesso ao aplicativo do Instagram com a conta comercial da empresa.
* Acesso à conta do Facebook vinculada ao Instagram, com permissão para editar as **Configurações da Página**.
  {% endhint %}

## Parte 1: Ajustes no aplicativo do Instagram

Os quatro pontos abaixo precisam ser conferidos direto no celular, dentro do próprio app do Instagram.

### Passo 1: Confirme que a conta é do tipo Profissional

Vá em **Configurações e atividade > Tipo e ferramentas da conta** e veja se o tipo está marcado como **Profissional**.

{% hint style="info" %}
Contas pessoais não são compatíveis com integrações externas. É uma regra da própria Meta. Se a conta ainda estiver no modo pessoal, converta-a para profissional antes de continuar.
{% endhint %}

<figure><img src="/files/15bbnvIsyWoYAyfzT7sz" alt=""><figcaption></figcaption></figure>

### Passo 2: Deixe a conta como pública

Em **Configurações e atividade > Privacidade da conta**, desative a chave **"Conta privada"**.

{% hint style="info" %}
Enquanto a conta estiver privada, pessoas que não seguem o perfil não conseguem enviar mensagem, e essas mensagens nunca chegarão à plataforma.
{% endhint %}

<figure><img src="/files/8E6G1pCkkD1eO87drPak" alt=""><figcaption></figcaption></figure>

### Passo 3: Libere os pedidos de contato

Acesse **Configurações e atividade > Mensagens e respostas a stories > Pedidos de contato** e ajuste:

* **Quem pode enviar pedidos de contato a você** → **"Todos"**
* **Quem pode adicionar você a conversas em grupo** → **"Todos"**
* **Ocultar pedidos de contato indesejados** → **desativado**

<figure><img src="/files/2hVwFr7RYonIQz0IkNEX" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/sn9pbRZkLWiPf9WuQxc8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Se "Ocultar pedidos de contato indesejados" ficar ativado, o Instagram vai filtrar sozinho parte das mensagens recebidas, e elas nunca chegarão à plataforma, mesmo que tudo o mais esteja certo.
{% endhint %}

### Passo 4: Libere as respostas aos stories

Em **Configurações e atividade > Mensagens e respostas a stories > Respostas ao story**, selecione **"Permitir respostas de todos ao story"**.

<figure><img src="/files/QW7oqD3iwFD1m91TYBAO" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Sem esse ajuste, respostas que os contatos deixam nos seus stories não são encaminhadas para a plataforma.
{% endhint %}

## Parte 2: Ajustes no Facebook

Com o Instagram ajustado, o próximo passo é revisar a página do Facebook vinculada a ele.

### Passo 5: Entre nas configurações da conta

Acesse a conta do Facebook vinculada ao Instagram e clique em **"Configurações"**, no canto superior direito.

![](/files/sI7H4U4SQjmEW9bhRBAy)

### Passo 6: Abra as configurações da página

No menu à direita, clique em **"Configurações da Página"**.

![](/files/F8sQhq9b2k4BXAb61jfy)

### Passo 7: Abra as configurações avançadas de mensagens

Clique em **"Configurações avançadas de mensagens"**.

![](/files/ewxqQojGekExJqhINrlu)

### Passo 8: Confira se a plataforma está conectada

Veja se a plataforma aparece conectada à página. Se **não** estiver, remova o canal atual e refaça a conexão. Se **já estiver** conectada, clique em **"Edit"** para revisar as permissões.

![](/files/YtzHj8LZtAT7w7fzfIC3)

### Passo 9: Ative todas as permissões

Uma janela vai listar as permissões da integração. Confira se todas as chaves estão ligadas. Se alguma estiver desligada, ative-a e clique em **"Salvar"**.

![](/files/hfwT4KSZGMjCsdinJ6PB)

### Passo 10: Vá até Contas Vinculadas

No menu lateral esquerdo, role até encontrar **"Contas Vinculadas"** e clique nessa opção.

![](/files/4Vs5VthhS0eR2ZLrThRA)

### Passo 11: Escolha o Instagram

A tela vai listar as contas ligadas à página (Instagram, WhatsApp etc.). Clique em **Instagram**.

![](/files/Ge0syjm3JSD1lC9p0ZuO)

### Passo 12: Habilite o acesso às mensagens

Localize a chave **"Permitir acesso a mensagens do Instagram na Caixa de Entrada"** e certifique-se de que está **ligada**. Sem isso, as mensagens do Instagram não chegam à plataforma mesmo com o restante configurado.

![](/files/Swz6OFot6wReegmMjCmz)

### Passo 13: Verifique o encaminhamento de conversas

Volte às configurações da página e entre em **"Encaminhamento de conversas"**. Confirme se o encaminhamento para aplicativos externos está ativado e, se estiver desligado, ative-o para que as conversas do Instagram continuem sendo enviadas à plataforma.

<figure><img src="/files/B4sVgLntNV1kLnKziNzI" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* Se as mensagens continuarem sem chegar mesmo após revisar todos os pontos acima, remova o canal do Instagram na plataforma e refaça a conexão do zero.
* Como essas configurações envolvem duas contas diferentes (Instagram e Facebook), vale revisá-las periodicamente, pois uma alteração feita por qualquer administrador pode voltar a bloquear mensagens sem aviso.
  {% endhint %}


# Atendimento

O módulo de **Atendimento** da **plataforma** foi projetado para otimizar e simplificar o gerenciamento das interações com clientes via WhatsApp. A plataforma permite que as equipes de atendimento realizem ações como iniciar, assumir, transferir e concluir atendimentos de forma ágil e eficaz. Além disso, o sistema oferece funcionalidades adicionais como o uso de chatbots, o envio de diferentes tipos de mensagens, e a personalização de painéis, para tornar o atendimento ainda mais dinâmico e personalizado.

A seguir, abordaremos cada uma dessas funcionalidades, mostrando como utilizá-las para proporcionar uma experiência de atendimento de qualidade e garantir a melhor interação possível com os seus clientes.

{% content-ref url="/pages/gtUqQT7HWbldMP5f4tfX" %}
[Central de Atendimento](/guide/documentacao/atendimento/comece-aqui)
{% endcontent-ref %}

{% content-ref url="/pages/3wRGh8qgk8NPhNs22uQ3" %}
[Operações no Atendimento](/guide/documentacao/atendimento/operacoes-de-atendimento)
{% endcontent-ref %}

{% content-ref url="/pages/J3rtj2EQ8Kn6gvvDxGvq" %}
[Ferramentas de Interação](/guide/documentacao/atendimento/ferramentas-de-interacao)
{% endcontent-ref %}

{% content-ref url="/pages/6ymJXAWyV1lMuJDN9CQD" %}
[Integração com o CRM](/guide/documentacao/atendimento/integracao-atendimento-x-crm)
{% endcontent-ref %}

{% content-ref url="/pages/BtX1DIjftsPSuVScmq4f" %}
[Grupos do Whatsapp](/guide/documentacao/atendimento/gestao-de-grupos-no-atendimento)
{% endcontent-ref %}


# Central de Atendimento

A Central de Atendimento é a tela onde as conversas acontecem. Aqui você encontra como acessar a plataforma pela web e pelo aplicativo, e como se orientar na tela: as abas, os filtros e os dados do contato.

{% content-ref url="/pages/OSpk2WmobDH8BNACAIhf" %}
[Acessando a Plataforma pelo Aplicativo Móvel](/guide/documentacao/atendimento/comece-aqui/acessando-pelo-app)
{% endcontent-ref %}

{% content-ref url="/pages/6sL5W2odsKxqK1zPG3W2" %}
[Acessando a Plataforma pela Web](/guide/documentacao/atendimento/comece-aqui/acessando-pela-web)
{% endcontent-ref %}

{% content-ref url="/pages/6Pn2mTJW0LpndJPlwNBe" %}
[Dados do Contato e Gestão Rápida](/guide/documentacao/atendimento/comece-aqui/abrir-dados-do-contato)
{% endcontent-ref %}

{% content-ref url="/pages/R88rjaPQxHSdk2Wn99wS" %}
[Iniciar Atendimento](/guide/documentacao/atendimento/operacoes-de-atendimento/iniciar-atendimento)
{% endcontent-ref %}


# Acessando a Plataforma pelo Aplicativo Móvel

Este guia detalha o processo de login seguro e o gerenciamento da sessão no aplicativo móvel.

Ao acessar sua conta pelo aplicativo, um código de validação será enviado para o seu canal de comunicação principal para garantir a segurança do seu login.

{% hint style="success" %}
**Pré-requisitos**

* **Cadastro Ativo:** Possuir um cadastro válido na plataforma.
* **Informações de Usuário:** Ter um número de telefone com WhatsApp configurado e/ou um e-mail cadastrado para recebimento do código de validação.
* **Aplicativo Instalado:** Ter o aplicativo da plataforma devidamente baixado no seu dispositivo móvel.
  {% endhint %}

### **Passo 1: Iniciar o Acesso**

1. Abra o aplicativo móvel.
2. Clique no botão "Entrar".

### **Passo 2: Inserir Credenciais e Receber o Código**

1. Preencha o campo de acesso com o telefone (com DDD) ou e-mail utilizado no seu cadastro de usuário.
2. Um código de 6 dígitos será enviado automaticamente para o canal de comunicação escolhido (WhatsApp ou E-mail).

### **Passo 3: Validação e Abertura**

1. Insira o código de 6 dígitos recebido no campo indicado.
2. Clique no botão "Entrar".
3. Após a validação bem-sucedida, o aplicativo será aberto diretamente na tela de Atendimentos, com foco no botão "Novos".

{% hint style="warning" %}
**Observação Importante sobre a Sessão**

**Sua sessão permanece ativa** na plataforma até que você realize o ***logout*** clicando explicitamente na opção **"Sair"**. Se você apenas fechar o aplicativo, o login permanecerá ativo.
{% endhint %}


# Acessando a Plataforma pela Web

Este guia detalha o processo de login e as considerações iniciais para acessar sua conta através do navegador.

A plataforma utiliza um código de validação em cada acesso para garantir a segurança da sua conta.

{% hint style="success" %}
**Pré-requisitos**

Para realizar o login com sucesso, certifique-se de atender aos seguintes requisitos:

* **Cadastro Válido:** Ser um usuário já cadastrado na plataforma.
* **Canal de Comunicação:** Possuir um número de telefone com WhatsApp e/ou um e-mail ativo cadastrado para recebimento do código de validação.
* **Navegador Recomendado:** Recomenda-se utilizar o Google Chrome para garantir a melhor experiência e compatibilidade.
  {% endhint %}

### **Passo 1: Iniciar o Login**

1. Acesse o site oficial da plataforma.
2. Clique no botão "Entrar" para ser direcionado à tela de login.

### **Passo 2: Inserir Credenciais**

1. Preencha o campo de acesso com o telefone (com DDD) ou e-mail utilizado no seu cadastro.
2. Um código de 6 dígitos será enviado para o seu canal de comunicação principal (WhatsApp ou E-mail).

### **Passo 3: Validar o Acesso**

1. Insira o código de 6 dígitos recebido.
2. Clique em "Entrar" para prosseguir.

{% hint style="warning" %}
**️ Atenção à Sessão Ativa**

Sua sessão permanecerá ativa na plataforma após o login bem-sucedido. Para garantir que sua conta seja desconectada por segurança, é fundamental que você utilize o processo de ***logout*** clicando explicitamente na opção "**Sair"** sempre que terminar de usar a plataforma.
{% endhint %}

<figure><img src="/files/jd1MniVMSjluvqnqg3TF" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais: Primeiro Acesso**

Se este for seu primeiro acesso à plataforma, após a validação do código acima, você será solicitado a aceitar os Termos de Uso e Privacidade:

1. Clique na caixa de seleção para indicar que leu e aceita os termos.
2. Clique no botão "Concordo".
3. Importante: Para finalizar a primeira autenticação, um novo código de 6 dígitos será enviado para o mesmo canal de comunicação utilizado no Passo 2. Insira este novo código e clique em "Continuar".
   {% endhint %}


# Abas, Filtros e Ações em Massa

Utilize as Abas, Filtros e Ações em Lote para Otimizar o Fluxo de Trabalho e a Produtividade.

Este guia oferece uma visão completa sobre as funcionalidades de abas, filtros e opções adicionais, permitindo que você gerencie suas conversas de forma mais eficiente, otimize o trabalho e garanta que nenhuma comunicação importante seja perdida.

#### 1. Visão Geral: As Abas de Atendimento

Na tela inicial da plataforma, ao clicar em "Atendimentos", você encontra três abas principais para classificar o fluxo de trabalho:

| Aba    | Propósito                                                                                                                                        | Quem Visualiza                         |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- |
| Novos  | Conversas que acabaram de chegar e ainda não foram iniciadas por nenhum atendente. São os contatos aguardando o primeiro atendimento.            | Todos os usuários com permissão.       |
| Meus   | Conversas que você iniciou ou que foram atribuídas a você. É sua fila de trabalho pessoal para acompanhamento e resposta.                        | Apenas o usuário logado (você).        |
| Outros | Conversas iniciadas por outros usuários que pertencem à sua equipe. Permite acompanhar, dar suporte ou assumir conversas em andamento da equipe. | Usuários que pertencem à mesma equipe. |

#### 2. Funções de Busca e Filtragem

A área de Atendimentos oferece filtros e ordenação para ajudar a localizar e gerenciar conversas de forma eficiente. Os ícones de filtro e ordenação estão localizados acima da lista de atendimentos.

**2.1. Aplicando Filtros (Ícone do Funil)**

Clique no ícone de Filtro (o funil) para abrir o menu de opções. Você pode filtrar os atendimentos de acordo com as seguintes categorias:

* **Canais:** Filtre por números, Messenger ou Instagram.
* **Etiquetas:** Filtre por *tags* aplicadas aos contatos (Ex: Cliente, Oportunidade, Teste).
* **Usuários:** Filtre por atendentes específicos.
* **Equipes:** Filtre por equipes específicas.

**Como Aplicar:**

1. Clique na seta (▼) do filtro desejado (ex: Etiquetas).
2. Selecione a(s) opção(ões) desejada(s) (Ex: Marque a caixa "Oportunidade").
3. O filtro é aplicado automaticamente ao clicar fora do menu. O ícone de filtro correspondente ficará escuro quando estiver ativo.

<figure><img src="/files/XKA01ym5fQcHuh2iVupy" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/IJYEeHV7vOARK7HWW1vd" alt=""><figcaption></figcaption></figure>

**2.2. Ordenação de Atendimentos**

Clique no ícone de Ordenação para reordenar a lista:

* **Mais antigos primeiro:** Exibe os atendimentos em ordem cronológica crescente.
* **Últimas interações primeiro:** Exibe os atendimentos com as interações mais recentes no topo.
* Você pode **ordenar os atendimentos** para facilitar a organização e priorização. Para isso:

1. Clique no **ícone de ordenação**.
2. Um menu com as opções será exibido:
   * **Mais antigos primeiro**: Exibe os atendimentos em ordem cronológica crescente.
   * **Últimas interações primeiro**: Exibe os atendimentos com as interações mais recentes no topo.

![](/files/5fpiHBXiMncQjW0HYh3W)

**2.3. Exibição Rápida**

Utilize os botões de filtro rápido para visualizações específicas:

* **Mensagens Não Lidas :** Filtra a lista automaticamente, mostrando apenas as mensagens que você ainda não leu.
* **Apenas Meus Atendimentos:** Atualiza a lista para mostrar somente os atendimentos que estão sob sua responsabilidade (equivalente à aba "Meus").

<figure><img src="/files/4qLt4AUnBxoOdkeATC1m" alt=""><figcaption></figcaption></figure>

#### 3. Outras Opções (Novo Atendimento, Novo Grupo e Ações em Lote)

O menu de "Outras Opções" (acessível pelo ícone de três pontos próximo às abas) oferece funcionalidades para criar novas interações e, principalmente, gerenciar múltiplas conversas de uma só vez:

* **Novo Atendimento:** Inicia uma conversa com um contato existente ou novo.
* **Novo Grupo:** Cria um novo grupo de conversa dentro da plataforma.
* **Selecionar Conversas (Ações em Lote):** Permite selecionar múltiplas conversas para aplicar uma ação em massa (Transferir, Concluir, etc.).

<figure><img src="/files/h1RRqjehdSOExTEKFA43" alt=""><figcaption></figcaption></figure>

**3.1. Utilizando Ações em Lote ("Selecionar Conversas")**

A funcionalidade **"Selecionar Conversas"** permite que você aplique uma ação única (em lote) a vários atendimentos ao mesmo tempo, otimizando seu fluxo de trabalho.

**Como Usar:**

1. Clique no ícone de "Outras Opções" (:).
2. Clique em "Selecionar Conversas". Checkboxes aparecerão ao lado de cada atendimento.
3. Selecione as conversas desejadas.
4. O menu de ações em lote aparecerá, exibindo as opções contextualmente apropriadas para a aba atual.
5. Clique na ação desejada para aplicá-la a todos os itens selecionados.

| Aba de Atendimento | Ações em Lote Disponíveis                                              | Propósito Principal                                  |
| ------------------ | ---------------------------------------------------------------------- | ---------------------------------------------------- |
| Novos              | <p>\* Transferir</p><p>\* Concluir Atendimento</p>                     | Direcionamento e finalização da fila de espera.      |
| Meus               | <p>\* Marcar como lida/Não Lida</p><p>\* Transferir<br>\* Concluir</p> | Gerenciamento e finalização da sua própria fila.     |
| Outros             | <p>\* Transferir</p><p>\* Concluir Atendimento</p>                     | Intervenção e organização de atendimentos da equipe. |

{% hint style="info" %}
**Considerações Adicionais (Perfis de Supervisão)**

Tem permissão para **visualizar todos os atendimentos das equipes** que integra. Pode interagir na conversa, assumir, transferir e concluir atendimentos de outros membros da equipe.
{% endhint %}


# Dados do Contato e Gestão Rápida

Guia para Visualizar, Editar e Gerenciar o Histórico Completo do Cliente Diretamente na Tela de Atendimento.

O Painel de Dados do Contato oferece uma visão detalhada e funcionalidades de gestão essenciais para otimizar a organização e a segmentação dos seus contatos diretamente na tela de atendimento.

## 1. Abertura do Painel e Ações Rápidas

### **1.1. Abrindo o Painel**

Para acessar, estando dentro de um atendimento, localize e clique no ícone Dados do Contato no canto superior direito da tela. O painel se expandirá na lateral direita.

<figure><img src="/files/wQo2Qs4d5Vjrz5J2OOQe" alt=""><figcaption></figcaption></figure>

### **1.2. Ações de Gestão (Ícones Superiores)**

Na barra superior do painel, você encontra ícones de ações rápidas para gerenciar o status do contato:

* **Arquivar Contato:** Move o contato para a seção de arquivados. O contato será reativado e um novo atendimento será iniciado caso ele envie uma nova mensagem, fazendo com que ele retorne às filas da plataforma.
* **Bloquear Contato:** Impede a recepção de novas mensagens enviadas por este contato. Nenhuma interação futura dele será registrada ou aparecerá nas filas de atendimento da plataforma.
* **Editar Contato:** Abre o modo de edição dos campos.

<figure><img src="/files/kcSMgfuw0V1nsLTRW9LA" alt=""><figcaption></figcaption></figure>

## 2. Visão Detalhada: Abas do Contato

O painel é organizado em várias abas, cada uma oferecendo informações e funcionalidades específicas sobre o histórico e o status do contato.

### **2.1. Detalhes**

Esta é a aba principal, exibindo todas as informações do cadastro:

* **Campos Pré-Existentes:** Nome, Telefone, E-mail, Instagram, Etiquetas, Sequências Ativas e Notas Internas.
* **Campos Personalizados:** Permite visualizar e editar quaisquer campos adicionais que sua equipe tenha criado. *Lembre-se: campos personalizados são replicados automaticamente para todos os demais contatos.*

**Edição:** Para editar qualquer campo, clique no ícone de lápis ou vá até o botão "Editar" na barra superior, faça as alterações e clique em "Salvar".

### **2.2. Mensagens Agendadas**

Aqui você pode visualizar todas as mensagens que foram agendadas para serem enviadas a este contato no futuro. É possível gerenciar (editar ou cancelar) esses agendamentos diretamente nesta aba.

### **2.3. Arquivos**

Esta aba funciona como um repositório, exibindo todos os arquivos, mídias e links já trocados neste histórico de conversas. Você pode utilizar o campo de busca e o filtro de tipo (Documento, Link, Mídia) para localizar rapidamente um item.

### **2.4. Conversas**

Nesta aba, você visualiza um histórico consolidado de todas as interações e atendimentos (atuais e passados) realizados com este contato em diferentes canais.

### **2.5. Painéis**

É possível ver em quais Painéis de acompanhamento este contato está atrelado. Você pode acessar o painel completo facilmente, basta clicar sobre o item listado.

### **2.6. Pagamentos**

A aba Pagamentos oferece uma visão rápida e consolidada de todo o histórico financeiro e transacional deste contato.

Você pode acompanhar:

* **Histórico de Valores:** A lista completa de todos os pagamentos e transações associadas ao contato.
* **Status Financeiro:** O status atualizado de cada transação (como "Vencido", "Pago", "Pendente", etc.), permitindo que você identifique rapidamente pendências financeiras durante o atendimento.

<figure><img src="/files/bc4OZJGFzkshVSgmAAhR" alt=""><figcaption></figcaption></figure>


# Como os atendimentos chegam até você

Entenda por que você vê algumas conversas e não outras, e o que significa o cronômetro que aparece no card.

Nem todo mundo da equipe vê as mesmas conversas. Quando uma mensagem nova chega, a plataforma decide para quem ela vai, e essa decisão depende de três coisas: se a equipe usa distribuição automática, se o contato já tem alguém responsável por ele, e se você está marcado como disponível.

Este artigo explica o que você vê na tela de atendimento e por quê. A configuração de cada comportamento fica em outro lugar, e o link aparece na seção correspondente.

## A fila de Novos

Se a sua equipe não usa distribuição, toda mensagem nova aparece para todos os usuários da equipe, e quem chegar primeiro assume.

Com a distribuição ligada, muda: cada mensagem nova vai para a fila **Novos** de **um usuário por vez**, seguindo uma ordem fixa. Enquanto a conversa estiver direcionada a alguém, os outros da equipe não a enxergam nem conseguem iniciá-la.

Por isso, se um colega comenta de um atendimento que você não está vendo, provavelmente ele está direcionado a outra pessoa no momento.

Para entender em detalhe como o rodízio funciona, acesse [Como Funciona](/guide/documentacao/apps/distribuicao-de-atendimentos/como-funciona).

{% hint style="info" %}
A ordem é definida pela data em que cada usuário foi cadastrado na conta: os mais antigos recebem primeiro. Ela não pode ser alterada. Para consultá-la, um Administrador acessa **Ajustes → Equipes**, abre a equipe e clica em **Ver ordem**. Na lista, uma **seta** aponta quem é o próximo a receber no momento em que a janela foi aberta.
{% endhint %}

## Quando o contato já tem um responsável

Se a equipe usa **carteiras**, elas vêm antes da distribuição.

Um contato que já está na carteira de alguém vai direto para essa pessoa, sem passar pela ordem do rodízio. Isso acontece mesmo que a vez fosse de outro usuário, e mesmo que o responsável esteja marcado como indisponível no momento.

A distribuição automática só entra em ação para contatos que não têm carteira, ou cuja carteira pertence a outra equipe.

Para saber mais sobre carteiras e os dois modelos disponíveis, acesse [Funcionamento da Carteirização](/guide/documentacao/crm/carteiras/funcionamento-da-carteirizacao).

<figure><img src="/files/WKtxRAKt7usU8tXP3NDn" alt=""><figcaption></figcaption></figure>

## O cronômetro no card

Se aparecer um cronômetro na conversa direcionada a você, a equipe tem **transbordo** ativado.

Ele mostra quanto tempo resta para você iniciar o atendimento. Se o tempo acabar, a conversa passa automaticamente para o próximo usuário da ordem, e depois para o seguinte, até alguém assumir. Existe também um tempo total do ciclo: quando ele é atingido sem que ninguém tenha assumido, a conversa é liberada para toda a equipe.

Sem transbordo ativado, a conversa fica com você até que você mesmo a inicie, sem prazo.

Para entender o ciclo completo de repasse, acesse [Transbordo na Distribuição](/guide/documentacao/apps/distribuicao-de-atendimentos/transbordo-na-distribuicao).

<figure><img src="/files/xUx1LVpq9VAQHZBmEfDu" alt=""><figcaption></figcaption></figure>

## Quando você está indisponível

Um usuário marcado como **Indisponível** é pulado no rodízio e no ciclo de transbordo, e para de receber novos atendimentos até voltar a ficar disponível.

Duas exceções importantes. Se **todos** os usuários da equipe estiverem indisponíveis, a plataforma ignora a distribuição e envia o atendimento para a equipe inteira, para que a conversa não fique parada. E, como visto acima, contato carteirizado chega ao responsável mesmo que ele esteja indisponível.

Quando isso acontece, a própria conversa avisa. No lugar da distribuição, aparece a mensagem **Atendimento não distribuído**, explicando que o atendimento não pôde ser distribuído por falta de usuários disponíveis, com a data e a hora em que isso ocorreu.

{% hint style="info" %}
Esse aviso não é erro nem falha de entrega. A conversa chegou normalmente e está disponível para toda a equipe assumir. Ele só registra que, naquele momento, não havia ninguém disponível para receber pelo rodízio.
{% endhint %}

<figure><img src="/files/VEqRAFXnJwEm8h1ep22v" alt=""><figcaption></figcaption></figure>

Quem define a disponibilidade dos usuários é um Administrador, em [Como Configurar](/guide/documentacao/apps/distribuicao-de-atendimentos/como-configurar).


# Operações no Atendimento

{% embed url="<https://drive.google.com/file/d/1t08jgyLLk2wYIXKuk6oK4Vf0LIstV1Kn/view>" %}

Esta seção apresenta o ciclo de vida completo de um atendimento, desde o recebimento da conversa até sua finalização. Aqui, você encontrará guias e passo a passos para iniciar, assumir, transferir, reativar e concluir atendimentos, garantindo mais clareza, agilidade e controle em todo o fluxo de trabalho.

{% content-ref url="/pages/R88rjaPQxHSdk2Wn99wS" %}
[Iniciar Atendimento](/guide/documentacao/atendimento/operacoes-de-atendimento/iniciar-atendimento)
{% endcontent-ref %}

{% content-ref url="/pages/xQglqHT7RbobhkMFcWDp" %}
[Assumir Atendimento](/guide/documentacao/atendimento/operacoes-de-atendimento/assumir-atendimento)
{% endcontent-ref %}

{% content-ref url="/pages/E2O5fK2AKr2as1u5fEHf" %}
[Transferir Atendimento](/guide/documentacao/atendimento/operacoes-de-atendimento/transferir-atendimento)
{% endcontent-ref %}

{% content-ref url="/pages/qzkIHVWHu5JlVG0H9fvb" %}
[Reiniciar Atendimento](/guide/documentacao/atendimento/operacoes-de-atendimento/reiniciar-atendimento)
{% endcontent-ref %}

{% content-ref url="/pages/flZDUHS5tyaQ5FbRB0fR" %}
[Concluir e Classificar Atendimento](/guide/documentacao/atendimento/operacoes-de-atendimento/concluir-atendimento)
{% endcontent-ref %}

{% content-ref url="/pages/oo4W9j41WKFRFqnZ3ReF" %}
[Preferências de Arquivamento](/guide/documentacao/atendimento/operacoes-de-atendimento/alterar-padrao-de-arquivamento-12h-imediato)
{% endcontent-ref %}


# Iniciar Atendimento

Guia detalhado para iniciar uma conversa com um novo contato a partir da área de Atendimentos.

{% embed url="<https://drive.google.com/file/d/1Cd8d4KXSFMHwjjC43ZATn39m0LCrsPf3/view?usp=sharing>" %}

Na plataforma, os atendimentos podem ser iniciados de duas formas:

**Ativa:** quando a sua empresa inicia a conversa com o contato, seja por meio de um modelo de mensagem utilizando a API Oficial ou diretamente pela API Não Oficial.

**Receptiva:** quando o próprio contato envia a primeira mensagem e a empresa recebe o atendimento.

### **Passo 1: Iniciar o atendimento**

1. Na tela de **Atendimentos**, localize no canto inferior esquerdo o campo destinado à inserção do número.
2. Digite o número completo do contato, incluindo o **DDD**.
3. Clique no botão **“Conversar”** para dar início ao atendimento.

<figure><img src="/files/15QX6EbIm0pr08mruOx0" alt=""><figcaption></figcaption></figure>

### **Passo 2: Escolher o tipo de envio**

Após clicar em **“Conversar”**, será exibido o painel **Enviar mensagem**.

1. Confirme os dados do contato encontrado.
2. Em **“Selecione o tipo de envio”**, escolha a opção **Iniciar atendimento**.
3. Na próxima tela, selecione o **canal** para iniciar o atendimento.

**Para API Não Oficial:**

4\. Selecione a **equipe** que será associada ao atendimento.\
5\. O atendimento será aberto automaticamente.

**Para API Oficial:**\
\
4\. Selecione a **equipe** que será associada ao atendimento.\
5\. Escolha o **modelo de mensagem** obrigatório.\
6\. Insira os **parâmetros do modelo** na tela seguinte (quando houver parâmetros no Modelo de Mensagem)\
7\. Clique em **“Iniciar atendimento”** para abrir o atendimento com o modelo de mensagem selecionado.

<figure><img src="/files/ixUOs0B0iUyPG7oxQsrR" alt=""><figcaption></figcaption></figure>

### **Iniciar Atendimento pelo "Menu de Opções"**

Além de iniciar o atendimento pelo campo na barra inferior, você também pode começar a conversa acessando o **menu de opções**.

**Passo 1: Iniciar atendimento pelo menu de opções**

1. Na tela de **Atendimentos**, clique no ícone de três pontos (**⋮**).
2. No menu que se abre, selecione **“Novo atendimento”**.
3. No painel lateral, serão exibidos os contatos cadastrados na conta. É possível **pesquisar pelo nome ou pelo número** do contato.
4. Clique no ícone<img src="/files/Ot2c8QRH8WYH0i6PY7P5" alt="" data-size="line">para iniciar o atendimento.

{% hint style="info" %}
Ao iniciar pelo menu de opções, serão exibidos os mesmos painéis do fluxo padrão: **Escolher o tipo de envio**, **Selecionar Canal e Equipe**, **Selecionar Modelo de Mensagem**, **Definir Parâmetros** e **clicar em “Iniciar atendimento”.**
{% endhint %}

<figure><img src="/files/Gu5aOVDIL9NcNhdSdpml" alt=""><figcaption></figcaption></figure>

### **Adicionar um novo contato**

No painel lateral, você também pode adicionar um novo contato:

1. Acima da barra de pesquisa, clique no botão **“Novo contato”**.
2. Preencha os dados do contato no painel que será aberto.
3. Clique em **Salvar**; o novo contato será exibido na lista de contatos cadastrados.

<figure><img src="/files/nnFLp249wm34ORMAayCm" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Considerações Adicionais – API Oficial**

**1. Mensagens na Fila de Espera**\
Enquanto o contato não responder e a janela de conversa não estiver ativa, é possível enfileirar novas mensagens.\
As mensagens enfileiradas permanecerão aguardando e serão enviadas automaticamente assim que o contato responder e a janela de conversa for liberada.

**2. Implicações de Custo**\
É importante estar atento ao modelo de precificação da **API Oficial**:

* Toda mensagem iniciada pela empresa (utilizando um **Modelo de Mensagem** após 24 horas) é classificada como **“Conversa Iniciada pela Empresa”** e gera cobrança.
* Para informações detalhadas sobre valores e regras de cobrança, tanto para conversas iniciadas pela empresa quanto para conversas iniciadas pelo usuário, consulte o site oficial do provedor da API (**Meta/Facebook**) ou entre em contato com a nossa equipe de **Suporte**.
  {% endhint %}


# Assumir Atendimento

Este guia explica como um usuário pode assumir um atendimento recém-chegado à sua equipe.

{% embed url="<https://drive.google.com/file/d/1DqXcygXDnXw6SYr0rMZRP7Jlb7UNPoxM/view?usp=sharing>" %}

Toda nova interação recebida é direcionada primeiro para a aba **“Novos”** da equipe responsável. O atendimento chega para a **equipe cadastrada como padrão** ou, caso exista um **chatbot recepcionando**, para a **equipe padrão configurada nesse chatbot**.\
Enquanto estiver na aba **“Novos”**, o atendimento permanece aguardando até que um membro da equipe o assuma para iniciar a troca de mensagens.

{% hint style="success" %}
**Pré-requisitos:**

* **Associação à equipe:** Você deve estar associado às equipes responsáveis por receber os novos atendimentos.
  {% endhint %}

### **Passo 1: Assumir um atendimento**

1. Na barra superior, clique em **“Atendimentos”**.
2. Acesse a aba **“Novos”**. O número exibido ao lado do nome da aba indica quantos atendimentos estão aguardando início.
3. Na lista, selecione o atendimento que deseja assumir. A visualização da conversa será aberta.
4. No canto inferior direito da tela, clique no botão **“Iniciar”**.
5. Ao clicar em **“Iniciar”**, o atendimento é automaticamente assumido por você e movido da aba **“Novos”** para **“Meus”**.
6. O status do atendimento é atualizado de **“Pendente”** para **“Em andamento”**.

<figure><img src="/files/HwOUKgEtqsPKF4R4dfDP" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Regras e Considerações Importantes**

* **Leitura da Mensagem:** O contato só verá que a mensagem foi lida quando o usuário clicar em 'Iniciar' para assumir o atendimento.
* **Janela de 24 Horas (Meta):** Se o contato não interagir ou responder dentro de 24 horas após a última mensagem, a "janela de conversa livre" será encerrada pela Meta. Para reiniciar o atendimento após esse período, será necessário enviar um modelo de mensagem pré-aprovado.
  {% endhint %}


# Transferir Atendimento

Este guia explica como transferir conversas entre usuários e equipes, garantindo continuidade, organização e flexibilidade na gestão dos atendimentos.

{% embed url="<https://drive.google.com/file/d/1VDgntx73JKrSHxe3BSNRnkNPPh1LUNAG/view>" %}

Um atendimento pode ser transferido **antes de ser assumido** ou **durante seu andamento**, tanto para outra equipe quanto para outro usuário.

#### Passo 1: Selecionar o atendimento e iniciar a transferência

1. Na tela de **Atendimentos**, localize a conversa desejada em uma das abas: **Novos**, **Meus** ou **Outros**.

{% hint style="info" %}
**Atenção às regras de permissão por aba:**

* **Aba Novos e Meus:** a transferência é livre para qualquer membro da equipe.
* **Aba Outros:** ação restrita — **Administradores** e **Supervisores** podem transferir atendimentos desta aba. **Atendentes não têm permissão**.
  {% endhint %}

2. Clique no botão **"Transferir"**:

* Em atendimentos já em andamento (abas **Meus**/**Outros**), o botão fica no canto superior direito.
* Em atendimentos na fila **Novos**, o botão fica no canto inferior direito.

<figure><img src="/files/vloucam3uZvINDpUfd30" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Q4gJ6tsgjNdyxlo01FKr" alt=""><figcaption></figcaption></figure>

#### Passo 2: Escolher o destino da transferência

O modal de transferência é dividido em duas abas: **"Para uma equipe"** e **"Para um usuário"**. Ambas contam com um campo de busca para localizar rapidamente o destino desejado.

**Transferindo para uma equipe**

* Cada equipe pode exibir dois indicadores ao lado do nome:
  * **Cadeado:** equipe com restrição de acesso.
  * **Seta circular:** equipe com distribuição automática de atendimentos habilitada.
* Selecione a equipe desejada e clique em **"Transferir"** para confirmar.

**Transferindo para um usuário**

* Cada usuário exibe um indicador de disponibilidade no avatar: disponível ou indisponível.
* Ao selecionar um usuário, o botão de ação muda para **"Continuar"**.
* O sistema só pede para escolher a equipe de destino quando o usuário selecionado não pertence à equipe atual do atendimento e está vinculado a duas ou mais equipes. Se ele tiver apenas uma equipe, a transferência é concluída direto para ela.

<figure><img src="/files/Cy4tOnYRK5K09vNmA9E2" alt=""><figcaption></figcaption></figure>

**Cancelamento**

Clicar em "Cancelar" ou fechar o modal encerra a ação sem nenhuma alteração: o atendimento permanece com o responsável e a equipe atuais.

#### Resultado da Transferência

| Destino             | Resultado da Conversa                                                                                               | Onde Aparece                                                                                                                                                                     |
| ------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Para uma equipe** | O atendimento é enviado para a fila de espera da nova equipe, ficando disponível para que qualquer membro a assuma. | O atendimento retorna para a aba "Novos" da equipe de destino.                                                                                                                   |
| **Para uma pessoa** | O atendimento é transferido e atribuído diretamente ao usuário escolhido.                                           | O atendimento passa a aparecer na aba "Meus" do usuário de destino e, dependendo da configuração da equipe, permanece na aba "Outros" para os demais membros da equipe original. |

{% hint style="info" %}
**Restrições de visualização**

Ao transferir um atendimento entre equipes, ele passa a seguir as preferências de visualização da nova equipe:

* **Todos:** visível a todos os usuários da equipe na aba Outros, e a todos os usuários na aba Concluídos.
* **Equipe:** visível apenas aos usuários da equipe, nas abas Outros e Concluídos.
* **Atendente:** visível apenas ao atendente responsável pela conversa e aos supervisores da equipe, nas abas Outros e Concluídos.
  {% endhint %}


# Concluir e Classificar Atendimento

Guia de Processo: Como Concluir e Classificar Atendimentos na Plataforma.

{% embed url="<https://drive.google.com/file/d/1Qn0zwWBWRCQQiIVKoTuKm9fOSToF1gDM/view?usp=sharing>" %}

Encerrar uma conversa após finalizar as tratativas é essencial para manter a organização, evitar contatos sem resposta e garantir eficiência no gerenciamento das filas.

{% hint style="info" %}
**Importante:** Concluir um atendimento é uma ação interna da plataforma e **não interfere** na janela de 24 horas de mensagens definida pela Meta.
{% endhint %}

{% hint style="success" %}
**Pré-requisitos**

* **Permissão:** Ser o usuário responsável pela conversa, Supervisor da equipe ou Administrador da conta.
* **Classificação (opcional):** Ter o App Classificação de Atendimento ativo (Menu **APP > Mais Apps**) para usar o recurso.
  {% endhint %}

#### **Passo 1: Iniciar a conclusão**

1. Na tela de **Atendimentos**, selecione a conversa que deseja encerrar.
2. Clique no botão **Concluir**.
   * Em atendimentos em andamento: botão no **canto superior direito**.
   * Em atendimentos na fila **Novos**: botão no **canto inferior direito**.

<figure><img src="/files/a3OZLXuXn8TGnjjlaSfk" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GxrwXPNNp12QDMJ2Yaf0" alt=""><figcaption></figcaption></figure>

#### **Passo 2: Escolher o tipo de encerramento**

Ao clicar em **Concluir**, serão exibidas duas opções:

1. **Classificar e Concluir** (disponível se o App estiver ativo).
2. **Concluir** (sem classificação).

<figure><img src="/files/VSlcw1yY4NPtT61Lq7MW" alt=""><figcaption></figcaption></figure>

#### **Passo 3: Classificar o atendimento (opcional)**

Se você selecionar **Classificar e Concluir**, será aberta uma nova janela.

1. **Categoria:** Escolha uma das quatro opções pré-definidas: Objetivo Atingido, Objetivo Perdido, Dúvidas, Outro.
2. **Descrição:** Selecione o motivo que melhor representa o encerramento.
3. **Etiqueta (opcional):** Adicione uma tag, se desejar.
4. Clique em **Concluir** (canto inferior direito).

O atendimento será finalizado com a classificação aplicada.

<figure><img src="/files/oUrzIV75rcPyZShqSHyC" alt=""><figcaption></figcaption></figure>

#### **Passo 4: Gerenciar classificações**

As quatro categorias principais são fixas, mas seus motivos podem ser personalizados.

Para cadastrar um novo motivo:

1. Na janela de classificação, clique em **Alterar classificações de atendimento**.
2. Na nova janela, clique em **Adicionar nova classificação.**
3. Preencha a **Descrição**, selecione a **Categoria** e indique se o motivo deve ter **Valor Monetário**.
4. Clique em **Salvar**.

<figure><img src="/files/kA1XX2DCNII7ZeBrGpUt" alt=""><figcaption></figcaption></figure>

#### **Passo 5: Visualizar atendimentos concluídos**

Após a conclusão, o atendimento é movido para a pasta **Concluídos**.

1. Clique no ícone de **Concluídos** na parte superior da lista de atendimentos.
2. Selecione o atendimento desejado.
3. O motivo da conclusão será exibido no rodapé da página.

<figure><img src="/files/IxBcU3FyGDvPzM4ohzEt" alt=""><figcaption></figcaption></figure>

#### **Passo 6: Editar a Classificação do Atendimento**

Mesmo após concluir um atendimento, é possível ajustar sua classificação caso seja necessário corrigir ou complementar as informações.

1. Clique no **ícone de edição** exibido no atendimento concluído.
2. O painel de **Classificação de Atendimento** será reaberto.
3. Atualize a **Categoria**, **Descrição** ou **Etiqueta** conforme necessário.
4. Clique em **Concluir** para salvar as alterações.<br>

* As mudanças serão aplicadas imediatamente e ficarão registradas no atendimento.
* Somente o **usuário responsável** pela conversa ou o **Administrador** podem realizar a edição.
* Não há prazo definido para editar a classificação de um atendimento; a atualização pode ser feita a qualquer momento.

<figure><img src="/files/T0QKuxlQKpLdAdnP7rL4" alt=""><figcaption></figcaption></figure>


# Reiniciar Atendimento

Este guia explica como reabrir uma conversa que foi concluída ou cuja janela de 24 horas foi encerrada. Aqui, você aprenderá como realizar a reabertura de forma correta.

{% embed url="<https://drive.google.com/file/d/1aO0pF1eAF1ULeNSJyjSaqsfQoX1l-ov8/view?usp=sharing>" %}

Em determinadas situações, pode ser necessário retomar o contato com um cliente mesmo após o encerramento do atendimento ou depois que a janela de 24 horas da Meta expira. Para isso, a plataforma oferece recursos específicos que permitem reabrir conversas e restabelecer a comunicação de forma segura e controlada.

{% hint style="warning" %}
**Atenção:** A reabertura da conversa **exigirá o envio de um Modelo de Mensagem pré-aprovado** somente quando o canal estiver utilizando a **API Oficial da Meta**.\
Nos canais que operam com **API Não Oficial**, essa exigência não se aplica.
{% endhint %}

{% hint style="success" %}
**Pré-requisitos**

* **Modelo de Mensagem:** É necessário possuir um Modelo de Mensagem pré-aprovado, ativo e devidamente cadastrado na plataforma (API Oficial).
* **Permissão de Acesso:** O usuário deve estar associado à equipe onde o atendimento foi concluído, especialmente em casos em que a equipe possui restrições de visualização.
  {% endhint %}

#### **Passo 1: Localizar e Iniciar a Reativação**

1. Na tela de **Atendimentos**, acesse a aba **Concluídos**.
2. Selecione o atendimento que deseja reiniciar.
3. No canto inferior direito, clique no botão **Reiniciar**.

{% hint style="warning" %}
**Observação:**

* **Canais com API Não Oficial:** O atendimento será reiniciado imediatamente.
* **Canais com API Oficial:** Será necessário seguir os próximos passos para completar a reativação.
  {% endhint %}

<figure><img src="/files/uShkrRKe2oK9EX3tRBjN" alt=""><figcaption></figcaption></figure>

#### **Passo 2: Selecionar o Modelo de Mensagem**

Ao clicar em **Reiniciar**, será exibido o painel de seleção de modelo:

1. Escolha o **Modelo de Mensagem** que será utilizado para reiniciar o contato.
2. Clique em **Continuar** para prosseguir com a configuração.

<figure><img src="/files/JbPqmvXUodtyQqdbqZb2" alt=""><figcaption></figcaption></figure>

#### **Passo 3: Preencher Parâmetros e Enviar**

Se o **Modelo de Mensagem** selecionado contiver variáveis (por exemplo, \[NOME] ou \[ATENDENTE]), preencha os campos correspondentes na seção **Parâmetros**.

Após completar os parâmetros, clique em **Enviar Mensagem** para reiniciar oficialmente o atendimento.

<figure><img src="/files/SMbwH5PKXRj7MBxqtCRt" alt=""><figcaption></figcaption></figure>

Após o envio do **Modelo de Mensagem**, na área de digitação, será exibida a mensagem: **"Deixe mensagens na fila para serem entregues assim que o contato responder."**

{% hint style="warning" %}
**Observação**

Durante esse período, você pode preparar mensagens adicionais que serão enviadas automaticamente assim que o contato interagir.
{% endhint %}

<figure><img src="/files/377fTKOSTIXInV8B1Zwd" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Regras e Fluxo de Continuidade**

**1. Reabertura da Janela de Conversa**

A janela de conversa livre, que permite o envio de mensagens ilimitadas, será reaberta **apenas após a interação do contato**.\
O contato precisa enviar qualquer tipo de mensagem (texto, emoji, vídeo ou arquivo) para que a janela seja ativada.

**2. Mensagens na Fila**

Enquanto o contato não responder:

* Você pode digitar e enviar novas mensagens normalmente.
* Essas mensagens serão **enfileiradas** e entregues automaticamente assim que a resposta do contato reabrir a janela de conversa.

**3. Reengajamento**

Se o contato demorar a responder:

* É possível enviar um **novo Modelo de Mensagem** para tentar retomar o contato.
* O processo de envio segue os mesmos passos descritos anteriormente, permitindo reabrir a janela de conversa.

**4. Janela de 24 Horas vs. Conclusão na Plataforma**

* Concluir uma conversa na plataforma é uma **ação interna**, sem impacto na janela de 24 horas da Meta.
* A janela de 24 horas só será encerrada se não houver interação do contato por **mais de 24 horas**.

**5. Restrições de Canal**

* Até a última atualização, a Meta **não permite reiniciar conversas** usando modelos em canais como Instagram ou Facebook Messenger caso a janela de mensagens já esteja fechada.
* O envio de modelos de reinício é aplicável principalmente ao **WhatsApp**.
  {% endhint %}


# Preferências de Arquivamento

Guia de Configuração das Preferências de Arquivamento.

{% embed url="<https://drive.google.com/file/d/1_cyPOTrOS7cjFQKc_SZnbFcdkm03U_3s/view?usp=sharing>" %}

Este guia explica como configurar as **preferências de arquivamento** na plataforma, permitindo que você defina o que acontece após a conclusão de um atendimento. Com essas orientações, é possível personalizar o sistema para:

* Garantir a continuidade do atendimento pelo mesmo usuário.
* Iniciar um novo fluxo de atendimento, conforme as necessidades operacionais da equipe.

#### **Passo 1: Acessar as Preferências de Conclusão**

1. Na tela de **Atendimentos**, abra uma conversa em andamento.
2. Clique na **seta ao lado do botão Concluir** para exibir o painel de opções.

<figure><img src="/files/Nd58aXMdii1qVyjnZj9A" alt=""><figcaption></figcaption></figure>

#### **Passo 2: Definir a Ação ao Concluir um Atendimento**

Escolha entre as opções disponíveis:

* **Arquivar em 12 horas** *(opção padrão)*\
  Se o contato enviar uma nova mensagem em até 12 horas, o atendimento será reaberto automaticamente para você.
* **Arquivar imediatamente**\
  Se o contato enviar uma nova mensagem, será criado um **novo atendimento**.

#### **Passo 3: Salvar a Configuração**

1. Selecione a opção desejada.
2. Clique em **Salvar**.

**Observação:** Essas preferências são **configuradas individualmente por usuário** e serão aplicadas automaticamente em todas as suas futuras conclusões de atendimento.

{% hint style="info" %}
**Considerações Adicionais**

* **Classificar Atendimento ao Concluir:**\
  No mesmo modal de preferências, você pode ativar a chave **"Classificar atendimento ao concluir"**.\
  Quando habilitada, a janela de classificação será exibida automaticamente sempre que uma conversa for concluída, garantindo que os dados sejam registrados para análise nos **Painéis** e em **Campanhas**.
  {% endhint %}


# Ferramentas de Interação

Nesta seção, você encontra a sua caixa completa de ferramentas para o atendimento.

{% embed url="<https://drive.google.com/file/d/1HajHC9h-rVBtDp3BseowYk7wsqT_gGNA/view?usp=sharing>" %}

Aqui estão detalhados os recursos para enviar mídias, utilizar respostas rápidas, solicitar pagamentos, agendar mensagens e executar diversas outras ações que otimizam sua experiência na plataforma.

{% content-ref url="/pages/TZEbqclhwzK3SsfRHTqk" %}
[Enviar Imagem](/guide/documentacao/atendimento/ferramentas-de-interacao/enviar-imagem)
{% endcontent-ref %}

{% content-ref url="/pages/wiBbkaHSgQwXDtGs8Lh9" %}
[Enviar Vídeo](/guide/documentacao/atendimento/ferramentas-de-interacao/enviar-video)
{% endcontent-ref %}

{% content-ref url="/pages/jKX9AAFbMDE7EkPNtPif" %}
[Enviar Áudio](/guide/documentacao/atendimento/ferramentas-de-interacao/enviar-audio)
{% endcontent-ref %}

{% content-ref url="/pages/viVg2sX960tIWVhK6wQI" %}
[Gravar Áudio](/guide/documentacao/atendimento/ferramentas-de-interacao/gravar-audio)
{% endcontent-ref %}

{% content-ref url="/pages/jSfZKCbPRqk6FQQGTlEv" %}
[Enviar Documento](/guide/documentacao/atendimento/ferramentas-de-interacao/enviar-documento)
{% endcontent-ref %}

{% content-ref url="/pages/J2CuGmyAL62VQS15OZwu" %}
[Modelo de Mensagem](/guide/documentacao/atendimento/ferramentas-de-interacao/enviar-modelo-de-mensagem)
{% endcontent-ref %}

{% content-ref url="/pages/bFr4fkskZg526eD3hDIr" %}
[Mensagens Rápidas](/guide/documentacao/atendimento/ferramentas-de-interacao/enviar-mensagem-rapida)
{% endcontent-ref %}

{% content-ref url="/pages/u4GxhIBG0MxSNPG64TGj" %}
[Agendar Mensagem](/guide/documentacao/atendimento/ferramentas-de-interacao/agendamentos-pelo-atendimento)
{% endcontent-ref %}

{% content-ref url="/pages/aNdRthvfl93o0fYKaXdo" %}
[Solicitar Pagamento](/guide/documentacao/atendimento/ferramentas-de-interacao/solicitar-pagamento)
{% endcontent-ref %}

{% content-ref url="/pages/domXwAGyHaxEIxyiyWIF" %}
[Iniciar Chatbot](/guide/documentacao/atendimento/ferramentas-de-interacao/iniciar-chatbot)
{% endcontent-ref %}

{% content-ref url="/pages/Pit6YKHdcrZvVvYz0b57" %}
[Notas da Conversa](/guide/documentacao/atendimento/ferramentas-de-interacao/notas-internas-na-conversa-da-plataforma)
{% endcontent-ref %}


# Enviar Imagem

Guia detalhado sobre como anexar, legendar e enviar imagens no atendimento, além de como gerenciar as mídias enviadas (baixar, excluir ou responder).

{% embed url="<https://drive.google.com/file/d/1awEBFWvHSXZwPDDscSdiE_viE5HjgsIb/view?usp=sharing>" %}

Enviar imagens na plataforma é uma funcionalidade essencial para enriquecer a comunicação e fornecer suporte visual ao seu contato. Este artigo guiará você pelo passo a passo de como enviar imagens durante um atendimento e, em seguida, como gerenciar essas mídias.

### Passo 1: Acessar a Opção de Anexo

1. Na tela de Atendimentos, selecione a conversa para a qual deseja enviar a imagem.
2. Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
3. No menu de opções que será exibido, escolha **"Imagem".**

<figure><img src="/files/kx1A7BeZQ8YFIOukVNqa" alt=""><figcaption></figcaption></figure>

### Passo 2: Selecionar e Enviar o Arquivo

1. Sua pasta de arquivos local (no computador) será aberta.
2. Selecione a(s) imagem(s) que você deseja enviar.
3. **Opcional:** Antes de enviar, você pode **adicionar uma descrição (legenda)** no campo que aparece abaixo da pré-visualização da imagem
4. Clique em "Abrir".
5. A imagem será carregada e enviada ao contato, ficando disponível para visualização e download.

<figure><img src="/files/7PbY0uDtMt7sSEAB40cr" alt=""><figcaption></figcaption></figure>

### Passo 3: Gerenciando Mídias Enviadas

Após a imagem ser enviada, você terá várias opções para interagir com a mensagem diretamente na tela de atendimento:

#### Ações ao Passar o Mouse

Ao passar o mouse sobre a mensagem de mídia, duas ações rápidas aparecem:

* **Responder:** Clique no ícone de seta (↩︎) para citar a imagem em sua próxima mensagem.
* **Baixar:** Clique no ícone de download (↓) para salvar o arquivo em seu computador

<figure><img src="/files/Pd13pewgVhpcbYaAoIjv" alt=""><figcaption></figcaption></figure>

#### Ações de Seleção

Você também pode selecionar uma ou mais mensagens de mídia clicando na caixa de seleção (checkbox) que aparece no canto. Ao fazer isso, uma barra de ações surgirá na parte inferior da tela com as seguintes opções:

* **Baixar mídia:** Faz o download de todos os itens selecionados.
* **Encaminhar:** Envia as mídias selecionadas para outra conversa.
* **Excluir:** Remove as mídias selecionadas.

<figure><img src="/files/hiqd621iCJN4QYPeSGBD" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/AD3T3H7FPYnNdOIs3rSQ" alt=""><figcaption></figcaption></figure>

#### Excluindo uma Mensagem

Ao clicar em **"Excluir"** na barra de ações, um pop-up de confirmação será exibido. Você terá duas opções:

1. **Apagar para mim:** Remove a mensagem apenas da sua visualização.
2. **Apagar para todos:** Remove a mensagem para você e para o contato **(Nota: Esta opção está disponível apenas para canais da API Não Oficial).**

<figure><img src="/files/j0Wlk4whQli099BpZUXr" alt=""><figcaption></figcaption></figure>

#### Detalhes da Mensagem (Avançado)

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

<figure><img src="/files/miFBmmZdvYisYgkDYmbM" alt=""><figcaption></figcaption></figure>

### Regras de Formato e Tamanho por Canal

O envio de imagens segue regras específicas de formato e limite de tamanho, que variam de acordo com o canal utilizado:

1. **Canais API Oficial e API não Oficial**

| Restrição                     | Detalhes                                                                                                       |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Formatos Suportados**       | `.jpeg` e `.png`                                                                                               |
| **Limite Máximo**             | 5 MB                                                                                                           |
| **Comportamento por Tamanho** | Se o arquivo for maior que 5 MB, o comportamento será diferente (veja o tópico *Validação do Tamanho* abaixo). |

2. **Canais Instagram e Messenger**

| Restrição                     | Detalhes                                                                                                       |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Formatos Suportados**       | `.jpeg`, `.png` e `.gif`                                                                                       |
| **Limite Máximo**             | 8 MB                                                                                                           |
| **Comportamento por Tamanho** | Se o arquivo for maior que 8 MB, o comportamento será diferente (veja o tópico *Validação do Tamanho* abaixo). |

### Validação do Tamanho de Arquivo

O sistema adapta o formato de envio de imagens para garantir a entrega, seguindo as seguintes regras:

**API Oficial e API não Oficial**

[Consulte aqui todas as regras oficiais da Meta](https://developers.facebook.com/docs/whatsapp/cloud-api/messages/image-messages)

| Tamanho do Arquivo        | Forma de Envio                                                        |
| ------------------------- | --------------------------------------------------------------------- |
| **Até 5 MB**              | A imagem é enviada no seu formato original.                           |
| **Entre 5 MB e 100 MB**   | A imagem é enviada como um arquivo                                    |
| **Entre 100 MB e 200 MB** | A imagem é enviada como um link para que o contato faça o *download*. |
| **Acima de 200 MB**       | O envio não será realizado.                                           |

**Instagram e Messenger**

[Consulte aqui todas as regras oficiais da Meta](https://developers.facebook.com/docs/messenger-platform/instagram/features/attachment-upload)

| Tamanho do Arquivo      | Forma de Envio                                                        |
| ----------------------- | --------------------------------------------------------------------- |
| **Até 8 MB**            | A imagem é enviada no seu formato original.                           |
| **Entre 8 MB e 200 MB** | A imagem é enviada como um link para que o contato faça o *download*. |
| **Acima de 200 MB**     | O envio não será realizado.                                           |

**Mensagem de Alerta:** Caso o limite de 200 MB seja excedido, o usuário receberá o aviso: "Tamanho máximo permitido é de 200 MB. Tente compactar o arquivo antes de enviar."

<figure><img src="/files/40Kacv7UEHmoiBDqqB8r" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**💡 Nota: Qualidade da Imagem (Compressão vs. Arquivo Original)**

Para atender às regras de compatibilidade da Meta, ao usar a opção **"Anexar -> Imagem"**, seu arquivo é otimizado. Este processo envolve **compressão**, o que pode reduzir a qualidade visual (deixando a imagem menos nítida), mas garante uma entrega rápida e a pré-visualização (miniatura) na conversa.

**Para manter a qualidade original (Alta Resolução):** Se você precisa enviar uma imagem sem nenhuma perda de qualidade (como um arquivo para impressão, um design específico ou um documento digitalizado), utilize a opção **"Anexar -> Documento"**.
{% endhint %}


# Enviar Vídeo

Guia detalhado sobre como anexar, legendar e enviar vídeos no atendimento, além de como gerenciar as mídias enviadas (baixar, excluir ou responder).

{% embed url="<https://drive.google.com/file/d/13WQN5JoWkz5FcQyRehu7fSf6zWkdCyVe/view?usp=sharing>" %}

Enviar **vídeos** na plataforma é uma funcionalidade essencial para enriquecer a comunicação e fornecer suporte **visual** dinâmico. Este artigo guiará você pelo passo a passo de como enviar vídeos durante um atendimento e, em seguida, como gerenciar essas mídias.

### Passo 1: Acessar a Opção de Anexo

1. Na tela de Atendimentos, selecione a conversa para a qual deseja enviar o vídeo.
2. Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
3. No menu de opções que será exibido, escolha **"Vídeo".**

<figure><img src="/files/GSKJI0JcJvj59aDz8HtN" alt=""><figcaption></figcaption></figure>

### Passo 2: Selecionar e Enviar o Arquivo

1. Sua pasta de arquivos local (no computador) será aberta.
2. Selecione o(s) vídeos(s) que você deseja enviar.
3. **Opcional:** Antes de enviar, você pode **adicionar uma descrição (legenda)** no campo que aparece abaixo da pré-visualização do vídeo
4. Clique em "Abrir".
5. O vídeo será carregado e enviado ao contato, ficando disponível para visualização e download.

<figure><img src="/files/M8RvpOxtdaGn7OWOumQD" alt=""><figcaption></figcaption></figure>

### Passo 3: Gerenciando Mídias Enviadas

Após o vídeo ser enviado, você terá várias opções para interagir com a mensagem diretamente na tela de atendimento:

#### Ações ao Passar o Mouse

Ao passar o mouse sobre a mensagem de mídia, duas ações rápidas aparecem:

* **Responder:** Clique no ícone de seta (↩︎) para citar o vídeo em sua próxima mensagem.
* **Baixar:** Clique no ícone de download (↓) para salvar o arquivo em seu computador

<figure><img src="/files/IUTYK56GSCQB1cj1Rhsg" alt=""><figcaption></figcaption></figure>

#### Ações de Seleção

Você também pode selecionar uma ou mais mensagens de mídia clicando na caixa de seleção (checkbox) que aparece no canto. Ao fazer isso, uma barra de ações surgirá na parte inferior da tela com as seguintes opções:

* **Baixar mídia:** Faz o download de todos os itens selecionados.
* **Encaminhar:** Envia as mídias selecionadas para outra conversa.
* **Excluir:** Remove as mídias selecionadas.

<figure><img src="/files/4tCa4hDX6AASMjHxQJgf" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ptiHgJLCGlIPbz4Gwery" alt=""><figcaption></figcaption></figure>

#### Excluindo uma Mensagem

Ao clicar em **"Excluir"** na barra de ações, um pop-up de confirmação será exibido. Você terá duas opções:

1. **Apagar para mim:** Remove a mensagem apenas da sua visualização.
2. **Apagar para todos:** Remove a mensagem para você e para o contato **(Nota: Esta opção está disponível apenas para canais da API Não Oficial).**

<figure><img src="/files/jPZLnAIKWPa5XWpy69mB" alt=""><figcaption></figcaption></figure>

#### Detalhes da Mensagem (Avançado)

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

<figure><img src="/files/jedOq2S7GY1uKNHdVa5k" alt=""><figcaption></figcaption></figure>

### Regras de Formato e Tamanho por Canal

O envio de vídeo segue regras específicas de formato e limite de tamanho, que variam de acordo com o canal utilizado:

1. **Canais API Oficial e API não Oficial**

| Restrição                     | Detalhes                                                                                                        |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Formatos Suportados**       | `.mp4` e `.3gp`                                                                                                 |
| **Limite Máximo**             | 16 MB                                                                                                           |
| **Comportamento por Tamanho** | Se o arquivo for maior que 16 MB, o comportamento será diferente (veja o tópico *Validação do Tamanho* abaixo). |

2. **Canais Instagram e Messenger**

| Restrição                     | Detalhes                                                                                                        |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Formatos Suportados**       | `.mp4`, `.ogg` , `.avi` , `.movi` e `.webm`                                                                     |
| **Limite Máximo**             | 25 MB                                                                                                           |
| **Comportamento por Tamanho** | Se o arquivo for maior que 25 MB, o comportamento será diferente (veja o tópico *Validação do Tamanho* abaixo). |

### Validação do Tamanho de Arquivo

O sistema adapta o formato de envio de vídeos para garantir a entrega, seguindo as seguintes regras:

**API Oficial e API não Oficial**

[Consulte aqui todas as regras oficiais da Meta](https://developers.facebook.com/docs/whatsapp/cloud-api/messages/video-messages)

| Tamanho do Arquivo        | Forma de Envio                                                       |
| ------------------------- | -------------------------------------------------------------------- |
| **Até 16 MB**             | O vídeo é enviado no seu formato original.                           |
| **Entre 16 MB e 100 MB**  | O vídeo é enviado como um arquivo                                    |
| **Entre 100 MB e 200 MB** | O vídeo é enviado como um link para que o contato faça o *download*. |
| **Acima de 200 MB**       | O envio não será realizado.                                          |

**Instagram e Messenger**

[Consulte aqui todas as regras oficiais da Meta](https://developers.facebook.com/docs/messenger-platform/instagram/features/attachment-upload)

| Tamanho do Arquivo       | Forma de Envio                                                       |
| ------------------------ | -------------------------------------------------------------------- |
| **Até 25 MB**            | O vídeo é enviado no seu formato original.                           |
| **Entre 25 MB e 200 MB** | O vídeo é enviado como um link para que o contato faça o *download*. |
| **Acima de 200 MB**      | O envio não será realizado.                                          |

**Mensagem de Alerta:** Caso o limite de 200 MB seja excedido, o usuário receberá o aviso: "Tamanho máximo permitido é de 200 MB. Tente compactar o arquivo antes de enviar."

<figure><img src="/files/40Kacv7UEHmoiBDqqB8r" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**💡 Nota: Qualidade do Vídeo (Compressão vs. Arquivo Original)**

Para atender às regras de compatibilidade da Meta, ao usar a opção **"Anexar -> Vídeo"**, seu arquivo é otimizado. Este processo envolve **compressão**, o que pode reduzir a qualidade visual (diminuindo a resolução ou bitrate), mas garante uma entrega mais rápida e a pré-visualização (player) na conversa.

**Para manter a qualidade original:** Se você precisa enviar um vídeo sem nenhuma perda de qualidade (como um arquivo para edição, uma apresentação ou em alta resolução), utilize a opção **"Anexar -> Documento"**.
{% endhint %}


# Enviar Áudio

Guia detalhado sobre como anexar arquivos de áudio, incluindo as regras essenciais de formato e os limites de tamanho aplicáveis aos canais.

{% embed url="<https://drive.google.com/file/d/1nfEPmuuGcmenP0ALUCEZaetbLJMzn1jE/view?usp=sharing>" %}

O envio de mensagens de áudio é uma funcionalidade que permite uma comunicação direta e personalizada, ideal para transmitir informações detalhadas, *feedback* ou mensagens rápidas.

### Passo 1: Acessar a Opção de Anexo

1. Na tela de Atendimentos, selecione a conversa para a qual deseja enviar o áudio.
2. Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
3. No menu de opções que será exibido, escolha **"Áudio".**

<figure><img src="/files/FJXlO476DzncxCTmKM1X" alt=""><figcaption></figcaption></figure>

### Passo 2: Selecionar e Enviar o Arquivo

1. Sua pasta de arquivos local (no computador) será aberta.
2. Selecione o(s) áudio(s) que você deseja enviar.
3. **Opcional:** Antes de enviar, você pode **adicionar uma descrição (legenda)** no campo que aparece abaixo da pré-visualização do áudio.
4. Clique em "Abrir".
5. O áudio será carregado e enviada ao contato, ficando disponível para que o contato ouça ou faça *download*.

<figure><img src="/files/bQGZl2TE2HrxLinVTReW" alt=""><figcaption></figcaption></figure>

### Passo 3: Gerenciando Mídias Enviadas

Após o áudio ser enviado, você terá várias opções para interagir com a mensagem diretamente na tela de atendimento:

#### **Ações ao Passar o Mouse**

Ao passar o mouse sobre a mensagem de mídia, duas ações rápidas aparecem:

* **Responder:** Clique no ícone de seta (↩︎) para citar a imagem em sua próxima mensagem.
* **Baixar:** Clique no ícone de download (↓) para salvar o arquivo em seu computador

<figure><img src="/files/axoR5ZWoZAGvdJnZfobm" alt=""><figcaption></figcaption></figure>

#### **Ações de Seleção**

Você também pode selecionar uma ou mais mensagens de mídia clicando na caixa de seleção (checkbox) que aparece no canto. Ao fazer isso, uma barra de ações surgirá na parte inferior da tela com as seguintes opções:

* **Baixar mídia:** Faz o download de todos os itens selecionados.
* **Encaminhar:** Envia as mídias selecionadas para outra conversa.
* **Excluir:** Remove as mídias selecionadas.

<figure><img src="/files/3RLMHXxVNl7lQMtpOcLw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/FPYL9Zzd3FiK1lwGdlCO" alt=""><figcaption></figcaption></figure>

#### **Excluindo uma Mensagem**

Ao clicar em **"Excluir"** na barra de ações, um pop-up de confirmação será exibido. Você terá duas opções:

1. **Apagar para mim:** Remove a mensagem apenas da sua visualização.
2. **Apagar para todos:** Remove a mensagem para você e para o contato **(Nota: Esta opção está disponível apenas para canais da API Não Oficial).**

<figure><img src="/files/My7jOFvLZcodHX0WIxm0" alt=""><figcaption></figcaption></figure>

#### **Mais Opções**

Após um áudio ser enviado ou recebido, você pode gerenciá-lo usando o menu "Mais Opções".

1. Localize o áudio na conversa e clique no **ícone de três pontos (`...`)** ao lado do player de áudio.
2. Um menu suspenso aparecerá com as seguintes opções:
   * **Baixar:** Permite salvar o arquivo de áudio (.mp3 ou outro formato) diretamente no seu computador.
   * **Velocidade da reprodução:** Permite otimizar seu tempo. Ao clicar, você pode alterar a velocidade de reprodução do áudio (ex: 1.5x ou 2x).

<figure><img src="/files/4uKHbWmj0JM4FSPFN4iX" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/r3fWeeVNUzC2qQ41aids" alt=""><figcaption></figcaption></figure>

#### **Detalhes da Mensagem (Avançado)**

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

<figure><img src="/files/Gw8USBN1CVKpDnr7xaYC" alt=""><figcaption></figcaption></figure>

### Regras de Formato e Tamanho por Canal

O envio de áudio segue regras específicas de formato e limite de tamanho, que variam de acordo com o canal utilizado:

1. **Canais API Oficial e API não Oficial**

| Restrição                     | Detalhes                                                                                                        |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Formatos Suportados**       | `.aac`, `.amr`, `.mp3`, `.m4a` e `.ogg`.                                                                        |
| **Limite Máximo**             | 16 MB                                                                                                           |
| **Comportamento por Tamanho** | Se o arquivo for maior que 16 MB, o comportamento será diferente (veja o tópico *Validação do Tamanho* abaixo). |

2. **Canais Instagram e Messenger**

| Restrição                     | Detalhes                                                                                                        |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Formatos Suportados**       | `.aac`, `.m4a`, `.wav` e `.mp4`.                                                                                |
| **Limite Máximo**             | 25 MB                                                                                                           |
| **Comportamento por Tamanho** | Se o arquivo for maior que 25 MB, o comportamento será diferente (veja o tópico *Validação do Tamanho* abaixo). |

### Validação do Tamanho de Arquivo

O sistema adapta o formato de envio de áudios para garantir a entrega, seguindo as seguintes regras:

**API Oficial e API não Oficial**

[Consulte aqui todas as regras oficiais da Meta](https://developers.facebook.com/docs/whatsapp/cloud-api/messages/audio-messages)

| Tamanho do Arquivo       | Forma de Envio                                                        |
| ------------------------ | --------------------------------------------------------------------- |
| **Até 16 MB**            | O áudio é enviado no seu formato original.                            |
| **Entre 16 MB e 60 MB**  | O áudio é enviado como um arquivo (não como mensagem de voz tocável). |
| **Entre 60 MB e 200 MB** | O áudio é enviado como um link para que o contato faça o *download*.  |
| **Acima de 200 MB**      | O envio não será realizado.                                           |

**Instagram e Messenger**

[Consulte aqui todas as regras oficiais da Meta](https://developers.facebook.com/docs/messenger-platform/instagram/features/attachment-upload)

| Tamanho do Arquivo       | Forma de Envio                                                       |
| ------------------------ | -------------------------------------------------------------------- |
| **Até 25 MB**            | O áudio é enviado no seu formato original.                           |
| **Entre 25 MB e 200 MB** | O áudio é enviado como um link para que o contato faça o *download*. |
| **Acima de 200 MB**      | O envio não será realizado.                                          |

**Mensagem de Alerta:** Caso o limite de 200 MB seja excedido, o usuário receberá o aviso: "Tamanho máximo permitido é de 200 MB. Tente compactar o arquivo antes de enviar."

<figure><img src="/files/40Kacv7UEHmoiBDqqB8r" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**💡 Nota: Qualidade de Áudio vs. Compatibilidade**

Para atender às regras de compatibilidade da Meta, ao usar a opção **"Anexar -> Áudio"**, seu arquivo é otimizado. Este processo envolve **compressão** e normalização, o que pode causar perda de qualidade, mas garante a entrega rápida como uma mensagem de voz.

**Para manter a qualidade original (Hi-Fi):** Se você precisa enviar um áudio em alta fidelidade, utilize a opção **"Anexar -> Documento".**
{% endhint %}


# Gravar Áudio

Guia detalhado sobre como gravar mensagens de voz diretamente na plataforma, controlar a velocidade de reprodução e entender as regras de estabilidade.

{% embed url="<https://drive.google.com/file/d/1WK3q5CAym9Hl12LOjfiM8XcYItitkxoM/view?usp=sharing>" %}

Para uma comunicação mais ágil e pessoal, você pode gravar mensagens de voz diretamente pela plataforma. Este guia detalha o processo de como usar o microfone do seu dispositivo para capturar e enviar áudios em tempo real, além de mostrar como gerenciar a reprodução desses áudios.

### Passo 1: Iniciar a Gravação

1. Na janela de conversa, localize e clique no ícone de Microfone<img src="/files/2ECtZ4csvQFPL2cTuSea" alt="" data-size="line">
2. Mantenha o botão pressionado para iniciar a gravação da sua mensagem.
3. O ícone de microfone se transformará em um ícone de parar<img src="/files/cKPc68nKh1eBtfKf5bQq" alt="" data-size="line">

### Passo 2: Parar e Enviar

1. Solte o botão do mouse ou pare de pressionar o microfone para finalizar a gravação.
2. O sistema processará o áudio. Uma pré-visualização da mensagem de voz aparecerá na barra de digitação.

* Para **ouvir**, clique no **ícone**<img src="/files/8Hbce0UeU9K140ylEqzq" alt="" data-size="line">
* Para **cancelar**, clique no **ícone**<img src="/files/nNoBxBxctxHsy7lEwv3o" alt="" data-size="line">
* Para **enviar**, clique no **ícone**<img src="/files/FI3WQgy4RK2rHK5buMGa" alt="" data-size="line">

3. Ou Clique no ícone de Enviar<img src="/files/FI3WQgy4RK2rHK5buMGa" alt="" data-size="line">para enviar a mensagem de áudio imediatamente.

<figure><img src="/files/8VraBJXFNGdsisn2qRMh" alt=""><figcaption></figcaption></figure>

### Passo 3: Gerenciando Mídias Enviadas

Após o áudio ser enviado, você terá várias opções para interagir com a mensagem diretamente na tela de atendimento:

#### Ações ao Passar o Mouse

Ao passar o mouse sobre a mensagem de mídia, duas ações rápidas aparecem:

* **Responder:** Clique no ícone de seta (↩︎) para citar o áudio em sua próxima mensagem.
* **Baixar:** Clique no ícone de download (↓) para salvar o arquivo em seu computador

<figure><img src="/files/VdLrCS16zCYRaPkMGcTz" alt=""><figcaption></figcaption></figure>

#### Ações de Seleção

Você também pode selecionar uma ou mais mensagens de mídia clicando na caixa de seleção (checkbox) que aparece no canto. Ao fazer isso, uma barra de ações surgirá na parte inferior da tela com as seguintes opções:

* **Baixar mídia:** Faz o download de todos os itens selecionados.
* **Encaminhar:** Envia as mídias selecionadas para outra conversa.
* **Excluir:** Remove as mídias selecionadas.

<figure><img src="/files/37kq7WjLmU3uvz0sHqRy" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/KRK0R1g03NPGLkEdpCn1" alt=""><figcaption></figcaption></figure>

#### Excluindo uma Mensagem

Ao clicar em **"Excluir"** na barra de ações, um pop-up de confirmação será exibido. Você terá duas opções:

1. **Apagar para mim:** Remove a mensagem apenas da sua visualização.
2. **Apagar para todos:** Remove a mensagem para você e para o contato **(Nota: Esta opção está disponível apenas para canais da API Não Oficial).**

<figure><img src="/files/3kjGcarwi3TqjbEwYt2E" alt=""><figcaption></figcaption></figure>

#### Mais Opções

Após um áudio ser enviado ou recebido, você pode gerenciá-lo usando o menu "Mais Opções".

1. Localize o áudio na conversa e clique no **ícone de três pontos (`...`)** ao lado do player de áudio.
2. Um menu suspenso aparecerá com as seguintes opções:
   * **Baixar:** Permite salvar o arquivo de áudio (.mp3 ou outro formato) diretamente no seu computador.
   * **Velocidade da reprodução:** Permite otimizar seu tempo. Ao clicar, você pode alterar a velocidade de reprodução do áudio (ex: 1.5x ou 2x).

<figure><img src="/files/y5ZlvWSXQng2FKQvHnRB" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UaV3LFFZKGCaAc72p4pI" alt=""><figcaption></figcaption></figure>

#### Detalhes da Mensagem (Avançado)

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

<figure><img src="/files/c0OiJEtJ3rEE3nTkNSmk" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**💡 Nota: Qualidade de Áudio vs. Compatibilidade**

Para atender às regras de compatibilidade da Meta, ao usar a opção **"Gravar Áudio"**, seu arquivo é otimizado. Este processo envolve **compressão** e normalização, o que pode causar perda de qualidade, mas garante a entrega rápida como uma mensagem de voz.

**Para manter a qualidade original (Hi-Fi):** Se você precisa enviar um áudio em alta fidelidade, utilize a opção **"Anexar -> Documento".**
{% endhint %}

{% hint style="info" %}
**Considerações Adicionais**

**1. Perda de Gravação (Estabilidade)**

**Atenção à Saída:** Se você sair do atendimento ou navegar para outra tela antes que o envio do áudio seja concluído, a gravação será perdida. Será necessário gravá-la novamente ao retornar à conversa.
{% endhint %}


# Enviar Documento

Guia detalhado sobre como anexar arquivos (PDF, DOCX, TXT, etc.) no atendimento e como gerenciar os documentos enviados (baixar, excluir ou encaminhar).

{% embed url="<https://drive.google.com/file/d/1-ESAyivkH_Y4lDu7U6jWwxBri29ZmAZm/view?usp=sharing>" %}

Enviar documentos é uma funcionalidade essencial para compartilhar propostas, faturas, contratos ou qualquer arquivo importante durante a conversa. Este artigo guiará você pelo passo a passo de como anexar e, em seguida, como gerenciar esses documentos.

### Passo 1: Acessar a Opção de Anexo

1. Na tela de Atendimentos, selecione a conversa para a qual deseja enviar o documento.
2. Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
3. No menu de opções que será exibido, escolha **"Documento".**

<figure><img src="/files/8fXkZpZG6maIaiOYxGaG" alt=""><figcaption></figcaption></figure>

### Passo 2: Selecionar e Enviar o Arquivo

1. Sua pasta de arquivos local (no computador) será aberta.
2. Selecione o(s) documentos(s) que você deseja enviar.
3. **Opcional:** Antes de enviar, você pode **adicionar uma descrição (legenda)** no campo que aparece abaixo da pré-visualização do documento.
4. Clique em "Abrir".
5. O arquivo será carregado e enviado ao contato, ficando disponível para visualização e download.

<figure><img src="/files/mNAX0EyMr1PjQMTh4nsM" alt=""><figcaption></figcaption></figure>

### Passo 3: Gerenciando Mídias Enviadas

Após o documento ser enviado, você terá várias opções para interagir com ele:

#### Ações na Mensagem

* **Abrir:** Você pode clicar diretamente no nome do arquivo para abri-lo em uma nova aba do navegador ou clicar no ícone **"Abrir"** (`↗`) para o mesmo efeito.
* **Baixar:** Clique no ícone de download (↓) para salvar o arquivo em seu computador

#### Ações de Seleção

Você também pode selecionar uma ou mais mensagens de mídia clicando na caixa de seleção (checkbox) que aparece no canto. Ao fazer isso, uma barra de ações surgirá na parte inferior da tela com as seguintes opções:

* **Baixar mídia:** Faz o download de todos os itens selecionados.
* **Encaminhar:** Envia as mídias selecionadas para outra conversa.
* **Excluir:** Remove as mídias selecionadas.

<figure><img src="/files/xydz8446xthEeBIOMmeS" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GGnatq9jViRHwJgjl7IP" alt=""><figcaption></figcaption></figure>

#### Excluindo uma Mensagem

Ao clicar em **"Excluir"** na barra de ações, um pop-up de confirmação será exibido. Você terá duas opções:

1. **Apagar para mim:** Remove a mensagem apenas da sua visualização.
2. **Apagar para todos:** Remove a mensagem para você e para o contato **(Nota: Esta opção está disponível apenas para canais da API Não Oficial).**

<figure><img src="/files/lzwIYJH6AGgv540R1gNd" alt=""><figcaption></figcaption></figure>

#### Detalhes da Mensagem (Avançado)

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

<figure><img src="/files/vfna6MZ9IM1QvTAeRgAu" alt=""><figcaption></figcaption></figure>

### Regras de Formato e Tamanho por Canal

O envio de documento segue regras específicas de formato e limite de tamanho, que variam de acordo com o canal utilizado:

1. **Canais API Oficial e API não Oficial**

| Restrição                     | Detalhes                                                                                                         |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Formatos Suportados**       | `.txt`, `.xls`, `.xlsx`, `.doc` ,`.docx` , `.ppt` , `.pptx` e `.pdf`.                                            |
| **Limite Máximo**             | 100 MB                                                                                                           |
| **Comportamento por Tamanho** | Se o arquivo for maior que 100 MB, o comportamento será diferente (veja o tópico *Validação do Tamanho* abaixo). |

2. **Canal Messenger**

As regras da Meta para o Messenger diferem das do WhatsApp. Em vez de listar extensões de documentos específicas (como `.pdf` ou `.docx`), a Plataforma do Messenger generaliza todos os documentos sob um único tipo: `file`.

Na prática, isso significa que **qualquer formato de documento comum é suportado**, desde que respeite o limite de tamanho. Isso inclui arquivos de texto (`.txt`), PDFs (`.pdf`) e pacotes de escritório como Word (`.doc`, `.docx`), Excel (`.xls`, `.xlsx`) e PowerPoint (`.ppt`, `.pptx`).

| Restrição                     | Detalhes                                                                                                        |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Formatos Suportados**       | `.txt`, `.xls`, `.xlsx`, `.doc` ,`.docx` , `.ppt` , `.pptx` e `.pdf`.                                           |
| **Limite Máximo**             | 25 MB                                                                                                           |
| **Comportamento por Tamanho** | Se o arquivo for maior que 25 MB, o comportamento será diferente (veja o tópico *Validação do Tamanho* abaixo). |

### Validação do Tamanho de Arquivo

O sistema adapta o formato de envio de documentos para garantir a entrega, seguindo as seguintes regras:

**API Oficial e API não Oficial**

[Consulte aqui todas as regras oficiais da Meta](https://developers.facebook.com/docs/whatsapp/cloud-api/messages/document-messages)

| Tamanho do Arquivo        | Forma de Envio                                                           |
| ------------------------- | ------------------------------------------------------------------------ |
| **Até 100 MB**            | O documento é enviado no seu formato original.                           |
| **Entre 100 MB e 200 MB** | O documento é enviado como um link para que o contato faça o *download*. |
| **Acima de 200 MB**       | O envio não será realizado.                                              |

**Messenger**

[Consulte aqui todas as regras oficiais da Meta](https://developers.facebook.com/docs/messenger-platform/reference/send-api?locale=pt_BR)

| Tamanho do Arquivo       | Forma de Envio                                                           |
| ------------------------ | ------------------------------------------------------------------------ |
| **Até 25 MB**            | O documento é enviado no seu formato original.                           |
| **Entre 25 MB e 200 MB** | O documento é enviado como um link para que o contato faça o *download*. |
| **Acima de 200 MB**      | O envio não será realizado.                                              |

**Instagram**

[Consulte aqui todas as regras oficiais da Meta](https://developers.facebook.com/docs/messenger-platform/instagram/features/attachment-upload)

O Instagram **não possui suporte nativo** para o envio de arquivos de documento (como `.pdf` ou `.docx`).

Para contornar essa limitação, nossa plataforma converte automaticamente o documento em um **link seguro para download** e o envia ao contato.

Dessa forma, o envio é suportado para **qualquer formato de documento** (PDF, DOC, XLS, TXT, etc.), desde que respeite o limite de tamanho.

| Tamanho do Arquivo  | Forma de Envio                                                           |
| ------------------- | ------------------------------------------------------------------------ |
| **Até 200 MB**      | O documento é enviado como um link para que o contato faça o *download*. |
| **Acima de 200 MB** | O envio não será realizado.                                              |

**Mensagem de Alerta:** Caso o limite de 200 MB seja excedido, o usuário receberá o aviso: "Tamanho máximo permitido é de 200 MB. Tente compactar o arquivo antes de enviar."

<figure><img src="/files/40Kacv7UEHmoiBDqqB8r" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**💡Nota: Enviando Arquivos em Qualidade Original**

Ao contrário das opções "Imagem", "Vídeo" ou "Áudio", a função **"Anexar -> Documento"** não aplica nenhuma compressão ou otimização.

Use esta opção sempre que precisar enviar um arquivo (seja uma imagem, vídeo, áudio ou PDF) em seu **formato e qualidade originais (Hi-Fi).**
{% endhint %}


# Modelo de Mensagem

Guia detalhado sobre como enviar um Modelo de Mensagem (template) aprovado diretamente pela tela de atendimento.

{% embed url="<https://drive.google.com/file/d/1356Ewm-loaDOMK6ztuTbDhnAO3WPCYa-/view?usp=sharing>" %}

Enviar um Modelo de Mensagem é uma funcionalidade com diferentes propósitos, dependendo do seu tipo de canal:

* **Para Canais API Oficial (Meta/WhatsApp):** Esta é a **única forma permitida** de **iniciar uma conversa** com um contato ou **reiniciar um atendimento** após a janela de 24 horas ter expirado.
* **Para Canais API Não Oficial:** Você **não precisa** de um modelo para iniciar ou reiniciar uma conversa; uma mensagem livre é suficiente.

No entanto, em **ambos os tipos de canal**, você pode usar esta funcionalidade a qualquer momento *durante* um atendimento como um atalho prático para enviar mensagens padronizadas.

{% hint style="success" %}
**Pré-requisito:**

Ter, no mínimo, um modelo de mensagem do tipo **Atendimento** cadastrado e ativo na plataforma.
{% endhint %}

### Passo 1: Acessar a Opção de Anexo

1. Na tela de Atendimentos, abra a conversa do contato para o qual deseja enviar o modelo.
2. Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
3. No menu de opções que será exibido, escolha **"Modelo de mensagem"**

<figure><img src="/files/Ohv7ZhMFaJRouT0tkWcM" alt=""><figcaption></figcaption></figure>

### Passo 2: Selecionar o Modelo

1. Uma janela será aberta listando todos os seus modelos de mensagem aprovados.
2. Você pode usar a barra de "Pesquisar" ou o filtro de tipo (ex: Atendimento) para encontrar o modelo que deseja.
3. Selecione o modelo desejado na lista.
4. Clique em **"Continuar"** (ou "Definir parâmetros").

{% hint style="warning" %}
⚠️ **Nota: Permissão para o botão "+ Novo"**

O botão **"+ Novo"**, que permite criar um novo modelo de mensagem diretamente desta tela, é visível apenas para usuários com perfil de **Administrador**.

Para os demais perfis, este botão não será exibido.
{% endhint %}

<figure><img src="/files/PQhCNiBk2KIrj6dkOa4o" alt=""><figcaption></figcaption></figure>

### Passo 3: Preencher os Parâmetros (Se houver)

1. Se o modelo selecionado contiver variáveis (parâmetros, ex: `{{1}}` ou `[p1]`), você será levado a uma tela para preenchê-las.
2. Preencha os campos com as informações do cliente (ex: Nome, número do pedido, etc.).
3. Clique em **"Enviar Mensagem"**.

<figure><img src="/files/CHhP6DvXh9guMQYdyIDh" alt=""><figcaption></figcaption></figure>

### Passo 4: Mensagem Enviada

1. O modelo de mensagem será enviado e aparecerá na janela de conversa.
2. Aguarde o contato responder para que a janela de atendimento seja aberta e você possa conversar livremente.

<figure><img src="/files/fUxuMXyiqq9ZUpLlADu0" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
💡 **Nota: Entendendo a Janela de Atendimento (API Oficial do WhatsApp)**

Esta funcionalidade segue as regras da **API Oficial do WhatsApp (Meta)** sobre a janela de 24 horas.

Se você usou o modelo para iniciar ou reiniciar uma conversa, a janela de atendimento (que permite o envio de mensagens livres) só será aberta **quando o contato interagir de alguma forma** (enviando uma resposta, clicando em um botão, etc.).

Se o contato não responder, a janela permanece fechada e você só poderá tentar um novo contato enviando outro Modelo de Mensagem.
{% endhint %}

### Passo 5: Gerenciando Mídias Enviadas

Após o modelo de mensagem ser enviado, você terá várias opções para interagir com ele:

**Ações na Mensagem**

* **Responder:** Clique no ícone de seta (↩︎) para citar o modelo em sua próxima mensagem.
* **Baixar:** Clique no ícone de download (↓) para salvar o arquivo em seu computador

<figure><img src="/files/3vf3TBCYT95ygh7dBN8z" alt=""><figcaption></figcaption></figure>

**Detalhes da Mensagem (Avançado)**

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

<figure><img src="/files/02eJiw4gSl7rqxLGeoyS" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
⚠️ **Atenção: Regras para Excluir Mensagens**

A capacidade de excluir mensagens enviadas depende do seu tipo de canal:

* **Canais API Oficial (Meta):** Devido às regras de conformidade da Meta, **nenhuma mensagem pode ser excluída** (nem mensagens livres, nem Modelos de Mensagem).
* **Canais API Não Oficial:** Você pode excluir mensagens livres, mas **não é possível excluir** mensagens enviadas com um "Modelo de Mensagem" (template).
  {% endhint %}


# Mensagens Rápidas

Guia detalhado sobre como usar respostas prontas (mensagens rápidas) para agilizar o atendimento, seja pelo menu de anexo ou pelo atalho de barra (/).

{% embed url="<https://drive.google.com/file/d/1TEOuEwJ3FVjVXbKz9YikM9cj-VEWzPWo/view?usp=sharing>" %}

Mensagens rápidas são respostas predefinidas que podem ser inseridas instantaneamente nas conversas. Elas são extremamente úteis para responder perguntas frequentes, fornecer informações padronizadas e economizar tempo nas interações diárias.

{% hint style="success" %}
**Pré-requisitos**:

* Modelos de mensagens rápidas já cadastrados na plataforma.
  {% endhint %}

Existem duas formas de acessar e enviar suas mensagens rápidas:

## 1° Usando o Menu de Anexo

### Passo 1: Acessar a Opção de Anexo

1. Na tela de Atendimentos, abra a conversa do contato para o qual deseja enviar o modelo.
2. Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
3. No menu de opções que será exibido, escolha **"Mensagens Rápidas"**

<figure><img src="/files/spjdmwn2tQiZ29aBQSw3" alt=""><figcaption></figcaption></figure>

### Passo 2: Selecionar e Enviar a Mensagem

1. Uma janela será aberta listando todas as suas mensagens rápidas.
2. Use a barra de pesquisa ou role a lista para encontrar a resposta desejada.
3. Clique na mensagem que você quer enviar.

<figure><img src="/files/5FLwfuUAkLWwMRx9DLAv" alt=""><figcaption></figcaption></figure>

1. A mensagem será **automaticamente inserida na barra de digitação**
2. (Opcional) Você pode editar o texto na barra de digitação antes de enviar.
3. Clique no **ícone de Envio** (➤) para enviar a mensagem.

<figure><img src="/files/iBDT6jOd0WJccrA6kjsY" alt=""><figcaption></figcaption></figure>

## 2° Usando o Atalho de Barra (/)

Esta é a forma mais ágil de usar a funcionalidade.

### Passo 1: Ativar a Busca por Atalho

1. Na barra de digitação da conversa, digite uma barra (`/`)
2. Uma lista pop-up aparecerá acima da barra, mostrando suas mensagens rápidas.

### Passo 2: Filtrar e Selecionar

1. Continue digitando após a barra para filtrar a lista em tempo real (ex: `/boasvindas`)
2. Clique na mensagem desejada ou use as setas do teclado para selecionar e apertar **Enter**.

### Passo 3: Enviar a Mensagem

1. A mensagem selecionada será **automaticamente inserida na barra de digitação.**
2. (Opcional) Edite o texto se necessário.
3. Clique no **ícone de Envio** (➤)

<figure><img src="/files/BdDhaqXGacRP8iMezJBL" alt=""><figcaption></figcaption></figure>

### Passo 4: Gerenciando Mídias Enviadas

Após a resposta rápida ser enviada, você terá várias opções para interagir com ele:

**Ações na Mensagem**

* **Responder:** Clique no ícone de seta (↩︎) para citar o modelo em sua próxima mensagem.
* **Baixar:** Clique no ícone de download (↓) para salvar o arquivo em seu computador

<figure><img src="/files/PKrurlhhJuGpbeoermbR" alt=""><figcaption></figcaption></figure>

**Detalhes da Mensagem (Avançado)**

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

<figure><img src="/files/IDJixIUASOgJVaL0TmfK" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
⚠️ **Atenção: Regras para Excluir Mensagens**

A capacidade de excluir mensagens enviadas depende do seu tipo de canal:

* **Canais API Oficial (Meta):** Devido às regras de conformidade da Meta, **nenhuma mensagem pode ser excluída** (nem mensagens livres, nem Modelos de Mensagem).
* **Canais API Não Oficial:** Você pode excluir mensagens livres, mas **não é possível excluir** mensagens enviadas com uma "Mensagem Rápida".
  {% endhint %}

## Criando e Gerenciando Respostas Rápidas

Antes de enviar, é possível criar novos modelos, visualizar detalhes ou editar respostas existentes através do menu de Mensagens Rápidas

**Para criar uma nova resposta:**

1. Clique no botão Nova resposta rápida.
2. Preencha os campos obrigatórios e configure os Parâmetros (variáveis dinâmicas como `{{NOME}}` ou `{{ATENDENTE}}`).
3. Salve o cadastro. O modelo ficará imediatamente disponível para uso no chat.

**Para gerenciar uma resposta existente:** Ao clicar sobre um modelo na lista, você abrirá o cartão de detalhes. No rodapé desta janela, utilize as opções:

* **Editar**: Para realizar ajustes no texto ou nos parâmetros.
* **Duplicar**: Para criar uma cópia exata e agilizar a criação de variações.
* **Arquivar**: Para ocultar a resposta da lista ativa sem excluí-la do histórico.
* **Excluir**: Para remover o modelo permanentemente.

<figure><img src="/files/rcNdz0GDM2GeB2e6CiSR" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
💡 **Nota: Permissões e Limites**

* **Permissões:** Qualquer perfil de usuário da plataforma pode criar modelos de mensagens rápidas. Ao criar, você pode definir se o modelo será visível apenas para você, para uma equipe específica ou para todos os usuários da conta.
* **Limites:** Conforme as diretrizes da Meta, existe um limite máximo de 250 modelos por canal. Esse volume considera a soma de todos os tipos criados (incluindo Atendimento, Mensagens Rápidas, Sequências e Campanhas).
  {% endhint %}

{% hint style="info" %}
**Nota sobre Performance e Visualização**

Para garantir mais velocidade no carregamento, implementamos um cache inteligente para as Respostas Rápidas.

* **Primeiro Acesso:** Você poderá ver o status *"Sincronizando modelos de mensagem"*. Isso ocorre apenas para salvar os modelos no seu navegador. Os acessos seguintes serão instantâneos.
* **Listagem:** Inicialmente, são exibidas as 100 primeiras respostas. Para visualizar as demais, clique no botão "Carregar mais" ao final da lista.
* **Busca:** Ao alterar o termo de pesquisa, a lista volta automaticamente ao topo para facilitar a visualização dos resultados.
  {% endhint %}


# Agendar Mensagem

Guia detalhado sobre como agendar o envio de um modelo de mensagem ou chatbot para o futuro, diretamente pela tela de atendimento.

{% embed url="<https://drive.google.com/file/d/1piMIYunr9Il1IoQxrclGh-6sF2xETYqA/view?usp=sharing>" %}

Você pode programar o envio de uma mensagem ou o início de um chatbot para o futuro sem sair da tela de conversa do cliente. Este atalho é ideal para programar follow-ups, enviar lembretes ou continuar um fluxo de automação.

#### Passo 1: Acessar a Funcionalidade

* Na tela de Atendimentos, abra a conversa do contato para o qual deseja agendar uma mensagem.
* Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
* No menu de opções que será exibido, escolha **“Agendar Mensagem”.**

<figure><img src="/files/5uJWzII2kcH1GGxn6a7B" alt=""><figcaption></figcaption></figure>

#### Passo 2: Definir a Data e o Conteúdo

Na janela "Novo agendamento" que será aberta, preencha os seguintes campos:

1. **Escolha quando será o envio:**
   * **Datas Pré-Definidas:** O sistema exibe automaticamente sugestões de datas e horários. Estas sugestões são baseadas nos horários de expediente configurados em Ajustes > Conta > Horário de atendimento.
   * **Personalizar Data e Hora:** Se preferir, ative a chave "Personalizar data e hora" para selecionar livremente qualquer data e horário.
2. **Escolha o tipo de envio:**
   * Selecione se deseja enviar um **"Modelo de mensagem"** ou iniciar um **"Chatbot"**.
3. Clique em **"Próximo"**.

{% hint style="success" %}
**Praticidade**

Ao agendar a partir de um atendimento, o sistema preenche automaticamente o Canal e a Equipe com os dados da conversa atual, tornando o processo mais rápido e prático.
{% endhint %}

<figure><img src="/files/cXFozRHfJnclj0cnl5Ku" alt=""><figcaption></figcaption></figure>

#### Passo 3: Selecionar o Conteúdo e Agendar

Após clicar em "Próximo", você será direcionado para a tela de seleção de conteúdo:

* **Caso tenha escolhido "Modelo de mensagem":**
  1. Selecione o modelo desejado na lista
  2. Clique em **"Definir parâmetros"**.
  3. Preencha as variáveis do modelo (se houver) e clique em **"Agendar mensagem"**.

<figure><img src="/files/8jT2kLWcPWwA154k2B3W" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Permissão para o botão "+ Novo":**

O botão **"+ Novo"**, que permite criar um novo modelo de mensagem diretamente desta tela, é visível para todos os perfis de usuários.
{% endhint %}

* **Caso tenha escolhido "Chatbot":**
  1. Selecione o chatbot desejado na lista
  2. Clique em **"Agendar mensagem"** para finalizar.

<figure><img src="/files/fHK5S2APJdGaYekUOx6x" alt=""><figcaption></figcaption></figure>

## Consultando Agendamentos do Contato

A plataforma permite que você consulte facilmente o histórico de todas as mensagens que foram programadas, enviadas ou que falharam para um contato, tudo sem sair da tela da conversa.

#### Passo 1: Abrir o Painel de Informações

1. Com o atendimento do contato selecionado, clique no **ícone de "Detalhes"** no cabeçalho da conversa.
2. O painel lateral de informações do contato será aberto.

#### Passo 2: Acessar a Aba de Agendamentos

1. No painel lateral, clique no ícone da aba **"Mensagens agendadas"** (representado por um relógio)

#### Passo 3: Consultar o Histórico

1. A lista exibirá todos os agendamentos feitos para aquele contato.
2. Você poderá ver o status de cada agendamento (ex: Enviado, Entregue, Cancelado, Falha) diretamente na lista.

#### Passo 4: Detalhar ou Reagendar (Opcional)

1. Clique sobre um agendamento na lista para abrir uma nova janela com todos os detalhes daquela mensagem.
2. Se o agendamento tiver um status que permite a edição (como "Falha" ou "Cancelado"), o botão **"Reagendar"** estará disponível para você nesta tela de detalhes.

<figure><img src="/files/ScfScEPjS49JWCJZk3SV" alt=""><figcaption></figcaption></figure>


# Solicitar Pagamento

Guia detalhado sobre como utilizar a funcionalidade de solicitação de pagamento na plataforma, garantindo uma gestão eficaz e organizada das suas cobranças.

{% embed url="<https://drive.google.com/file/d/1-sb4ia2LC9hdX-H2MEOnC-eORMyN-zqe/view?usp=sharing>" %}

A funcionalidade de solicitação de pagamentos permite agilizar e simplificar o processo de cobrança diretamente pela plataforma. Neste artigo, você encontrará um passo a passo detalhado para solicitar pagamentos durante um atendimento, garantindo maior eficiência e controle sobre suas transações.

{% hint style="success" %}
**Pré-requisito**:

* O módulo Asaas precisa estar habilitado e corretamente configurado na plataforma.
  {% endhint %}

### Passo 1: Acessar a Opção de Anexo

1. Na tela de Atendimentos, selecione a conversa em que deseja enviar a solicitação de pagamento.
2. Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
3. No menu exibido, selecione a opção **“Solicitar pagamento”.**

<figure><img src="/files/dmGDPmxxEQeELAeTA7pr" alt=""><figcaption></figcaption></figure>

### Passo 2: Configurar o Pagamento

Ao selecionar a opção de solicitação, será aberto um caixa de seleção para preenchimento das informações da cobrança. Ele é dividido em três abas: Pagamento, Dados do cliente e Endereço do cliente.

#### Aba: Pagamento

1. Informe o **valor** a ser cobrado.
2. Escolha a **forma de pagamento**:
   * Cartão de crédito (até 9 parcelas)
   * Pix
   * Boleto
3. (Opcional) Adicione uma **descrição** da cobrança.
4. Defina a **data de vencimento/limite** para o pagamento.

<figure><img src="/files/BiEZqbFPWDYiQkrT5HNI" alt=""><figcaption></figcaption></figure>

#### Aba: Dados do Cliente

1. Se já houver uma solicitação anterior para o mesmo contato, os dados serão carregados automaticamente.
2. Caso deseje, é possível editar as informações clicando em **“Alterar dados”**.
3. Você também pode optar por solicitar que o cliente preencha esses dados no momento do pagamento, marcando o checkbox **“Solicitar dados do cliente no momento do pagamento”**.

<figure><img src="/files/7qFJTRgg8R67uRO1ADMH" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Qv6fBsyzNYSDwEz9CvvA" alt=""><figcaption></figcaption></figure>

#### Aba: Endereço do Cliente

1. Assim como nos dados pessoais, se já houver um endereço utilizado anteriormente, ele será carregado.
2. É possível editar as informações clicando em **“Alterar dados”**.
3. Para permitir que o cliente preencha o endereço no momento do pagamento, marque o checkbox **“Solicitar dados do cliente no momento do pagamento”**.

<figure><img src="/files/iv2cY2LXMhOQXqFZG5RW" alt=""><figcaption></figcaption></figure>

#### Finalização da solicitação

Após preencher todos os campos obrigatórios, o botão **“Enviar solicitação”** será habilitado.\
Basta clicar nele para enviar a cobrança ao contato.

### Passo 3: Visualizar detalhes da solicitação

Após enviada, a mensagem exibirá o status **“Solicitado”** e o botão **“Ver detalhes”**.

Ao clicar em **“Ver detalhes”**, será aberto uma caixa de informação com:

1. Descrição da cobrança
2. Dados do cliente
3. Valor e forma de pagamento
4. Botão **“Cancelar solicitação”**
5. Histórico de ações
6. Botão **“Fechar”**
7. Botão **“Abrir pagamento”**

<figure><img src="/files/yYv9vjqsuhjxceYLtwr6" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/FxrcjYABTNvaZ5837wwa" alt=""><figcaption></figcaption></figure>

#### **Botão: Cancelar Solicitação**

Ao clicar em **“Cancelar solicitação”**, será exibido uma mensagem de confirmação.\
Quando confirmado:

* O histórico é atualizado com o registro de cancelamento.
* O status da mensagem passa a ser **“Cancelado”**.
* O link para pagamento exibirá a mensagem **“A solicitação de pagamento foi cancelada”**.

<figure><img src="/files/8iHHqJXyBkoTrJLAvwTw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/mGQuiN4wBEnefrMT91Yd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/YzYGsuHtvrCpdCfYPu4a" alt=""><figcaption></figcaption></figure>

#### Botão: Abrir Pagamento

Ao clicar em **“Abrir pagamento”**, duas opções serão exibidas:

* **Abrir aqui** → A tela é atualizada para a página de **Pagamentos**, com o painel lateral mostrando os detalhes da cobrança.
* **Abrir em uma nova aba** → A página de **Pagamentos** será aberta em uma nova aba do navegador.

<figure><img src="/files/3Ax646FvWJuzPNEdw2E4" alt=""><figcaption></figcaption></figure>

#### Visualização do Link de Pagamento

O contato receberá uma mensagem com o link direto para realizar o pagamento.\
Abaixo estão os fluxos conforme o método escolhido.

**1. Pagamento com Cartão**

1. A primeira tela exibe a seleção da forma de pagamento.
2. Após avançar, o cliente preencherá os dados de **Identificação (nome, CPF/CNPJ, e-mail e telefone)**.
   * Se esses dados foram informados na solicitação, aparecerão preenchidos, mas podem ser alterados.
3. Na etapa seguinte, será solicitado o **endereço**.
   * Assim como os dados de identificação, o endereço também será preenchido automaticamente caso tenha sido informado na solicitação, e o cliente poderá editar se necessário.
4. Por fim, o cliente informará os **dados do cartão de crédito**.
5. Ao clicar em **“Pagar agora”**, o pagamento será processado.

<figure><img src="/files/BYP5dxB5fTEL3jxsXG5Z" alt=""><figcaption></figcaption></figure>

**2. Pagamento com Pix**

1. A primeira tela exibe a seleção da forma de pagamento.
2. Na etapa de Identificação, ele informa **nome** e **CPF/CNPJ** (carregados automaticamente se enviados na solicitação).
3. Ao clicar em **“Pagar com pix”**, será gerado um **QR Code** ou código copia e cola.
4. Assim que o pagamento for confirmado, a página é automaticamente atualizada.

<figure><img src="/files/Q2IkFmoOJBupNsZI66Pe" alt=""><figcaption></figcaption></figure>

**3. Pagamento com Boleto**

1. O cliente seleciona Boleto como forma de pagamento.
2. Na etapa de Identificação, ele insere **nome** e **CPF/CNPJ** (também preenchidos automaticamente quando disponíveis).
3. Ao clicar em **“Gerar boleto bancário”**, o documento será criado.
4. O cliente poderá clicar em **“Abrir boleto”** para visualizar o PDF em uma nova aba.

<figure><img src="/files/qbWMH0m5vcoqs1JbWC57" alt=""><figcaption></figcaption></figure>

### Passo 4: Gerenciando Pagamentos Enviados

Após a solicitação de pagamento ser enviada, você terá várias opções para interagir com a mensagem diretamente na tela de atendimento:

#### Ações ao Passar o Mouse

Ao passar o mouse sobre a mensagem de pagamento, duas ações rápidas aparecem:

* **Responder:** Clique no ícone de seta (↩︎) para citar a solicitação em sua próxima mensagem.
* **Baixar:** Clique no ícone de download (↓) para salvar a imagem da solicitação em seu computador.

<figure><img src="/files/hf2VrduxcKn4TNeKfTes" alt=""><figcaption></figcaption></figure>

#### Ações de Seleção

Você também pode selecionar uma ou mais mensagens clicando na caixa de seleção (checkbox) que aparece no canto. Ao fazer isso, uma barra de ações surgirá na parte inferior da tela com as seguintes opções:

* **Baixar mídia:** Faz o download de todos os itens selecionados.
* **Encaminhar:** Envia as mensagens selecionadas para outra conversa.
* **Excluir:** Remove as conversas selecionadas.

<figure><img src="/files/cxrJsGucOzI4FPP8pfcj" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Y4tMUAkyzEDKhH9JmIIC" alt=""><figcaption></figcaption></figure>

#### Excluindo uma Mensagem

Ao clicar em **"Excluir"** na barra de ações, um pop-up de confirmação será exibido. Você terá duas opções:

1. **Apagar para mim:** Remove a mensagem apenas da sua visualização.
2. **Apagar para todos:** Remove a mensagem para você e para o contato **(Nota: Esta opção está disponível apenas para canais da API Não Oficial).**

<figure><img src="/files/slzjHH0lOgQnjAsfl0wS" alt=""><figcaption></figcaption></figure>

#### Detalhes da Mensagem (Avançado)

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

<figure><img src="/files/tBykNcNnqgn8U4794IoJ" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais**\
Qualquer negociação relacionada a taxas, tarifas ou valores aplicados às cobranças deve ser realizada diretamente com o **Asaas**, responsável pelo processamento dos pagamentos.
{% endhint %}


# Iniciar Chatbot

Guia detalhado sobre como utilizar chatbots durante o atendimento para otimizar processos e melhorar a experiência do cliente.

{% embed url="<https://drive.google.com/file/d/17INSvylOjzuV0PBJi8WZY_zAw5TYZDae/view?usp=sharing>" %}

O uso de chatbots contribui para aumentar a eficiência operacional e aprimorar a experiência do usuário, permitindo responder rapidamente a dúvidas frequentes, direcionar clientes aos recursos adequados e executar tarefas simples de forma automática. Dessa forma, os agentes humanos podem focar em atendimentos que exigem análise e intervenção mais complexas.

{% hint style="success" %}
**Pré-requisitos**:

* Ter um chatbot do tipo **Automação** previamente criado na plataforma.
  {% endhint %}

### Passo 1: Acessar a Opção de Anexo

1. Com a conversa já iniciada, na tela de **Atendimentos**, selecione a conversa em que deseja enviar o chatbot.
2. Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
3. No menu exibido, selecione a opção **“Iniciar chatbot”.**

<figure><img src="/files/jTVsTOo2Or9tZ2xtQDqk" alt=""><figcaption></figcaption></figure>

### Passo 2: Selecionar e Enviar o Chatbot

Ao escolher a opção **Iniciar chatbot**, será aberto uma caixa de seleção para que você selecione o fluxo desejado.

1. Serão exibidos apenas os **chatbots de automação publicados** para o canal do atendimento.
2. A caixa de seleção inclui uma **barra de pesquisa** para localizar o chatbot pelo nome e filtros de uso: **Todos os usos**, **API**, **Conversas**, **Campanha** e **Sequência**.
3. Os chatbots disponíveis serão listados conforme o filtro aplicado.
4. Ao clicar no chatbot desejado, ele será **imediatamente enviado** na conversa e a automação será iniciada.

<figure><img src="/files/820RWCh50QfI7nZEdeRL" alt=""><figcaption></figcaption></figure>

### Passo 3: Início do Chatbot e Opção de Interromper o Fluxo

1. Após o envio, o chatbot é iniciado automaticamente na conversa.
2. Na mensagem de transição, será exibido **qual usuário iniciou o chatbot**, garantindo rastreabilidade dentro do atendimento.
3. Durante a execução, também ficará disponível a opção **“Interromper fluxo do chatbot”**, permitindo encerrar a automação a qualquer momento.

<figure><img src="/files/1UeVgm9n6s4w0MGdHocy" alt=""><figcaption></figcaption></figure>

### Passo 4: Interromper o Fluxo do Chatbot

Ao clicar em **“Interromper fluxo do chatbot”**, será exibido uma mensagem de confirmação.\
\
Ao confirmar a ação clicando em **“Interromper”**:

* A execução do chatbot é imediatamente finalizada.
* O usuário do atendimento pode enviar mensagens normalmente.

<figure><img src="/files/kSy5OcEIrBGFlDqyRRzf" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/puG8cp838eGGIkwKP2cy" alt=""><figcaption></figcaption></figure>

### Passo 5: Gerenciando Mensagens Enviadas

Após a mensagem ser enviada, você terá várias opções para interagir com a mensagem diretamente na tela de atendimento:

#### **Ações ao Passar o Mouse**

Ao passar o mouse sobre a mensagem, duas ações rápidas aparecem:

* **Responder:** Clique no ícone de seta (↩︎) para citar a mensagem em sua próxima mensagem.
* **Baixar:** Clique no ícone de download (↓) para salvar o arquivo em seu computador (Disponível apenas para mensagens que contêm arquivos.)

<figure><img src="/files/AdtiAi1xu39KKbuxwS8m" alt=""><figcaption></figcaption></figure>

#### **Ações de Seleção**

Você também pode selecionar uma ou mais mensagens clicando na caixa de seleção (checkbox) que aparece no canto. Ao fazer isso, uma barra de ações surgirá na parte inferior da tela com as seguintes opções:

* **Baixar mídia:** Faz o download de todos os itens selecionados (Disponível apenas para mensagens que contêm arquivos.)
* **Excluir:** Remove as mensagens selecionadas.
* **Encaminhar:** Envia as mensagens selecionadas para outra conversa.

<figure><img src="/files/vbAdrOSRidoQnD6fCAqQ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/dtcW4SR7NoDf3zITIELd" alt=""><figcaption></figcaption></figure>

#### **Excluindo uma Mensagem**

Ao clicar em **"Excluir"** na barra de ações, um pop-up de confirmação será exibido. Você terá duas opções:

1. **Apagar para mim:** Remove a mensagem apenas da sua visualização.
2. **Apagar para todos:** Remove a mensagem para você e para o contato **(Nota: Esta opção está disponível apenas para canais da API Não Oficial).**

<figure><img src="/files/5oFuY1hpXZ0TkyNK1qbT" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Restrição de Gerenciamento**

Se o chatbot incluir um fluxo que utilize um Modelo de Mensagem, será possível apenas encaminhar a mensagem; não é possível selecionar ou excluir.
{% endhint %}

#### Detalhes da Mensagem (Avançado)

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

<figure><img src="/files/9Z2cb1ok3ytPQC9YT6vg" alt=""><figcaption></figcaption></figure>


# Notas da Conversa

Guia detalhado sobre o uso das Notas Internas na plataforma: como registrar informações internas de atendimento para melhorar a organização e a eficiência no suporte ao cliente.

{% embed url="<https://drive.google.com/file/d/1prHksytUTdIYWuIsQ76tV2oUuAu-EEuD/view?usp=sharing>" %}

As **Notas Internas** permitem que os atendentes registrem informações relevantes diretamente na conversa, sem que o cliente tenha acesso. Essa funcionalidade ajuda a organizar o atendimento, facilita a colaboração entre a equipe e mantém um histórico centralizado, garantindo um suporte mais eficiente e transparente.

### Passo 1: Acessar a Opção de Anexo

1. Na tela de Atendimentos, selecione a conversa para a qual deseja adicionar a nota.
2. Na barra de digitação, clique no ícone de Anexo<img src="/files/fjAzh8myLC9PWxlXBEiC" alt="" data-size="line">
3. No menu de opções que será exibido, escolha **"Notas da conversa".**

<figure><img src="/files/8hMOfsRHzwgyVzmTRhnQ" alt=""><figcaption></figcaption></figure>

### Passo 2: Escrever e adicionar a nota na conversa

Ao selecionar a opção **Notas da conversa**, será exibida uma barra inferior onde você poderá digitar a nota que deseja registrar no atendimento.

* Na barra, haverá um ícone de **anexo**. Ao clicar nele, serão exibidas as opções **Imagem**, **Vídeo** e **Documento**, permitindo incluir arquivos na nota.

Após escrever e salvar, a nota será imediatamente adicionada e exibida na linha do tempo da conversa.

* As notas seguem a ordem cronológica da conversa, sendo posicionadas exatamente no ponto em que foram registradas.
* Na parte superior da nota, é exibido o nome do usuário que a adicionou.

<figure><img src="/files/NWjxng7esADf7fI8SJAq" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/oUG6Cn5wEa3e3nIBRuo7" alt=""><figcaption></figcaption></figure>

### Passo 3: Editar ou excluir uma nota

Cada nota exibe dois ícones:

* Um ícone de informação, exibindo a mensagem que a nota é privada e não é visível para o contato.
* O ícone de **três pontos**, que abre as opções **Editar** e **Excluir**.

<figure><img src="/files/8pL7tiRmYqCJj3Viaumv" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Regras de Permissão**

**Administrador**

* Pode **excluir qualquer nota**, a qualquer momento.
* Pode **editar apenas as próprias notas**, sem limite de tempo.

**Atendente Supervisor, Atendente e Atendente Restrito**

* Podem **editar ou excluir somente as próprias notas**.
* A edição ou exclusão só é permitida **dentro de até 2 horas** após a criação da nota.
* Após esse prazo, **nenhuma ação** (editar/excluir) é permitida.
  {% endhint %}

#### Editar uma nota

Ao selecionar **Editar**, a barra inferior é exibida novamente, permitindo alterar o texto da nota interna.

* Caso haja um arquivo, é possível alterá-lo ou excluí-lo.
* Ao clicar em **Cancelar**, a barra é fechada sem aplicar alterações.
* Ao clicar em **Salvar**, a edição é registrada e a nota é atualizada na conversa.

<figure><img src="/files/4RdtuWUup18saNQ807Q8" alt=""><figcaption></figcaption></figure>

#### Excluir uma nota

Ao selecionar **Excluir**, a nota é removida e substituída pela mensagem “Nota apagada”.

<figure><img src="/files/lEIbVdIMRwGMjr3I2KhL" alt=""><figcaption></figcaption></figure>


# Integração com o CRM

{% embed url="<https://drive.google.com/file/d/1OBLume762vHoP6pEiLzak3zPKDYcVfpA/view?usp=sharing>" %}

Nesta seção, você terá acesso a um guia completo que explica o processo de inserção de cards através do atendimento, bem como os procedimentos para visualizar os painéis vinculados. Aqui você entenderá como utilizar esses recursos para registrar informações, monitorar etapas e manter o controle das interações.

{% content-ref url="/pages/qkPnNa6J9vAiKvz5xBv2" %}
[Criar Cards Através do Atendimento](/guide/documentacao/atendimento/integracao-atendimento-x-crm/inserir-card-em-painel-1)
{% endcontent-ref %}


# Criar Cards Através do Atendimento

Saiba como inserir, editar e visualizar itens dos seus Painéis durante o atendimento ao cliente.

{% embed url="<https://drive.google.com/file/d/1M20U1wqVPGLJx3_7pKv6WXTmCEovQKb0/view?usp=sharing>" %}

Os Painéis são uma ferramenta que permite gerenciar e visualizar informações de forma organizada e eficiente. Com eles, é possível inserir cards para destacar informações importantes, tarefas, métricas e muito mais. Neste artigo, você encontrará um passo a passo detalhado para inserir cards nos Painéis durante o atendimento.

### Passo 1: Acessar os Painéis

1. Na tela de Atendimentos, selecione a conversa em que deseja adicionar um card.
2. Na barra de digitação, clique no ícone de Painel<img src="/files/VUeL88fEiTlk7zfiIQdd" alt="" data-size="line">
3. No menu exibido, escolha o Painel em que o card será incluído.
4. Clique em **"Novo item"**.

<figure><img src="/files/kR78njO9RCM8b2VEJS3D" alt=""><figcaption></figcaption></figure>

### Passo 2: Inserir um card no Painel

Ao clicar em **"Novo item"**, será aberto um menu para configurar as informações do card.

Você pode:

1. **Definir data e horário de vencimento**.
2. **Selecionar o usuário responsável**.
3. **Adicionar etiquetas** (é possível criar uma nova etiqueta clicando em **+** no menu de etiquetas).
4. **Definir o título do card** (preenchido automaticamente com o nome do contato, mas pode ser editado).
5. **Adicionar uma descrição**.
6. **Atribuir contatos** (o contato do atendimento já vem selecionado, mas pode ser removido; é possível adicionar outros contatos).
7. **Definir valor monetário**.

{% hint style="warning" %}
Apenas o **título** é obrigatório; todos os outros campos são opcionais.
{% endhint %}

<figure><img src="/files/rV92zxcQPkledDNN502o" alt=""><figcaption></figcaption></figure>

### Passo 3: Visualizar e inserir mais informações

Após salvar, uma prévia do card será exibida no ícone de Painel<img src="/files/VUeL88fEiTlk7zfiIQdd" alt="" data-size="line"> do atendimento. Ao clicar, a janela completa do card será aberta.

1. **Lado esquerdo:** são exibidas as informações preenchidas na criação do card. Ao clicar em qualquer campo, é possível editá-lo.
2. **Ações do card:** na parte inferior do lado esquerdo, estão os ícones para **Duplicar**, **Arquivar** e **Excluir**, além da opção **Configurar campos**.
3. **Lado direito:** possui duas abas:
   * **Anotações/Anexos:** permite adicionar anotações e anexar arquivos.
   * **Histórico:** exibe o histórico de alterações do card.
4. **Fases do Painel:** na parte inferior do lado esquerdo, são exibidas as fases do painel. Ao clicar em uma fase, é possível mover o card entre elas.

<figure><img src="/files/S507cb9n6WAcdIX8iTaH" alt=""><figcaption></figcaption></figure>

### Passo 4: Visualização do Painel

Abaixo da prévia do card, serão exibidas duas opções: **Novo item** e **Todos os itens**.

* **Novo item**: permite criar um novo card, seguindo as orientações apresentadas nos passos anteriores.
* **Todos os itens**: ao selecionar essa opção, será aberta uma janela exibindo o painel no qual o card foi criado, mostrando os cards existentes e suas respectivas fases. O painel será exibido com um filtro automático de **“apenas os do contato”**; para visualizar todos os cards do Painel, basta remover esse filtro.

Para que um usuário consiga visualizar um painel, é necessário que ele tenha acesso por meio de uma das seguintes opções, configuradas durante a **criação ou edição** do painel:

* **Quem pode administrar:** ser um usuário selecionado como administrador do painel.
* **Quem pode acessar:** fazer parte da equipe selecionada para o painel.
* **Flag “Disponível para atendente restrito”:** estar habilitada quando um usuário atendente restrito precisa visualizar o painel.

**Observação:**

* Se um contato estiver em atendimento e possuir um card em um painel, mas o usuário responsável pelo atendimento não tiver acesso ao painel, ele **não visualizará o painel** ao clicar no ícone de Painel<img src="/files/aWmf8hTcQN73V7QZZeUi" alt="" data-size="line"> dentro do atendimento.
* Administradores têm acesso a todos os painéis, independentemente das configurações de visibilidade.

{% hint style="warning" %}
**Considerações Adicionais**

Algumas funcionalidades da plataforma podem variar conforme o plano contratado. Importante observar que:

* **Apenas usuários com perfil de Administrador** têm permissão para criar painéis.
* **Limite de Painéis:** cada plano possui uma quantidade específica de painéis disponíveis. Em caso de dúvidas sobre os limites do seu plano, entre em contato com o CS responsável pela sua conta.
  {% endhint %}


# Grupos do Whatsapp

{% embed url="<https://drive.google.com/file/d/1_JlAglfnwv8afNy9sValeRftGN9_oDbk/view?usp=sharing>" %}

Nesta seção, você encontra todos os guias necessários para criar e gerenciar conversas em grupos na plataforma. Aqui estão detalhadas as regras de criação para canais da API Oficial e Não Oficial, além de instruções completas sobre como utilizar as ações de controle Arquivar, Bloquear, Sair e Excluir em seus grupos.

{% content-ref url="/pages/NvNbT6yr5D6w2KHD20Hn" %}
[Criar Grupos (API Oficial)](/guide/documentacao/atendimento/gestao-de-grupos-no-atendimento/api-oficial)
{% endcontent-ref %}

{% content-ref url="/pages/lcvPDac6EACWmBFrYpqL" %}
[Criar Grupos (API Não Oficial)](/guide/documentacao/atendimento/gestao-de-grupos-no-atendimento/api-nao-oficial)
{% endcontent-ref %}

{% content-ref url="/pages/Um8RqI3WdOfeO9Ej527Z" %}
[Gerenciar Grupos (Arquivar, Bloquear, Sair, Excluir)](/guide/documentacao/atendimento/gestao-de-grupos-no-atendimento/gerenciar-grupos-arquivar-bloquear-sair-excluir)
{% endcontent-ref %}


# Criar Grupos (API Oficial)

Guia completo para criação, gestão e centralização de conversas em grupos do WhatsApp diretamente pela plataforma.

{% embed url="<https://drive.google.com/file/d/1pF8Nc98xS9Yx7_z2onBJXWTPF-sjt7_r/view?usp=sharing>" %}

A utilização de grupos contribui significativamente para a eficiência da comunicação, permitindo uma organização mais estruturada e colaborativa entre equipes, setores e fluxos de atendimento.

{% hint style="warning" %}

#### **Regra de Elegibilidade da Meta (Requisito Obrigatório)**

A Meta estabelece critérios específicos para a criação de Grupos nos canais que utilizam a API Oficial do WhatsApp. Para que o grupo seja criado, o canal deve atender ao seguinte requisito:

* **Possuir o Selo de Conta Verificada (OBA – Official Business Account)**.

Caso o canal **não atenda a esse critério**, a criação de Grupos não poderá ser concluída, e o sistema exibirá a seguinte **mensagem de aviso**:

<img src="/files/eCEciwlIaZq8SMh4BSu3" alt="" data-size="original">
{% endhint %}

{% hint style="success" %}
**Pré-requisitos:**

* Possuir acesso à plataforma com perfil de administrador.
* Ter a funcionalidade devidamente habilitada na plataforma.
  {% endhint %}

### Passo 1: Iniciar a criação de um novo grupo

1. Na tela **Atendimentos**, clique nos **três pontos** ( **⋮** ) localizados no topo da lista de conversas.
2. No menu exibido, selecione **“Novo grupo”**.

<figure><img src="/files/bmo9eTV05n0JPny1Gb36" alt=""><figcaption></figcaption></figure>

### Passo 2: Configurar o controle de acesso

Ao selecionar **“Novo grupo”**, será exibido um painel para definir quem poderá visualizar e interagir com o grupo na plataforma.

1. **Selecionar canal de atendimento:**\
   Escolha o canal da **API Oficial** que será utilizado como criador do grupo.
2. **Acesso ao grupo:**\
   Defina quem terá permissão para acessar o grupo:
   * Todas as equipes,
   * Equipes específicas, ou
   * Usuários selecionados individualmente.
3. **Moderadores do grupo:**\
   Escolha quem poderá administrar o grupo (editar, adicionar/remover membros e excluir).\
   A lista de moderadores disponíveis será filtrada conforme o acesso definido na etapa anterior.

<figure><img src="/files/G62USg6UxUL9m0sLmZA1" alt=""><figcaption></figcaption></figure>

### Passo 3: Definir as informações de identificação do grupo

Após configurar o controle de acesso e clicar em **Continuar**, será exibida um novo painel para definir os dados do grupo:

1. **Nome do grupo** - obrigatório.
2. **Foto do grupo** - opcional.
3. **Descrição do grupo** - opcional.
4. **Etiquetas do grupo** - opcionais.

Ao clicar em **“Criar grupo”**, ele será adicionado automaticamente à sua lista de atendimentos.

<figure><img src="/files/3F4wSLTOE2BE3YlxWlyl" alt=""><figcaption></figcaption></figure>

### Passo 4: Gerenciar um grupo existente

Depois que o grupo estiver criado, diversas ações de gerenciamento estarão disponíveis.

1. **Acessar detalhes do grupo:**\
   Com a conversa aberta, clique no ícone <img src="/files/6AMLMXhebHkIGpwJtC37" alt="" data-size="line"> (Ver detalhes do grupo) no cabeçalho para abrir o painel lateral **“Dados do grupo”**.
2. **Opções de gerenciamento no painel “Dados do grupo”:**
   * Editar **nome**, **foto**, **etiquetas** e **descrição**.
   * **Copiar Link de Convite** para adicionar novos membros.
   * **Redefinir link de convite**, invalidando o anterior e gerando um novo para maior segurança.
   * **Gerenciar membros:** ao clicar nos três pontos ( **⋮** ) ao lado de cada participante, é possível visualizar detalhes do contato ou removê-lo do grupo.
   * **Alterar acessos e permissões:** use o ícone **“Alterar Permissões”** para reabrir o painel de controle de acesso.
   * Na barra superior do painel, acesse o ícone <img src="/files/4vu1CFDFbkIVKl7w5HCp" alt="" data-size="line"> (Ações de Arquivamento), onde você poderá:
     * **Arquivar**,
     * **Bloquear**,
     * **Excluir**.

**O que cada ação faz?**

* **Arquivar:** move a conversa para a seção de Concluídos. Se novas mensagens chegarem, o grupo será reaberto automaticamente.\
  \&#xNAN;*Essa ação afeta apenas a plataforma, não o WhatsApp.*
* **Bloquear:** impede o envio e o recebimento de mensagens na plataforma. O grupo vai para Concluídos, mas pode ser desbloqueado depois.\
  \&#xNAN;*Essa ação não afeta o WhatsApp.*
* **Excluir:** remove o grupo para todos os participantes. A conversa será movida para Concluídos e permanecerá apenas para consulta.\
  \&#xNAN;*Essa ação é irreversível e será refletida no WhatsApp.*

<figure><img src="/files/9eOoYPVx43AoY6EXmBhi" alt=""><figcaption></figcaption></figure>

### Passo 5: Visualizar a entrega e a leitura das mensagens

Após o envio, é possível verificar para quem a mensagem foi entregue e quem já visualizou.

1. Na mensagem enviada, clique no menu de **três pontos** ( **⋮** ) ao lado direito.
2. Nas informações da mensagem, em **Entregue/Lida**, clique em **“Visualizar”**.
3. Será aberta a janela de **Visualização**, com duas abas:
   * **Aba “Membros”:**\
     Exibe o status da mensagem para os contatos finais no WhatsApp.\
     Mostra quem recebeu (**Entregue para**) e quem leu (**Lida por**) a mensagem.
   * **Aba “Usuários”:**\
     Exibe o status dentro da plataforma, mostrando quais atendentes visualizaram a mensagem internamente.

<figure><img src="/files/DfeynS1i3V4F2YMFW6kq" alt=""><figcaption></figcaption></figure>

**Notificações de Alteração de Membros**

Para garantir total transparência, sempre que houver mudanças nos participantes do grupo, o sistema registrará automaticamente essas ações no histórico da conversa.

Uma mensagem de sistema será exibida informando quando um membro **entrou** ou **saiu** do grupo, conforme o exemplo abaixo:

<figure><img src="/files/AX8YLTQgH487I3yeU8Jk" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Regras de Funcionamento para Grupos (API Oficial da Meta)**

Ao utilizar a funcionalidade de Grupos em um canal conectado à **API Oficial do WhatsApp**, é fundamental conhecer as regras e limitações definidas pela Meta. Abaixo estão os principais pontos que impactam o uso e a operação dos grupos:

**1. Limite de Participantes**

Cada grupo pode ter **até 9 números participantes**, sendo:

* **8 membros (contatos)**
* **1 número da sua empresa** (o canal vinculado ao grupo)

***

**2. Método de Entrada no Grupo**

A **única forma** de um contato entrar no grupo é por meio do **link de convite**.

* Não é possível adicionar participantes manualmente.
* Não existe opção de aprovação do moderador para entrada.

***

**3. Restrição Após Remoção**

Se um participante for removido por um moderador:

* **Ele não poderá retornar ao grupo**, mesmo utilizando o link de convite.
* A restrição é permanente para aquele grupo específico.

***

**4. Regra da Janela de 24 Horas**

A política da Meta para reabertura de conversas também se aplica aos grupos:

* Se a última mensagem do contato no grupo for de **mais de 24 horas**, será necessário enviar um **modelo de mensagem (template)** para reiniciar a conversa.

***

**5. Modelo de Cobrança**

A tarifação segue o modelo por **conversa individual de 24 horas**, por membro:

* Uma única mensagem enviada pela empresa em um grupo com **8 participantes** gera **8 conversas tarifadas**.
* Cada membro representa uma sessão de cobrança separada.

***

**6. Acesso Direto via Link**

Diferente de grupos criados em APIs não oficiais:

* **Não existe fluxo de solicitação de entrada.**
* Se o contato tiver um link válido, ele **entra automaticamente**, sem aprovação.

***

**7. Restrição de Disponibilidade**

A funcionalidade de grupos **não está disponível** para:

* Contas WhatsApp Business (WABAs) configuradas no modelo de Coexistência **(Coexistence Users)**
* Números que utilizam **Multi-Solution Conversations**.
  {% endhint %}

{% hint style="info" %}
**Funcionalidades em Conversas de Grupo**

Ao interagir em grupos, o menu de ações (ícone de anexo) possui comportamentos específicos:

* **Indisponível:** Não é possível Agendar Mensagens, Solicitar Pagamentos ou Iniciar Chatbots.
* **Disponível:** O envio de mídias (imagens, vídeos, áudios, documentos), Modelos de mensagem, Respostas rápidas e Notas internas continua funcionando normalmente.
  {% endhint %}


# Criar Grupos (API Não Oficial)

Guia completo para criação, gestão e centralização de conversas em grupos do WhatsApp diretamente pela plataforma.

{% embed url="<https://drive.google.com/file/d/1ARa-6zPqPXSmzFQl1t4SrcxUKh86KG9d/view?usp=sharing>" %}

A utilização de grupos contribui significativamente para a eficiência da comunicação, permitindo uma organização mais estruturada e colaborativa entre equipes, setores e fluxos de atendimento.

{% hint style="success" %}
**Pré-requisitos:**

* Possuir acesso à plataforma com perfil de administrador.
* Ter a funcionalidade devidamente habilitada na plataforma.
  {% endhint %}

### Passo 1: Iniciar a criação de um novo grupo

1. Na tela **Atendimentos**, clique nos **três pontos** ( **⋮** ) localizados no topo da lista de conversas.
2. No menu exibido, selecione **“Novo grupo”**.

<figure><img src="/files/7wCCbhYWwSvD4Cr7VF5z" alt=""><figcaption></figcaption></figure>

### Passo 2: Configurar o controle de acesso

Ao selecionar **“Novo grupo”**, será exibido um painel para definir quem poderá visualizar e interagir com o grupo na plataforma.

1. **Selecionar canal de atendimento:**\
   Escolha o canal da **API Não Oficial** que será utilizado como criador do grupo.
2. **Acesso ao grupo:**\
   Defina quem terá permissão para acessar o grupo:
   * Todas as equipes,
   * Equipes específicas, ou
   * Usuários selecionados individualmente.
3. **Moderadores do grupo:**\
   Escolha quem poderá administrar o grupo (editar, adicionar/remover membros e excluir).\
   A lista de moderadores disponíveis será filtrada conforme o acesso definido na etapa anterior.

<figure><img src="/files/KIJ3gquW0rHFAoSRUfnK" alt=""><figcaption></figcaption></figure>

#### Definição de canal responsável

Quando o grupo possuir **mais de um canal de atendimento da mesma conta como participante**, o sistema exigirá a definição de um **canal responsável** pelo grupo.

* A seleção é **obrigatória** nesses casos.
* O canal responsável será o **único número utilizado** para envio de mensagens pela plataforma.
* A interface exibirá **indicadores visuais (badges)** informando se o canal selecionado é **Administrador** ou **Participante** no grupo.
* Caso o grupo esteja configurado como **“Somente administradores”** e o canal responsável não seja administrador, o envio de mensagens ficará **bloqueado**, respeitando as regras do WhatsApp.

<figure><img src="/files/tPFYjlx329WoAh2ziSJ7" alt=""><figcaption></figcaption></figure>

### Passo 3: Definir as informações de identificação do grupo

Após configurar o controle de acesso e clicar em **Continuar**, será exibida um novo painel para definir os dados do grupo:

1. **Nome do grupo** - obrigatório.
2. **Foto do grupo** - opcional.
3. **Descrição do grupo** - opcional.
4. **Etiquetas do grupo** - opcionais.

<figure><img src="/files/HFihEW6SJvMgfqnhIrEv" alt=""><figcaption></figcaption></figure>

### Passo 4: Definir as Configurações do Grupo

Na última etapa da criação, o sistema exibirá o painel **“Configurações do Grupo”**. Essa tela é essencial para definir as permissões e o modo de funcionamento do novo grupo.

No painel, você poderá configurar as seguintes opções:

1. **Permissão para envio de mensagens**

Escolha quem poderá enviar mensagens no grupo:

* **Todos os membros**, ou
* **Apenas administradores**.<br>

2. **Permissão para adicionar membros**

Defina quem pode incluir novos participantes:

* **Todos os membros**, ou
* **Apenas administradores**.<br>

3. **Permissão para editar o grupo**

Determine quem poderá editar as informações do grupo (nome, imagem, descrição):

* **Todos os membros**, ou
* **Somente administradores**.<br>

4. **Autorizar novos membros**

Ative essa opção caso deseje que a entrada de novos participantes **exija aprovação de um administrador**, garantindo maior controle sobre a composição do grupo.

Após ajustar todas as configurações conforme sua necessidade, clique em **“Criar grupo”** para concluir o processo.

<figure><img src="/files/TsUS0bgU8b2fYfGNInFu" alt=""><figcaption></figcaption></figure>

### Passo 5: Gerenciar um grupo existente

Após a criação do grupo, diversas opções de gerenciamento ficam disponíveis para controle e manutenção do seu funcionamento.

#### Acessar os detalhes do grupo

Com a conversa do grupo aberta, clique no ícone<img src="/files/6AMLMXhebHkIGpwJtC37" alt="" data-size="line">(Ver detalhes do grupo) no cabeçalho. Isso abrirá o painel lateral **“Dados do grupo”**, onde todas as ações de administração estarão centralizadas.

**Opções de gerenciamento no painel “Dados do grupo”**

1. **Edição de informações**

* Alterar **nome**, **foto**, **etiquetas** e **descrição** do grupo.

2. **Gestão do link de convite**

* **Copiar link de convite** para envio a novos participantes.
* **Redefinir link**, invalidando o atual e gerando um novo (recomendado para reforçar a segurança).

3. **Alterar Configurações do Grupo**

* No topo do painel, clique no ícone<img src="/files/MdRGrJlFavZtlYItAipc" alt="" data-size="line">para reabrir o painel **Configurações do Grupo**, permitindo ajustar permissões e comportamentos definidos na criação.

4. **Alterar acessos e permissões**

* Na parte inferior do painel, clique no ícone<img src="/files/MdRGrJlFavZtlYItAipc" alt="" data-size="line">**“Alterar Permissões”** para reabrir o painel de **Controle de Acesso**, onde é possível revisar quem pode visualizar e interagir com o grupo na plataforma.

5. **Ações de Arquivamento**

No topo do painel, clique no ícone <img src="/files/4vu1CFDFbkIVKl7w5HCp" alt="" data-size="line">**Ações de Arquivamento**, onde você poderá:

* **Arquivar**
* **Bloquear**
* **Sair**
* **Excluir**

**O que cada ação faz?**

* **Arquivar:**\
  Move a conversa para a seção **Concluídos**. Se novas mensagens forem enviadas no grupo, ele será reaberto automaticamente.\
  \&#xNAN;*A ação não afeta o grupo no WhatsApp, apenas na plataforma.*
* **Bloquear:**\
  Impede o envio e o recebimento de mensagens na plataforma. A conversa será movida para **Concluídos**, podendo ser desbloqueada posteriormente.\
  Essa aç*ão afeta o WhatsApp.*
* **Sair:**\
  Remove **somente o canal de atendimento** do grupo. A conversa será movida para **Concluídos**, ficando disponível apenas para consulta.\
  \&#xNAN;*Essa ação é irreversível e será refletida no WhatsApp.*
* **Excluir:**\
  Remove o grupo para todos os participantes. A conversa será movida para **Concluídos** e ficará apenas para consulta.\
  \&#xNAN;*Essa ação é irreversível e será refletida no WhatsApp.*

#### Gerenciando os membros do grupo

Para administrar os participantes, acesse a lista de membros no painel lateral e clique no menu de três pontos ( **⋮** ) ao lado de cada contato. As opções exibidas variam conforme o status do participante.

**Para membros com entrada&#x20;*****Pendente*****:**

* **Visualizar contato:** abre os detalhes do contato.
* **Autorizar entrada:** aprova a solicitação e adiciona o membro ao grupo.
* **Remover:** recusa a entrada do contato.

**Para membros já participantes do grupo:**

* **Visualizar contato:** abre os detalhes do contato.
* **Promover a Admin de grupo:** concede permissões administrativas.
* **Remover:** exclui o membro do grupo.

**Para membros que já são administradores:**

* **Remover Acesso de Admin:** retira as permissões de administrador, convertendo-o em membro comum.

<figure><img src="/files/Z1EZL2WrQ7XXrXYrmLz8" alt=""><figcaption></figcaption></figure>

### Passo 6: Visualizar a entrega e a leitura das mensagens

Após o envio, é possível verificar para quem a mensagem foi entregue e quem já visualizou.

1. Na mensagem enviada, clique no menu de **três pontos** ( **⋮** ) ao lado direito.
2. Nas informações da mensagem, em **Entregue/Lida**, clique em **“Visualizar”**.
3. Será aberta a janela de **Visualização**, com duas abas:
   * **Aba “Membros”:**\
     Exibe o status da mensagem para os contatos finais no WhatsApp.\
     Mostra quem recebeu (**Entregue para**) e quem leu (**Lida por**) a mensagem.
   * **Aba “Usuários”:**\
     Exibe o status dentro da plataforma, mostrando quais atendentes visualizaram a mensagem internamente.

<figure><img src="/files/nRYhAMKTexNHEjBJnhHE" alt=""><figcaption></figcaption></figure>

#### Notificações de Alteração de Membros

Para garantir total transparência, sempre que houver mudanças nos participantes do grupo, o sistema registrará automaticamente essas ações no histórico da conversa.

Uma mensagem de sistema será exibida informando quando um membro **entrou** ou **saiu** do grupo, conforme o exemplo abaixo:

<figure><img src="/files/wVs3wuhceVGDQpzI2DwC" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Regras de Funcionamento para Grupos (API Não Oficial)**

Ao utilizar a funcionalidade de Grupos em um canal conectado à **API Não Oficial do WhatsApp**, é importante conhecer as regras e limitações específicas desse modelo de integração:

**1. Limite de Participantes**

Cada grupo pode ter **até 1024 números participantes**, sendo:

* **1023 membros** (contatos)
* **1 número da sua empresa** (o canal conectado ao grupo)

***

**2. Método de Entrada no Grupo**

A entrada de novos membros ocorre **exclusivamente** por meio do **link de convite**.

* Não é possível adicionar participantes manualmente.

***

**3. Restrição Após Remoção**

Se um membro for removido do grupo por um moderador:

* **Ele não poderá retornar ao grupo**, mesmo que utilize o link de convite.
* A restrição é definitiva para aquele grupo específico.

***

**4. Sincronização Automática de Grupos**

Ao conectar um novo canal do WhatsApp à plataforma:

* Todos os grupos dos quais o número já participa são **sincronizados gradualmente em segundo plano**.
* Durante esse processo, esses grupos aparecerão na aba **“Novos”**. Eles permanecerão lá até que um administrador **configure as permissões e controles de acesso** do grupo na plataforma.
* Caso um canal de atendimento seja removido, todos os grupos associados a ele serão automaticamente arquivados.
* Quando um grupo de um canal for sincronizado, o link de convite não será criado automaticamente. Nesses casos, o usuário deverá clicar em “Redefinir link” para gerar um novo link de convite.
  {% endhint %}

{% hint style="info" %}
**Funcionalidades em Conversas de Grupo**

Ao interagir em grupos, o menu de ações (ícone de anexo 📎) possui comportamentos específicos:

* **Indisponível:** Não é possível Agendar Mensagens, Solicitar Pagamentos ou Iniciar Chatbots.
* **Disponível:** O envio de mídias (imagens, vídeos, áudios, documentos), Modelos de mensagem, Respostas rápidas e Notas internas continua funcionando normalmente.
  {% endhint %}


# Gerenciar Grupos (Arquivar, Bloquear, Sair, Excluir)

Guia detalhado sobre como utilizar as Ações de Arquivamento em grupos do WhatsApp.

{% embed url="<https://drive.google.com/file/d/1DE1f1BVmFJWT3D6274jzOyordW2eSC7Z/view?usp=sharing>" %}

As **Ações de Arquivamento** permitem controlar a visibilidade, o status e o comportamento de um grupo diretamente pela plataforma. Siga os passos abaixo para gerenciar corretamente cada uma dessas opções.

### Passo 1: Acessar as ações de gerenciamento

1. Abra a conversa do grupo.
2. Clique no ícone<img src="/files/6AMLMXhebHkIGpwJtC37" alt="" data-size="line">(Ver detalhes do grupo) no cabeçalho.\
   Isso abrirá o painel lateral **“Dados do grupo”**, onde todas as opções de administração ficam centralizadas.

### Passo 2: Selecionar e visualizar a ação desejada

1. No painel lateral, clique no ícone<img src="/files/ngENZXoEZyJWKoMHrfXp" alt="" data-size="line">(Ações de Arquivamento).
2. Um painel com quatro opções será exibido.\
   Por padrão, a ação **“Arquivar”** virá pré-selecionada.

<figure><img src="/files/mGzB7KkL7i9mxwAAwUWt" alt=""><figcaption></figcaption></figure>

Escolha a ação que deseja executar:

* **Arquivar:**\
  Move a conversa para a seção **Concluídos**, encerrando o atendimento apenas na plataforma para fins de organização. O grupo é reaberto automaticamente caso novas mensagens sejam recebidas.\
  \&#xNAN;*Não afeta o grupo no WhatsApp.*
* **Bloquear:**\
  Move a conversa para a seção **Concluídos** e interrompe totalmente o envio e o recebimento de mensagens pela plataforma.\
  \&#xNAN;*Não afeta o grupo no WhatsApp.*
* **Sair (apenas API Não Oficial):**\
  Remove **somente o canal de atendimento** do grupo.\
  A conversa é movida para **Concluídos** e a saída é **irreversível** no WhatsApp.
* **Excluir:**\
  Remove o grupo **somente se o canal for o criador do grupo**:
  * **API Oficial:** o canal é sempre o criador, então a exclusão é sempre permitida.
  * **API Não Oficial:** o canal pode ser apenas participante. A exclusão só será permitida se ele for **criador do grupo**.\
    A exclusão remove o grupo para todos os participantes e é **irreversível**, refletindo também no WhatsApp.

<figure><img src="/files/A34LuoJKWVR0omVUfwjK" alt=""><figcaption></figcaption></figure>

### Passo 3: Finalizar a ação

1. Certifique-se de que a ação desejada está selecionada.
2. Clique no botão **“Confirmar”** para aplicar a operação.

A ação será executada imediatamente e refletida conforme as regras descritas acima.

{% hint style="warning" %}
**Regra de Acesso e Permissão**

**Observação importante sobre permissões**

As ações **Arquivar, Bloquear, Sair e Excluir** possuem restrições específicas para garantir a **integridade dos dados** e o correto **fluxo de trabalho da equipe**.

**Perfis autorizados**

* Apenas **Administradores da Conta** e **Moderadores do Grupo** têm permissão para executar essas ações.

**Restrições para outros usuários**

* Perfis que não possuam essas funções verão as opções **desabilitadas**, sem possibilidade de execução.
  {% endhint %}

**Regras e Consequências de Cada Ação**

Todas as ações listadas abaixo **movem a conversa para a aba “Concluídos”** na plataforma, alterando o status do grupo conforme descrito:

| Ação         | Consequência                                                                                                                                                                                     | Observação Importante                                                                                          |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
| **Arquivar** | Move a conversa para a seção **Concluídos**. Caso novas mensagens sejam recebidas, o grupo será reaberto automaticamente.                                                                        | Ação interna: Não afeta o grupo no WhatsApp.                                                                   |
| **Bloquear** | Bloqueia o envio e o recebimento de mensagens do grupo na plataforma. A conversa é movida para a seção **Concluídos**, mas pode ser desbloqueada a qualquer momento.                             | Ação interna: Não afeta o grupo no WhatsApp.                                                                   |
| **Sair**     | O canal da plataforma sai do grupo (somente o canal será removido). A conversa é finalizada e movida para a seção **Concluídos**, permanecendo disponível apenas para consulta.                  | Ação irreversível, refletida no WhatsApp. **Disponível** somente para canais conectados à **API Não Oficial.** |
| **Excluir**  | Remove o grupo para todos os participantes. A conversa é finalizada e movida para a seção **Concluídos**, permanecendo disponível apenas para consulta, enquanto o grupo é excluído no WhatsApp. | Ação irreversível, refletida no WhatsApp. Deve ser executada com cautela.                                      |

### Passo 4: Ações de Reversão (Desarquivar e Desbloquear)

Grupos que foram **arquivados** ou **bloqueados** podem ser reativados a qualquer momento, restaurando seu status normal na plataforma.

1. Acesse a conversa do grupo na aba **Concluídos**.
2. Clique no ícone<img src="/files/6AMLMXhebHkIGpwJtC37" alt="" data-size="line">(Ver detalhes do grupo) no cabeçalho.
3. No painel lateral **“Dados do grupo”**, identifique o botão **“Desarquivar”** ou **“Desbloquear”**, conforme o status atual do grupo.
4. Clique no ícone correspondente e confirme a ação para reativar o grupo.

<figure><img src="/files/7sUAJOQbchfwwwyAltNi" alt=""><figcaption></figcaption></figure>

**Regras de Hierarquia entre Bloqueio e Arquivamento**

É importante entender como as ações de **Bloqueio** e **Arquivamento** interagem, pois elas possuem uma hierarquia específica e impactam o status do grupo.

<table><thead><tr><th width="276">Cenário</th><th>Regra de Precedência</th></tr></thead><tbody><tr><td><strong>Arquivado e Depois Bloqueado</strong></td><td>Permitido. Um grupo que já está <strong>arquivado</strong> pode ser <strong>bloqueado</strong>. A conversa permanecerá na aba <strong>Concluídos</strong>, mas o <strong>status de Bloqueio</strong> impede qualquer nova interação.</td></tr><tr><td><strong>Bloqueado</strong></td><td>O <strong>bloqueio tem prioridade</strong> sobre o arquivamento. Se um grupo estiver <strong>bloqueado</strong>, a opção de arquivar <strong>não estará disponível</strong>. Ao ser desbloqueado, o grupo retornará automaticamente à aba <strong>Meus</strong>, pronto para novas interações.</td></tr></tbody></table>

**Reativação de Grupos: Comportamento do Histórico**

Quando um grupo é **concluído** (via Arquivar ou Bloquear) e posteriormente reativado (via Desarquivar ou Desbloquear), o sistema mantém o histórico e cria um novo ciclo de atendimento de acordo com as regras abaixo:

**1. Preservação do Histórico (Registro Concluído)**

* O registro da conversa anterior, incluindo o momento em que foi **Arquivado** ou **Bloqueado**, permanece na aba **Concluídos**.
* Ele não é alterado e serve como histórico daquele ciclo de atendimento.

**2. Criação de um Novo Ciclo (Atendimento Ativo)**

* Ao reverter a ação (**Desarquivar** ou **Desbloquear**), o sistema cria um **novo atendimento ativo** para o grupo.
* O grupo é exibido imediatamente na aba **Meus** do usuário responsável.

**3. Acesso ao Histórico Completo**

* No novo atendimento ativo, todo o histórico da conversa anterior está disponível.
* Para visualizar mensagens mais antigas, clique no botão **“Ver conversa anterior”** no topo da janela de chat.

<figure><img src="/files/uyYeziRACI3DB2kyQ8bN" alt=""><figcaption></figcaption></figure>


# CRM

O **CRM** reúne as ferramentas para gerenciar contatos, acompanhar negociações e organizar fluxos de atendimento em um só lugar.

* **Contatos** — cadastre e gerencie sua base de clientes, aplique etiquetas, crie campos personalizados e importe contatos em lote.
* **Painéis** — acompanhe negociações e operações em painéis no formato Kanban. O tipo **Vendas** é voltado para pipeline comercial com controle de Ganho e Perda; o tipo **Gestão** é voltado para fluxos operacionais como suporte, CS e atendimento.
* **Carteiras** — distribua contatos entre atendentes e equipes para organizar o relacionamento por responsável.

{% content-ref url="/pages/Qo8dRasUS28xDcV0tl3I" %}
[Contato](/guide/documentacao/crm/contato)
{% endcontent-ref %}

{% content-ref url="/pages/7eGeUPjgY9GROFle5uXi" %}
[Painéis](/guide/documentacao/crm/paineis)
{% endcontent-ref %}

{% content-ref url="/pages/d9yFfi0GisxKI567X56B" %}
[Carteiras](/guide/documentacao/crm/carteiras)
{% endcontent-ref %}


# Contato

Cadastre, importe, organize e encontre os contatos da sua base, com etiquetas e campos próprios.

O módulo **Contatos** reúne a base de clientes da sua operação. É aqui que você cadastra e importa contatos, organiza a base com etiquetas e campos personalizados, e consulta o histórico de cada um.

{% content-ref url="/pages/NZELR3tj2piNxgSmqUAL" %}
[Gerenciar Etiquetas](/guide/documentacao/crm/contato/gerenciar-etiquetas)
{% endcontent-ref %}

{% content-ref url="/pages/MYLPhRK15rS2VdW2akxf" %}
[Cadastrar contato](/guide/documentacao/crm/contato/cadastrar-contato)
{% endcontent-ref %}

{% content-ref url="/pages/rZ1TvHvUaCPU5rFxj6gt" %}
[Importar Contatos em Lote](/guide/documentacao/crm/contato/importacao-de-contatos)
{% endcontent-ref %}

{% content-ref url="/pages/ZQOvc0OofnVcLd66pqYC" %}
[Pesquisar contato](/guide/documentacao/crm/contato/pesquisar-contato)
{% endcontent-ref %}

{% content-ref url="/pages/t242OZvTTvWgqCvZTJNq" %}
[Bloquear ou Arquivar contato](/guide/documentacao/crm/contato/bloquear-ou-arquivar-contato)
{% endcontent-ref %}

{% content-ref url="/pages/UAFPOydouCJMZlsllTP8" %}
[Editar campos personalizados](/guide/documentacao/crm/contato/editar-campos-personalizados)
{% endcontent-ref %}


# Gerenciar Etiquetas

Crie, edite, vincule e exclua as etiquetas usadas para segmentar a sua base de contatos.

Gerencie aqui as etiquetas da sua base de contatos. Esta seção reúne tudo o que você precisa para criar, personalizar, vincular e excluir etiquetas, mantendo seus contatos organizados e fáceis de segmentar na plataforma.

{% content-ref url="/pages/D30MeFLCkCD3tdm0mChp" %}
[Criar e Editar Etiquetas](/guide/documentacao/crm/contato/gerenciar-etiquetas/inserir-etiqueta)
{% endcontent-ref %}

{% content-ref url="/pages/iTFbxjFtgTE3CQatfXQO" %}
[Excluir Etiquetas](/guide/documentacao/crm/contato/gerenciar-etiquetas/excluir-etiquetas)
{% endcontent-ref %}

{% content-ref url="/pages/uWmderMFHWFd5pk3etdf" %}
[Vincular Etiqueta a um Contato](/guide/documentacao/crm/contato/gerenciar-etiquetas/inserir-etiqueta-1)
{% endcontent-ref %}


# Criar e Editar Etiquetas

Saiba como criar novas etiquetas, personalizar cores e nomes, e manter sua biblioteca de etiquetas organizada na plataforma.

Etiquetas são criadas e gerenciadas diretamente pelo painel de etiquetas, acessível dentro do cadastro de qualquer contato. Você pode criar etiquetas com nomes e cores personalizados, além de editar etiquetas existentes a qualquer momento. Este artigo explica como fazer isso passo a passo.

{% embed url="<https://drive.google.com/file/d/1QCAPcV6EIG93JkxAdUZwIc_PWEMHqwOE/view>" %}

## Quem pode criar e editar etiquetas?

| Perfil                 | O que pode fazer                                                              |
| ---------------------- | ----------------------------------------------------------------------------- |
| **Administrador**      | Criar, editar e excluir etiquetas                                             |
| **Atendente**          | Apenas criar novas etiquetas. Não pode editar ou excluir etiquetas existentes |
| **Atendente Restrito** | Não pode criar, editar ou excluir etiquetas                                   |

## Como criar uma etiqueta

### Acessar o painel de etiquetas

1. No menu superior, acesse **CRM > Contatos**.
2. Abra o cadastro de qualquer contato.
3. Na aba **Detalhes**, clique no ícone de edição ao lado de **Etiquetas**.
4. O painel de etiquetas será aberto com a lista de etiquetas cadastradas na conta.

<figure><img src="/files/NnphaFyiI3XANeqbiwFd" alt=""><figcaption></figcaption></figure>

### Criar a etiqueta

1. Clique no ícone **"+"** no canto superior direito do painel.
2. Digite o nome da etiqueta. O campo exibe um contador de caracteres para orientar o preenchimento.
3. Selecione uma cor na paleta disponível.
4. Clique em **"Salvar"**.

A etiqueta será criada e ficará disponível para uso em toda a plataforma, inclusive em Chatbots, Sequências e importações de contatos.

<figure><img src="/files/U1At3XtdZeKAX4c1LN1V" alt=""><figcaption></figcaption></figure>

## Como editar uma etiqueta

{% hint style="warning" %}
Apenas usuários com perfil de **Administrador** podem editar etiquetas existentes.
{% endhint %}

### Acessar o painel de etiquetas

1. No menu superior, acesse **CRM > Contatos**.
2. Abra o cadastro de qualquer contato.
3. Na aba **Detalhes**, clique no ícone de edição ao lado de **Etiquetas**.

### Editar a etiqueta

1. Localize a etiqueta que deseja editar na lista.
2. Clique no ícone de edição ao lado da etiqueta.
3. Altere o nome, a cor ou ambos.
4. Clique em **"Salvar"** para confirmar as alterações.

As alterações são aplicadas imediatamente em todos os contatos que possuem essa etiqueta vinculada.

<figure><img src="/files/UjOIpQqR4bCqSijorhPb" alt=""><figcaption></figcaption></figure>


# Excluir Etiquetas

Saiba como excluir etiquetas da sua base de contatos com segurança, entendendo o impacto da ação e quando uma validação adicional é solicitada.

Excluir uma etiqueta de contatos é uma ação permanente e irreversível. Ao confirmar, a etiqueta é removida de todos os contatos que a possuem simultaneamente. Para evitar exclusões acidentais, a plataforma exibe o impacto em tempo real e, quando necessário, solicita uma validação de segurança antes de concluir a ação. Este artigo explica quem pode excluir etiquetas, como funciona o processo e o que esperar em cada situação.

{% embed url="<https://drive.google.com/file/d/11yvWcQHG49fAuabvuSNfesYppaOadtoz/view?usp=sharing>" %}

## Quem pode excluir etiquetas de contatos?

Somente usuários com perfil de **Administrador** têm permissão para editar e excluir etiquetas de contatos.

Usuários com perfis operacionais, como **Atendente**, visualizam apenas a opção de criar novas etiquetas. Os ícones de edição e exclusão ficam completamente ocultos da interface para esses perfis.

<figure><img src="/files/LvVMeIBxXuqMJ2dfjOzp" alt=""><figcaption></figcaption></figure>

## Como excluir uma etiqueta de contato

### Acessar o painel de etiquetas

1. No menu superior, acesse **CRM > Contatos**.
2. Localize e abra o cadastro de qualquer contato.
3. No painel lateral, clique no ícone de edição ao lado de **Etiquetas**.
4. O painel de etiquetas será exibido com a lista de etiquetas disponíveis.
5. Clique no ícone de **lixeira** ao lado da etiqueta que deseja excluir.

<figure><img src="/files/ADYDJhjDzNiLi2jI1aRK" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/JoR4lJwvPaQa7s1wWGDr" alt=""><figcaption></figcaption></figure>

### Verificar o impacto

Ao clicar em excluir, o modal **"Excluir etiqueta de contatos"** será aberto. O sistema calcula automaticamente quantos contatos possuem essa etiqueta e exibe um alerta em destaque:

* **Se a etiqueta estiver vinculada a contatos:** o alerta exibirá *"X contatos serão afetados."*

<figure><img src="/files/QYn1YtMs2u0VrKvD6skU" alt=""><figcaption></figcaption></figure>

* **Se a etiqueta não estiver vinculada a nenhum contato:** o alerta exibirá *"Nenhum contato será afetado."*

<figure><img src="/files/IpV3DMwME3YWHvM2ZelH" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
A mensagem de aviso no modal informa: ***"Ao excluir esta etiqueta, ela será removida permanentemente de todos os contatos associados. Esta ação não pode ser desfeita."***
{% endhint %}

### Confirmar a exclusão

O próximo passo depende do impacto identificado:

* **Sem contatos afetados (0 contatos):** clique em **"Excluir etiqueta"** e a exclusão será processada imediatamente, sem etapas adicionais.
* **Com contatos afetados (1 ou mais):** ao clicar em **"Excluir etiqueta"**, a ação será retida e o sistema abrirá o modal de **"Validação de acesso"**, solicitando um código de segurança enviado para o seu e-mail.

<figure><img src="/files/w4SXqno5fPK6tx5eqD7j" alt=""><figcaption></figcaption></figure>

### Inserir o código de validação (quando solicitado)

1. Acesse o e-mail/telefone cadastrado no usuário que fez a solicitação de exclusão.
2. Localize o código de validação recebido.
3. Insira o código no modal de **"Validação de acesso"** e confirme.
4. Após a validação correta, a exclusão será concluída e a etiqueta removida de todos os contatos vinculados.

**Resumo dos cenários de exclusão**

| Situação                             | Validação exigida             | O que acontece                                  |
| ------------------------------------ | ----------------------------- | ----------------------------------------------- |
| Etiqueta **sem** contatos vinculados | Nenhuma                       | Exclusão imediata ao confirmar no modal         |
| Etiqueta **com** contatos vinculados | Código OTP por e-mail/celular | Exclusão concluída apenas após inserir o código |

## Registro na Auditoria

Toda exclusão de etiqueta fica registrada no **Histórico de Alterações**, acessível em **Admin > Auditoria**. Os logs gerados variam conforme o cenário:

* **Exclusão sem impacto:** um registro na entidade **"Etiquetas"**, com o nome da tag excluída.
* **Exclusão com impacto (via OTP):** dois registros, sendo um na entidade **"Etiquetas"** (exclusão) e outro na entidade **"OTP Validação"** (confirmação de segurança).

<figure><img src="/files/mmQQrWaSO734ly5JnvNi" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NHqyfHGgK0qxw5x8JOki" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Dica:** Caso queira cancelar a ação em qualquer etapa, clique em **"Cancelar"** no modal. Nenhuma alteração será feita e a etiqueta permanecerá intacta.
{% endhint %}


# Vincular Etiqueta a um Contato

Aprenda como associar etiquetas aos seus contatos para organizar e categorizar sua base de forma eficiente, seja pelo CRM ou diretamente durante um atendimento.

Vincular uma etiqueta a um contato permite segmentá-lo e localizá-lo com mais facilidade na plataforma. Você pode fazer isso pelo CRM ou diretamente durante um atendimento. Escolha o caminho que fizer mais sentido para o seu fluxo de trabalho.

{% embed url="<https://drive.google.com/file/d/1Bz0l4n7EJyj_qrEyZzmpu-6ke2eQwuVU/view?usp=sharing>" %}

## Quem pode vincular etiquetas?

| Perfil                 | O que pode fazer                                                   |
| ---------------------- | ------------------------------------------------------------------ |
| **Administrador**      | Criar, editar, excluir e associar ou remover etiquetas de contatos |
| **Atendente**          | Criar novas etiquetas e associar ou remover etiquetas de contatos  |
| **Atendente Restrito** | Apenas associar ou remover etiquetas de contatos                   |

## Opção 1: Vincular pelo CRM

### Acessar o cadastro do contato

1. No menu superior, acesse **CRM > Contatos**.
2. Localize o contato desejado. Use a barra de pesquisa para encontrá-lo com mais facilidade.
3. Clique no contato para abrir o painel **"Dados do contato"**.
4. Na aba **Detalhes**, clique no ícone de edição ao lado de **Etiquetas**.

<figure><img src="/files/HMKW384KGwkHcx1Fyy67" alt=""><figcaption></figcaption></figure>

### Selecionar a etiqueta

O painel de etiquetas será exibido com a lista de etiquetas disponíveis na conta. Marque a caixa ao lado da etiqueta que deseja associar ao contato.

<figure><img src="/files/kpX45X2xWQKR9R8HHP07" alt=""><figcaption></figcaption></figure>

### Salvar

Clique em **"Salvar etiquetas"**. A etiqueta será vinculada ao contato e aparecerá imediatamente no campo Etiquetas do painel de detalhes.

<figure><img src="/files/oqwvEWX69K6UPJtGe2QL" alt=""><figcaption></figcaption></figure>

## Opção 2: Vincular durante um atendimento

{% hint style="info" %}
**Dica:** Essa é a forma mais comum de inserir etiquetas no dia a dia, diretamente durante a conversa com o contato, sem precisar sair da tela de atendimento.
{% endhint %}

### Acessar o atendimento

1. No menu superior, acesse **Atendimentos**.
2. Clique no atendimento do contato desejado.
3. Na tela de conversa, clique no ícone de informações do contato para abrir o painel lateral.

<figure><img src="/files/ZomETabXMkwmwztAUew2" alt=""><figcaption></figcaption></figure>

### Selecionar a etiqueta

1. No painel lateral, acesse a aba **Detalhes**.
2. Clique no ícone de edição ao lado de **Etiquetas**.
3. Selecione a(s) etiqueta(s) que deseja associar ao contato.

<figure><img src="/files/Xg4Da4MsfKp6GKaCGTLy" alt=""><figcaption></figcaption></figure>

### Salvar

Clique em **"Salvar etiquetas"**. A etiqueta ficará vinculada ao contato e será exibida tanto no painel lateral do atendimento quanto na listagem de contatos do CRM.

<figure><img src="/files/qY1oGaY6lGVe0qftOJET" alt=""><figcaption></figcaption></figure>

## Vincular etiquetas durante a importação em massa

Ao importar contatos em massa, é possível vincular etiquetas diretamente no arquivo de importação. Basta incluir todas as etiquetas de um mesmo contato na mesma coluna, separadas por vírgula.


# Cadastrar contato

Cadastre um novo contato manualmente, com nome, telefone e campos adicionais.

O contato é o cadastro de uma pessoa na sua base. É a ele que ficam ligados o histórico de conversas, as etiquetas, a carteira, as sequências e os campos personalizados. Toda vez que uma mensagem chega, a plataforma a associa a um contato.

Nenhum campo do cadastro é obrigatório. Mas dois deles são chave: o **telefone** e o **usuário do Instagram**. Eles não podem se repetir na base, ou seja, não existem dois contatos com o mesmo número nem com o mesmo perfil do Instagram.

É por esses dois campos que a plataforma reconhece um contato. Por isso, importar alguém que já está cadastrado atualiza os dados em vez de criar um segundo registro.

{% hint style="success" %}
**Pré-requisitos:**

* Acesso à conta na **plataforma**.
  {% endhint %}

## Acessar a tela de Contatos

Na tela inicial, acesse o menu **CRM** e clique na opção **Contatos**.

<figure><img src="/files/GV3aRw8uwzWzQhnnHRQq" alt=""><figcaption></figcaption></figure>

## Preencher e salvar o contato

Clique em **+ Novo**, na lateral direita. Um popup abre para o preenchimento dos dados. Preencha as informações do contato, como nome, telefone, e-mail, etiquetas e notas, conforme precisar. Ao terminar, clique em **Salvar**.

<figure><img src="/files/Vv3qrsMIMAALQtDdo8Y1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* Se houver **campos personalizados** cadastrados, eles aparecem na tela de cadastro, permitindo registrar informações específicas da sua operação.
  {% endhint %}

***

## Artigos relacionados

* [Importar Contatos em Lote](/guide/documentacao/crm/contato/importacao-de-contatos)
* [Editar campos personalizados](/guide/documentacao/crm/contato/editar-campos-personalizados)
* [Pesquisar contato](/guide/documentacao/crm/contato/pesquisar-contato)


# Importar Contatos em Lote

Traga contatos de uma planilha, arquivo CSV ou vCard, mapeando as colunas para os campos da plataforma.

A importação traz contatos de outras fontes para a plataforma, incluindo nome, e-mail, telefone, etiquetas e campos personalizados. Para funcionar, cada tipo de dado precisa estar em uma coluna separada no arquivo de origem.

{% hint style="success" %}
**Pré-requisitos:**

* Apenas usuários com perfil de **Administrador** podem importar contatos.
* Os dados devem estar em **planilha Google**, **MS Excel**, **arquivo CSV** (texto separado por ponto e vírgula) ou **arquivo vCard**.
* A fonte deve ter no máximo **5000 linhas** por importação.
* Para atribuir várias etiquetas ao mesmo contato, coloque todas na mesma célula, separadas por vírgula.
  {% endhint %}

## Iniciar a importação

Acesse o menu **CRM** e clique em **Contatos**. Em seguida, clique em **Importar Contatos**.

<figure><img src="/files/RbAYFmGfKcU42loFXkqh" alt=""><figcaption></figcaption></figure>

## Escolher a fonte dos dados

Selecione de onde os contatos vão vir:

* **Copiar/Colar:** a plataforma abre uma planilha no Google Sheets para você colar as informações. Cada dado precisa ficar em uma coluna.
* **Arquivo Excel:** selecione a planilha em formato **.xlsx**.
* **Arquivo CSV:** escolha um arquivo de texto com os dados separados por ponto e vírgula.
* **Arquivo vCard:** indique o arquivo no formato usado para exportar contatos do Gmail ou do iPhone.

<figure><img src="/files/Pe783ta2MAJy3jSu0fbt" alt=""><figcaption></figcaption></figure>

Se optar por **Copiar/Colar**, abre uma nova aba do navegador com a planilha do Google Sheets. Cole ou edite os dados ali, volte à plataforma e clique para iniciar a importação.

A planilha já vem com as colunas **Nome, Telefone, Email, Instagram, Etiquetas, Notas Internas e Carteira**. Você pode remover as que não vai usar ou acrescentar novas, como Data de Nascimento.

Vale manter **Telefone** e **Instagram**. É por esses dois campos que a plataforma reconhece se o contato já existe na conta, e é o que permite atualizar o cadastro em vez de criar um segundo.

Nas outras opções, a plataforma abre uma janela para você selecionar o arquivo.

## Mapear as colunas

Antes de concluir, associe cada coluna da planilha ao campo correspondente na plataforma. Quando os nomes coincidem, a plataforma sugere o destino automaticamente, mas você pode alterá-lo ou escolher **Não Importar** para ignorar aquela coluna.

<figure><img src="/files/IZfxYjGuQYP7YfWPfE5O" alt=""><figcaption></figcaption></figure>

## Resolver conflitos

Se houver números duplicados ou contatos repetidos na planilha, a plataforma avisa e pede uma decisão. Você escolhe qual contato manter, podendo **substituir** os dados existentes, **combinar** as informações ou **ignorar** o dado novo.

<figure><img src="/files/QbBouTSpaJPTRkGmIUh6" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Ao marcar **Arquivar contatos que não existem nesta planilha**, a plataforma arquiva todos os contatos já cadastrados na conta que não estiverem no arquivo.
{% endhint %}

## Informar o código de validação

A plataforma envia um código para o e-mail e o WhatsApp do usuário logado. Digite o código para liberar a importação.

<figure><img src="/files/GROhKWLqojBJRPtezmaO" alt=""><figcaption></figcaption></figure>

## Conferir o resultado

Se a importação concluir com sucesso, feche a janela de confirmação. Se der erro, confira a fonte de dados, corrija os pontos apontados pela plataforma e tente de novo.

<figure><img src="/files/ZsNY3ayjFr2Jw9xsQ7ON" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* Etiquetas que estiverem na planilha e ainda não existirem na plataforma são criadas automaticamente.
* Exclua da planilha as linhas e colunas que não serão importadas, mesmo as vazias.
* Para mais de 5000 contatos, divida a origem em vários arquivos de até 5000 linhas cada.
* A importação não duplica contatos. Se o contato já existir, os dados dele são atualizados.
* As novas etiquetas **substituem** todas as que já estavam associadas ao contato.
* A coluna **Carteira** só aparece se a funcionalidade estiver habilitada.
  {% endhint %}

***

## Artigos relacionados

* [Cadastrar contato](/guide/documentacao/crm/contato/cadastrar-contato)
* [Editar campos personalizados](/guide/documentacao/crm/contato/editar-campos-personalizados)
* [Criar e Editar Etiquetas](/guide/documentacao/crm/contato/gerenciar-etiquetas/inserir-etiqueta)


# Pesquisar contato

Encontre um contato pela barra de busca ou pelos filtros avançados, incluindo arquivados e bloqueados.

{% hint style="success" %}
**Pré-requisitos:**

* Acesso à conta na **plataforma**.
  {% endhint %}

## Acessar a tela de Contatos

Na tela inicial, clique no menu **CRM** e, em seguida, em **Contatos**.

<figure><img src="/files/GV3aRw8uwzWzQhnnHRQq" alt=""><figcaption></figcaption></figure>

## Fazer a busca

Clique na barra de **pesquisa** e busque por **nome**, **e-mail**, **telefone** ou qualquer outra informação cadastrada. Para um recorte mais específico, use os filtros avançados, como etiquetas, origem e carteiras.

<figure><img src="/files/nwDVonlRYINhM0Y4yf53" alt=""><figcaption></figcaption></figure>

## Ver o resultado

A tela seguinte mostra os contatos encontrados, com o **filtro** aplicado visível. Também é possível pesquisar entre os contatos **arquivados** e **bloqueados**.

<figure><img src="/files/Km9B7JW1JXCk3MbjSqV4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* Se houver **campos personalizados** cadastrados, eles também aparecem como opção na pesquisa.
  {% endhint %}

***

## Artigos relacionados

* [Cadastrar contato](/guide/documentacao/crm/contato/cadastrar-contato)
* [Bloquear ou Arquivar contato](/guide/documentacao/crm/contato/bloquear-ou-arquivar-contato)
* [Editar campos personalizados](/guide/documentacao/crm/contato/editar-campos-personalizados)


# Exportar Base de Contatos

Gere um arquivo com os contatos da sua base, em planilha, PDF ou CSV, respeitando o filtro aplicado na tela.

A exportação gera um arquivo com os contatos da sua base, no formato que você escolher. Ela é feita em três etapas: escolher o formato, aguardar o processamento e abrir ou baixar o arquivo pronto.

{% hint style="success" %}
**Pré-requisitos:**

* Perfil de **Administrador**. A exportação é restrita a esse perfil.
  {% endhint %}

## Abrir a exportação

Acesse o menu **CRM** e clique em **Contatos**. No canto superior direito, clique em **Exportar contatos**.

Se você quiser exportar só uma parte da base, **aplique o filtro antes de abrir a janela**. O filtro que estiver ativo na lista é levado para a exportação.

{% hint style="warning" %}
Para usuários que não são Administradores, os botões **Exportar contatos** e **Importar contatos** aparecem desabilitados, com o aviso "Funcionalidade disponível apenas para o administrador".
{% endhint %}

## Conferir o filtro aplicado

Na janela **Exportar dados dos contatos**, o campo **Filtro**, no topo, mostra o que será exportado.

Se estiver escrito **Nenhum filtro aplicado**, a exportação leva a base inteira. Se você tinha um filtro ativo na tela de Contatos, ele aparece ali, como **Etiquetas: ALUNO**, e só os contatos correspondentes entram no arquivo.

Para exportar tudo mesmo tendo chegado com um filtro, clique em **Limpar filtro**, ao lado da indicação.

<figure><img src="/files/I2P5DNg5RX68K9eM75ET" alt=""><figcaption></figcaption></figure>

## Escolher o formato

Selecione um dos quatro formatos disponíveis e clique em **Exportar**. O botão só fica ativo depois que um formato é escolhido.

| Formato                    | O que você recebe no final          |
| -------------------------- | ----------------------------------- |
| **Abrir no Google Sheets** | A planilha abre direto no navegador |
| **Salvar como Excel**      | Um arquivo **.xls** para baixar     |
| **Salvar como PDF**        | Um arquivo **.pdf** para baixar     |
| **Salvar como CSV**        | Um arquivo **.csv** para baixar     |

## Aguardar o processamento

A plataforma monta o arquivo e mostra o andamento em porcentagem. O tempo depende do tamanho da base.

Você pode interromper clicando em **Cancelar** enquanto o processamento não termina.

<figure><img src="/files/vanIfpxGZW62UhqbPp22" alt=""><figcaption></figcaption></figure>

## Abrir ou baixar o arquivo

Ao concluir, a janela mostra **Exportação concluída!** e o botão de acesso ao arquivo, que muda conforme o formato escolhido.

Se você escolheu **Google Sheets**, o botão é **Abrir planilha** e leva à planilha no navegador. Nos outros três formatos, o botão é **Baixar arquivo** e faz o download.

Clique em **Fechar** para sair da janela.

<figure><img src="/files/D4drfqfFWTwvHk08IQkE" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* O filtro que estava aplicado na tela de Contatos é levado para a exportação. Confira o campo **Filtro** antes de exportar, para não gerar um arquivo com mais ou menos contatos do que você precisa.
* A exportação em **Google Sheets** não baixa nada para o seu computador: a planilha fica no navegador.
  {% endhint %}

***

## Artigos relacionados

* [Importar Contatos em Lote](/guide/documentacao/crm/contato/importacao-de-contatos)
* [Pesquisar contato](/guide/documentacao/crm/contato/pesquisar-contato)
* [Cadastrar contato](/guide/documentacao/crm/contato/cadastrar-contato)


# Bloquear ou Arquivar contato

Entenda a diferença entre bloquear e arquivar, e como aplicar cada um pelo CRM ou pela tela de atendimento.

Bloquear e arquivar são ações diferentes. O contato **bloqueado** deixa de ter as mensagens recebidas pela plataforma. O contato **arquivado** sai da listagem principal, mas volta sozinho assim que enviar uma nova mensagem.

{% hint style="success" %}
**Pré-requisitos:**

* Acesso à conta na **plataforma**.
* Apenas usuários com perfil de **Administrador** podem bloquear um contato.
* Qualquer usuário pode arquivar um contato.
  {% endhint %}

## Abrir os dados do contato

Há dois caminhos para chegar aos dados do contato.

### Pelo CRM

Na tela inicial, clique no menu **CRM** e depois em **Contatos**. Pesquise o contato e clique sobre ele. Uma janela com as informações abre na lateral direita.

Para bloquear, clique no ícone ![](/files/hHmZkAvgH0RY1U63ZeV3). Para arquivar, clique no ícone ![](/files/Kgkm49vkRj65CNu45P9o).

<figure><img src="/files/0YzCNzCn6EUMDbZW6Htg" alt=""><figcaption></figcaption></figure>

### Pelo Atendimento

Na tela inicial, acesse o menu **Atendimentos**. Clique no contato para abrir a conversa e, em seguida, no ícone ![](/files/JSP43uXFiF8UEmw4woch). Uma aba com os dados do contato abre na lateral direita.

Para bloquear, clique no ícone ![](/files/hHmZkAvgH0RY1U63ZeV3). Para arquivar, clique no ícone ![](/files/Kgkm49vkRj65CNu45P9o).

<figure><img src="/files/DbQKx39Cp4b0xAggWU6T" alt=""><figcaption></figcaption></figure>

## Confirmar a ação

Nos dois casos a plataforma pede confirmação antes de concluir.

Ao clicar no ícone de arquivar ![](/files/Kgkm49vkRj65CNu45P9o), um popup abre com a mensagem de confirmação. Clique em **Arquivar** e o contato é arquivado na hora.

<figure><img src="/files/tA49HVKxtc836N7pVj5M" alt=""><figcaption></figcaption></figure>

Ao clicar no ícone de bloquear ![](/files/hHmZkAvgH0RY1U63ZeV3), o popup pede a mesma confirmação. Clique em **Bloquear**. A tela passa a mostrar o contato como bloqueado, e o desbloqueio pode ser feito ali mesmo.

<figure><img src="/files/SCF56DV5nkz73WfT7n23" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/RBQUe64wJGAQ8gm3zw7g" alt=""><figcaption></figcaption></figure>

## Ver os contatos arquivados e bloqueados

Na tela inicial, clique em **CRM** e depois em **Contatos**. Ative a chave de **arquivados** ou de **bloqueados** para listar os contatos com esse status.

<figure><img src="/files/2gZUvlMZ6lCLLaFBYOyS" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* Quando um contato é **bloqueado**, as novas mensagens que ele enviar não são recebidas.
* O contato **arquivado** é reativado automaticamente quando enviar uma nova mensagem.
  {% endhint %}

***

## Artigos relacionados

* [Pesquisar contato](/guide/documentacao/crm/contato/pesquisar-contato)
* [Cadastrar contato](/guide/documentacao/crm/contato/cadastrar-contato)


# Editar campos personalizados

Crie campos próprios no cadastro de contato para guardar as informações que a sua operação precisa.

Além dos campos que já vêm na plataforma, você pode criar os seus para guardar informações que só a sua operação usa. Uma vez criado, o campo passa a aparecer no cadastro de todos os contatos.

{% hint style="success" %}
**Pré-requisitos:**

* Ter perfil de **Administrador** para criar novos campos personalizados.
* Algumas funcionalidades dependem do plano contratado.
  {% endhint %}

## Acessar a tela de Contatos

Na tela inicial, clique no menu **CRM** e depois em **Contatos**.

<figure><img src="/files/wBtqtQ3z9L34jF9hPdLs" alt=""><figcaption></figcaption></figure>

## Abrir os campos personalizados de um contato

Selecione um **contato** para abrir a janela com as informações dele. A plataforma já traz campos pré-definidos, como **Nome**, **Telefone**, **E-mail**, **Instagram**, **Etiquetas**, **Carteirização**, **Sequências** e **Notas Internas**. Role até o fim da página e clique em **Adicionar/Alterar Campos Personalizados**.

<figure><img src="/files/mfsMdUlygK6KCm4r8QdR" alt=""><figcaption></figcaption></figure>

## Localizar a opção de novo campo

Uma nova janela abre mostrando os campos disponíveis. Role para baixo até encontrar **Adicionar um novo campo**.

<figure><img src="/files/1XIaXc3PqO3B7wvqKBJo" alt="" width="551"><figcaption></figcaption></figure>

## Criar o campo

Preencha a aba que se abre e escolha o tipo de informação que o campo vai guardar: **Texto curto**, **Texto longo**, **Número inteiro**, **Número decimal**, **Lista de opções** ou **Multiseleção**. Dê um nome ao campo e clique em **Salvar**.

<figure><img src="/files/JeA7L7MUgarNJvwxtqcW" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/MO6EMGpu9kUIZEzrVxTH" alt=""><figcaption></figcaption></figure>

## Editar ou excluir um campo

Clique no ícone ![](/files/FgrgLnBjKdNGBwOHIjdw) ao lado do campo que quer modificar. Faça as alterações na aba que abre e clique em **Salvar**. Nessa mesma tela também é possível excluir o campo.

<figure><img src="/files/mrNS2T9lTe5tPAqNLdZr" alt="" width="554"><figcaption></figcaption></figure>

<figure><img src="/files/9JrRpPKiHiCUc6vxrcHn" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Considerações Adicionais:**

* Criar ou excluir um campo personalizado afeta **todos os contatos** da plataforma, não só aquele que você abriu.
* Use agrupamento para juntar campos do mesmo assunto. Um grupo "Endereço", por exemplo, pode reunir Logradouro, Número, Complemento, Cidade e Estado.
* Não há limite de campos personalizados.
* Evite pedir o número de telefone e guardá-lo num campo personalizado, porque a plataforma já tem a variável **Telefone**.
  {% endhint %}

***

## Artigos relacionados

* [Cadastrar contato](/guide/documentacao/crm/contato/cadastrar-contato)
* [Importar Contatos em Lote](/guide/documentacao/crm/contato/importacao-de-contatos)
* [Pesquisar contato](/guide/documentacao/crm/contato/pesquisar-contato)


# Painéis

O **CRM Painéis** é onde você organiza e acompanha suas negociações e fluxos operacionais. A plataforma oferece dois tipos de painel — **Vendas** e **Gestão** — cada um pensado para um propósito diferente.

O painel de **Vendas** é voltado para acompanhar oportunidades comerciais: tem funil com etapas, controle de ganho e perda, motivos de perda e relatório de desempenho.

O painel de **Gestão** é voltado para operações de pós-venda como suporte, CS e atendimento: tem fluxo com etapas, fase final de encerramento e visão Lista para gerenciar demandas em volume.

Nos dois tipos você pode configurar etapas, criar campos personalizados, adicionar etiquetas, duplicar e excluir painéis, e editar cards diretamente pela visão Lista.

{% content-ref url="/pages/89JptmIZr12X253AXVw2" %}
[Tipos de Painel](/guide/documentacao/crm/paineis/tipos-de-painel)
{% endcontent-ref %}

{% content-ref url="/pages/tm1EhhEEKFeiWCuUVN8i" %}
[Primeiros Passos](/guide/documentacao/crm/paineis/primeiros-passos)
{% endcontent-ref %}

{% content-ref url="/pages/P57v8SuXeVQ0dtI0tx9J" %}
[Vendas](/guide/documentacao/crm/paineis/vendas)
{% endcontent-ref %}

{% content-ref url="/pages/EWS6EEiZatt5GcRnznxj" %}
[Gestão](/guide/documentacao/crm/paineis/gestao)
{% endcontent-ref %}


# Tipos de Painel

Ao criar um novo painel no CRM, você escolhe entre dois tipos: **Vendas** e **Gestão**. Essa escolha define o comportamento do painel, as funcionalidades disponíveis e como a equipe registra os desfechos das negociações.

Por padrão, a opção **Vendas** já vem selecionada.

{% embed url="<https://drive.google.com/file/d/139KgVLYvvSp8w_0Zd5wWnnEvKH1vU9_9/view?usp=sharing>" %}

## Painel do tipo Vendas

Indicado para equipes comerciais que precisam acompanhar o resultado de cada negociação — se foi ganha ou perdida.

**O que esse tipo oferece:**

* Botões **"Marcar como ganho"** e **"Marcar como perda"** em cada card.
* Suporte a **Motivos de Perda** personalizados, obrigatórios ao registrar uma perda.
* Regra automática para **marcar cards como perdidos por inatividade** (padrão: 30 dias).
* **Celebração visual e sonora** ao marcar um card como ganho (habilitada por padrão).
* Cards encerrados (ganhos ou perdidos) **saem da visualização Kanban** e ficam disponíveis apenas no modo Lista.
* **Não há etapa "Fase Final"** — o encerramento é feito pelos botões de ganho/perda.

## Painel do tipo Gestão

Indicado para fluxos de trabalho internos, processos seletivos, onboarding ou qualquer fluxo que não envolva negociações com resultado comercial.

**O que esse tipo oferece:**

* Celebração visual e sonora quando um card chega a uma etapa marcada como **"Final"** no funil (habilitada por padrão).
* A seção **"Marcação de ganho ou perda nos cards"** fica **oculta** — esse tipo de painel não trabalha com esse conceito.

## Comparativo rápido

<table data-search="false"><thead><tr><th>Funcionalidade</th><th>Vendas</th><th>Gestão</th></tr></thead><tbody><tr><td>Botões Ganho / Perda nos cards</td><td>✅ Sim</td><td>❌ Não</td></tr><tr><td>Motivos de Perda</td><td>✅ Sim</td><td>❌ Não</td></tr><tr><td>Perda automática por inatividade</td><td>✅ Sim</td><td>❌ Não</td></tr><tr><td>Celebração ao marcar como ganho</td><td>✅ Sim</td><td>❌ Não</td></tr><tr><td>Celebração ao atingir etapa final</td><td>❌ Não</td><td>✅ Sim</td></tr><tr><td>Etapa do tipo "Fase Final" no Kanban</td><td>❌ Não</td><td>✅ Sim</td></tr><tr><td>Cards encerrados somem do Kanban</td><td>✅ Sim</td><td>❌ Não</td></tr></tbody></table>

## Quando usar cada tipo?

| Situação                                           | Tipo recomendado |
| -------------------------------------------------- | ---------------- |
| Funil de vendas com acompanhamento de resultados   | Vendas           |
| Acompanhamento de contratos com desfecho comercial | Vendas           |
| Processo seletivo ou onboarding de colaboradores   | Gestão           |
| Fluxo de aprovação interna ou tarefas gerenciais   | Gestão           |

***

### Artigos Relacionados

* [Visão geral do painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/configurando-seu-painel)
* [Como criar e configurar um Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
* [Visão geral do painel de Gestão](/guide/documentacao/crm/paineis/gestao/configuracao-inicial/visao-geral-do-painel-de-gestao)
* [Como criar e configurar um Painel de Gestão](/guide/documentacao/crm/paineis/gestao/configuracao-inicial/como-criar-e-configurar-um-painel-de-gestao)


# Primeiros Passos

Guia de início rápido para quem está configurando o CRM Painéis pela primeira vez. Entenda os tipos disponíveis e siga o caminho para criar seu primeiro fluxo.

Se você acabou de acessar o CRM Painéis pela primeira vez, este guia mostra o caminho completo: desde a escolha do tipo de painel até o registro do primeiro card.

## 1. Entenda os Tipos de Painel

Antes de criar o seu painel, escolha o tipo que melhor se encaixa na sua operação:

| Tipo       | Para que serve                                                                       | Exemplos de uso                                        |
| ---------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------ |
| **Vendas** | Acompanhar oportunidades comerciais com controle de Ganho e Perda                    | Pipeline de vendas, prospecção, renovação de contratos |
| **Gestão** | Organizar atendimentos, chamados ou tarefas sem métricas comerciais de Ganho e Perda | Suporte ao cliente, CS, onboarding, tarefas internas   |

Leia [Tipos de Painel](/guide/documentacao/crm/paineis/tipos-de-painel) para ver o comparativo completo entre os dois tipos.

## 2. Crie e Configure o Painel

Após escolher o tipo, crie o painel e dê um nome a ele:

* [Como criar e configurar um Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
* [Como criar e configurar um Painel de Gestão](/guide/documentacao/crm/paineis/gestao/configuracao-inicial/como-criar-e-configurar-um-painel-de-gestao)

## 3. Configure as Etapas do Fluxo

As etapas são as colunas do Kanban — cada uma representa uma fase do seu processo. Configure-as para refletir o fluxo real da sua operação:

* [Como adicionar e reordenar etapas — Vendas](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/como-adicionar-e-reordenar-etapas)
* [Como adicionar e reordenar etapas — Gestão](/guide/documentacao/crm/paineis/gestao/funil-e-etapas/como-adicionar-e-reordenar-etapas)

{% hint style="info" %}
**Dica:** Mantenha entre 4 e 7 etapas. Nomes claros e no mesmo padrão (verbos ou estados) facilitam o uso da equipe — por exemplo, *"Em atendimento"* e *"Aguardando cliente"* são mais intuitivos do que *"Fase 2"*.
{% endhint %}

## 4. Crie o Primeiro Card

Com o painel configurado, crie o primeiro card para começar a registrar negócios ou atendimentos:

* [Como criar um card — Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-um-card)
* [Como criar um card — Gestão](/guide/documentacao/crm/paineis/gestao/configuracao-inicial/como-criar-um-card)

{% hint style="info" %}
Cada **card** representa uma unidade de trabalho no painel: um negócio, um atendimento, um chamado ou uma tarefa. É dentro do card que você registra atividades, anotações e informações do contato — e é ele que avança pelo fluxo conforme o trabalho progride.
{% endhint %}

***

### Próximos Passos

* [Tipos de Painel — comparativo completo](/guide/documentacao/crm/paineis/tipos-de-painel)
* [O que é o funil de vendas no CRM](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/o-que-e-o-funil-de-vendas-no-crm)
* [O que é o funil no painel de Gestão](/guide/documentacao/crm/paineis/gestao/funil-e-etapas/o-que-e-o-funil-no-painel-de-gestao)


# Vendas

Visão geral do módulo, benefícios, quando usar e índice de todos os artigos desta seção.

O CRM de Vendas é o módulo de gestão de negociações da plataforma. Com ele, você acompanha cada oportunidade desde o primeiro contato até o fechamento — de forma visual, organizada e adaptada ao seu processo comercial.

## **O que é?**

Um painel no formato Kanban onde cada coluna representa uma etapa do seu processo de vendas (ex: Prospecção → Proposta → Negociação → Fechado). Cada card dentro das colunas é um negócio em andamento.

## **Principais benefícios**

* Visibilidade completa do pipeline de vendas em tempo real
* Histórico de interações e atividades por negócio
* Relatórios de conversão por etapa e por vendedor
* Flexibilidade para adaptar o funil ao seu processo

## **Quando usar?**

Use o CRM de Vendas quando quiser:

* Gerenciar oportunidades comerciais com etapas claras
* Acompanhar o progresso de cada negociação individualmente
* Registrar motivos de perda e identificar gargalos no processo
* Gerar relatórios de desempenho da equipe de vendas

***

## Índice de artigos

### Configuração inicial

* [Visão geral do painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/configurando-seu-painel)
* [Como criar e configurar um Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
* [Como criar um card no CRM de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-um-card)
* [Como migrar um Painel de Gestão para Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-migrar-um-painel-de-gestao-para-vendas)
* [Duplicação de Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/duplicacao-de-painel)
* [Como excluir e restaurar um painel no CRM](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-excluir-e-restaurar-um-painel-no-crm)

### Funil e etapas

* [O que é o funil de vendas no CRM](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/o-que-e-o-funil-de-vendas-no-crm)
* [Como adicionar e reordenar etapas](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/como-adicionar-e-reordenar-etapas)
* [Como excluir uma etapa do painel no CRM](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/exclusao-de-etapas)

### Motivos de perda

* [Como gerenciar motivos de perda](/guide/documentacao/crm/paineis/vendas/motivos-de-perda/como-gerenciar-motivos-de-perda)
* [Marcação automática de perda por inatividade](/guide/documentacao/crm/paineis/vendas/motivos-de-perda/marcacao-automatica-de-perda-por-inatividade)

### Finalizando negociações

* [Ciclo de vida dos cards](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/arquivamento-ganho-perda)
* [Arquivamento, Ganho e Perda — entendendo as diferenças](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/arquivamento-ganho-perda)
* [Como marcar um card como Ganho](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/como-marcar-como-ganho)
* [Como marcar um card como Perda](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/como-marcar-como-perda)
* [Como arquivar um card](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/como-arquivar-um-card)
* [Arrastar e soltar para encerrar negociações no Kanban](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/arrastar-soltar-kanban)
* [Alterar a data de fechamento do card](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/data-de-conclusao-do-card)

### Visão Lista

* [Visão Lista no CRM de Vendas](/guide/documentacao/crm/paineis/vendas/visualizacoes/visao-lista)
* [Como filtrar e pesquisar cards](/guide/documentacao/crm/paineis/vendas/visualizacoes/como-filtrar-e-pesquisar-cards)
* [Editar e ordenar cards na visão Lista](/guide/documentacao/crm/paineis/vendas/visualizacoes/edicao-e-ordenacao-na-visao-lista)

### Relatórios

* [Entendendo o Relatório de Vendas no CRM](/guide/documentacao/crm/paineis/vendas/entendendo-o-relatorio-de-vendas-no-crm)


# Novo Painel

Configure seu painel de Vendas do zero, ajuste a estrutura conforme sua operação cresce e gerencie o ciclo de vida do painel — da criação à exclusão.

{% content-ref url="/pages/89JptmIZr12X253AXVw2" %}
[Tipos de Painel](/guide/documentacao/crm/paineis/tipos-de-painel)
{% endcontent-ref %}

{% content-ref url="/pages/blgmLN0LoU83L2T2ZdAL" %}
[Visão Geral](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/configurando-seu-painel)
{% endcontent-ref %}

{% content-ref url="/pages/ypMUUdremvhCLfgvaIDQ" %}
[Configuração](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
{% endcontent-ref %}

{% content-ref url="/pages/DDZ61NTmBGmQ6Jtd0aKS" %}
[Novo card](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-um-card)
{% endcontent-ref %}

{% content-ref url="/pages/IN0l0K4cYtEoMIfro7Lo" %}
[Duplicação](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/duplicacao-de-painel)
{% endcontent-ref %}

{% content-ref url="/pages/Gi7WSsXaKTj4y0kbVVRa" %}
[Migração](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-migrar-um-painel-de-gestao-para-vendas)
{% endcontent-ref %}

{% content-ref url="/pages/tYumwZX2TajJzRMKZ7Lz" %}
[Exclusão de Painel](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-excluir-e-restaurar-um-painel-no-crm)
{% endcontent-ref %}


# Visão Geral

Aprenda como acessar, visualizar e navegar pelo seu painel de CRM de Vendas pela primeira vez.

O painel de CRM de Vendas é onde você acompanha todas as suas negociações em andamento. Ele exibe seus negócios organizados em colunas que representam cada etapa do seu processo comercial — do primeiro contato até o fechamento. Neste artigo você vai aprender como acessar o painel e entender sua estrutura.

{% embed url="<https://drive.google.com/file/d/1jvdvginjVZ4nWjFpMWkl_jry-nahAIKu/view?usp=sharing>" %}

## O que é um card?

No painel de Vendas, cada **card** representa um negócio ou oportunidade comercial. Ele percorre as etapas do funil conforme a negociação avança — e é dentro do card que você registra atividades, anotações e informações do cliente. Ao final, um card pode ser marcado como **Ganho**, **Perda** ou **Arquivado**.

## Por onde começar?

Se é a sua primeira vez no painel, siga este caminho:

1. [Crie e configure o painel](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
2. Configure as etapas do funil — [Como adicionar e reordenar etapas](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/como-adicionar-e-reordenar-etapas)
3. [Crie o primeiro card](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-um-card)

***

## **Passo 1: Acessar o CRM de Vendas**

1. No menu lateral, clique em **CRM**.
2. Selecione a opção **Painéis.**
3. Você verá a lista de painéis disponíveis na sua conta.

<figure><img src="/files/mInK2lFkK2SCObtBhiCc" alt=""><figcaption></figcaption></figure>

## **Passo 2: Abrir um painel**

1. Clique no painel que deseja acessar.
2. O painel será aberto no modo **Kanban**, exibindo as etapas do funil como colunas.
3. Cada card dentro das colunas representa um negócio em andamento.

<figure><img src="/files/8qFnCPBKe0ZyYI2voMud" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Nota:** Se você ainda não tem nenhum painel criado, consulte o artigo [Como criar e configurar um Painel de Vendas.](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
{% endhint %}

## **Passo 3: Entender a estrutura do painel**

O painel é composto por:

* **Colunas:** cada coluna é uma etapa do seu funil (ex: Prospecção, Proposta, Fechamento).
* **Cards:** cada card é um negócio. Você pode clicar nele para ver detalhes, histórico e ações.
* **Barra superior:** onde ficam os filtros, a busca e o botão de configurar o painel.

<figure><img src="/files/FgsvW8x7H3tXjXPldCpw" alt=""><figcaption></figcaption></figure>

### Modos de visualização

O painel de Vendas oferece três modos de visualização, alternáveis na barra superior:

* **Kanban** — visão padrão ao abrir o painel. Exibe os cards organizados em colunas por etapa do funil. Ideal para acompanhar o andamento das negociações em tempo real.
* **Lista** — exibe todos os cards em formato de tabela, incluindo os cards finalizados (Ganho, Perda) e arquivados. Permite filtrar, ordenar e consultar negociações encerradas que não aparecem mais no Kanban.
* **Relatório** — visão analítica com indicadores de desempenho, gráficos e tabelas para apoiar a gestão comercial. **Disponível apenas para Administradores da Conta ou do Painel.**

<figure><img src="/files/Jss3bAkeuS2xPpaWy5N4" alt=""><figcaption></figcaption></figure>

## **Passo 4: Alternar entre painéis**

Caso você tenha mais de um painel de vendas criado:

1. Clique no nome do painel atual, no topo da tela.
2. Um seletor será exibido com os painéis disponíveis.
3. Clique no painel desejado para alternar.

<figure><img src="/files/dVQPbTgfivjXuSgUhZeW" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/lDivvahX1h8SwIJdujtx" alt=""><figcaption></figcaption></figure>

***

## Artigos relacionados

* [Como criar e configurar um Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
* [O que é o funil de vendas no CRM](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/o-que-e-o-funil-de-vendas-no-crm)
* [Como adicionar e reordenar etapas](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/como-adicionar-e-reordenar-etapas)
* [Como criar um card no CRM de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-um-card)

***

***


# Configuração

Passo a passo para criar um painel do tipo Vendas no CRM, configurar etapas do funil, motivos de perda e regras de encerramento automático.

O CRM oferece dois tipos de painel — **Vendas** e **Gestão** — com estruturas e lógicas de encerramento distintas. Este artigo orienta você a criar e configurar um painel do tipo **Vendas**, estruturado para o fluxo comercial da sua empresa com funil de oportunidades, métricas financeiras e controle de ganho e perda.

{% hint style="success" %}
Já tem um painel de Gestão e quer converter para Vendas? É possível fazer isso sem perder os dados já cadastrados. Veja o passo a passo em [Migração](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-migrar-um-painel-de-gestao-para-vendas).
{% endhint %}

## Acesse a Criação de Painéis

{% embed url="<https://drive.google.com/file/d/18lb06nKYzX38v2cvQPEwy9apr3V5QrB5/view?usp=sharing>" %}

No menu principal, acesse **CRM → Painéis** e clique em **+ Novo Painel**.

<figure><img src="/files/fQSPolveX5JG8ZpYMws0" alt=""><figcaption></figcaption></figure>

## Preencha as Informações Básicas

**Título:** Nome do painel\
Exemplos: *Funil de Vendas Nacional*, *Prospecção Q4*.

**Chave:** Identificador curto gerado automaticamente a partir do título. Pode ser editado manualmente se preferir.

**Descrição:** Opcional. Explique o propósito do painel para orientar sua equipe.

**Quem pode administrar / Quem pode acessar:** Defina quem pode administrar o painel e quem pode acessá-lo.

**Configurações de visualização:** Escolha como os cards serão exibidos para os usuários:

* Todos: todos os usuários veem todos os cards do painel.
* Individual: cada usuário vê apenas os cards em que está responsável. Administradores e supervisores continuam vendo tudo.

<figure><img src="/files/kNwQkNJccgkLzMNXK4HE" alt=""><figcaption></figcaption></figure>

### Selecione o Tipo de Painel

Escolha entre **Vendas** ou **Gestão**. Para acompanhar oportunidades comerciais, mantenha **Vendas** selecionado (padrão).

<figure><img src="/files/JbdLhVrn4YnQTrNJxU17" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**O que muda ao escolher Vendas?**

— Cards marcados como Ganho ou Perda **são ocultados automaticamente** do Kanban.

— Não há etapa **"Fase Final"**. O encerramento acontece via ação manual no card.

— Para ver cards finalizados, basta alternar para a visualização **Lista**.
{% endhint %}

{% hint style="warning" %}
**Atenção:** o tipo de painel **vendas** não pode ser alterado após a criação. **Escolha com cuidado antes de salvar.**
{% endhint %}

### Defina as Etapas do Funil

Crie as colunas do Kanban que representam o seu processo comercial.

1.Clique em **+ Adicionar etapa**.

2.Nomeie a etapa (ex: *Contato realizado*, *Proposta enviada*).

3.Defina o tipo: **Início** (ponto de entrada dos leads) ou **Intermediário** (etapas seguintes).

4.Repita até montar todo o seu fluxo.

{% hint style="info" %}
As etapas também podem ser adicionadas ou editadas depois da criação do painel.
{% endhint %}

<figure><img src="/files/RHsiA5qx74RlrhzzG5jE" alt=""><figcaption></figcaption></figure>

### Configure as Celebrações de Ganho

{% embed url="<https://drive.google.com/file/d/1U05ctuBlM_q06fxqe0cuDOEnzAh-gcIL/view?usp=sharing>" %}

Na seção **Marcação de ganho ou perda nos cards**, ative ou desative conforme preferir:

**Celebrar ao marcar como ganho** — animação visual na tela. *(Ativo por padrão)*

**Comemoração sonora ao marcar como ganho** — som de celebração. *(Ativo por padrão)*

Clique em **Ver celebração aplicada** para ver uma prévia antes de salvar.

<figure><img src="/files/AHYES4CVm6aZcGO72Aki" alt=""><figcaption></figcaption></figure>

### Motivos de Perda

Ao criar um painel de vendas, o sistema já inclui motivos de perda padrão — como *Sem orçamento disponível*, *Escolheu a concorrência* e *Decisão adiada*.

Você pode excluí-los ou criar os seus próprios a qualquer momento, de acordo com a realidade do seu negócio.

<figure><img src="/files/BjQsFH4UHIrvMOtUygjB" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Alguns motivos de perda são aplicados automaticamente pelo sistema em situações específicas:

* **"Card sem movimentação - marcado automaticamente"** — aplicado quando um card fica sem movimentação pelo período configurado.
* **"Finalizado como perda via migração de painel"** — aplicado em cards de etapas finais durante a migração de um painel de Gestão para Vendas. Esses cards não são contabilizados nos indicadores do relatório do novo painel.

Saiba como gerenciar a lista de motivos no artigo [**Como gerenciar motivos de perda no CRM**](/guide/documentacao/crm/paineis/vendas/motivos-de-perda/como-gerenciar-motivos-de-perda)
{% endhint %}

### Defina a Marcação Automática de Perda

Na seção **Marcar como perdido automaticamente**, escolha após quanto tempo sem movimentação um card será fechado como Perda e com o motivo: "Card sem movimentação - marcado automaticamente".

Opções disponíveis: **7, 15, 30, 60 ou 90 dias**, ou **Não marcar automaticamente**.

<figure><img src="/files/vNeTZAdHsOJIIUfsQtwo" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Por padrão, a opção **30 dias** vem pré-selecionada. Ajuste conforme o ciclo comercial da sua empresa.
{% endhint %}

### Salve o Painel

{% embed url="<https://drive.google.com/file/d/1jnu6xeRVSB6YPqRjdrtyWccUgq2YAwuw/view?usp=sharing>" %}

Clique em **Salvar**. Uma janela de confirmação é exibida com a mensagem **"Painel criado com sucesso!"** — clique em **Abrir painel** para acessar o painel recém-criado imediatamente, ou em **Voltar** para permanecer onde estava.

<figure><img src="/files/zTdzVRoypFrR7Map7tyk" alt=""><figcaption></figcaption></figure>

***

## Artigos relacionados

* [Visão geral do painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/configurando-seu-painel)
* [O que é o funil de vendas no CRM](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/o-que-e-o-funil-de-vendas-no-crm)
* [Como adicionar e reordenar etapas](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/como-adicionar-e-reordenar-etapas)
* [Como criar um card no CRM de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-um-card)


# Novo card

Aprenda como criar um novo card de negócio no painel de Vendas e entender os campos disponíveis ao registrar uma nova oportunidade.

Cada **card** representa uma negociação ou oportunidade no seu painel de Vendas. Criar um card é o ponto de entrada de qualquer negócio no funil — a partir dele você acompanha o progresso, registra atividades e encerra a negociação como Ganho ou Perda.

{% embed url="<https://drive.google.com/file/d/1eeZJFgkkiiIatdjQ7Ba42QDwc-fDNwX4/view?usp=sharing>" %}

## Como Criar um Novo Card

**Passo 1:** Dentro do painel de Vendas, certifique-se de estar na visualização **Kanban**.

**Passo 2:** Clique no botão **Novo Item** na parte inferior da etapa.

{% hint style="info" %}
**Nota:** O botão **Novo Item** aparece apenas na etapa configurada como **Início** no seu funil. Se não estiver vendo essa opção, verifique se a etapa inicial do painel está corretamente definida em **Configurações > Etapas** — cada etapa possui um tipo: *Início ou* *Intermediário.*
{% endhint %}

<figure><img src="/files/RdYgwZorweozPTKy0VRB" alt=""><figcaption></figcaption></figure>

**Passo 3:** O formulário **Novo item** será aberto. Preencha as informações do negócio:

* **Título** *(obrigatório)* — nome que identifica o card no funil.
* **Descrição** — contexto ou detalhes sobre a negociação (limite de 8.000 caracteres).
* **Contatos** — contato vinculado a essa negociação.
* **Valor atribuído** — valor estimado ou atribuído ao negócio.

Na barra superior do formulário você também pode adicionar rapidamente: **Vencimento**, **Responsável** e **Etiquetas**.

**Passo 4:** Clique em **Salvar** para confirmar.

<figure><img src="/files/9p8lp59AUwP1Gq0uUrum" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Nota:** Todos os campos, exceto o **Título**, são opcionais no momento da criação. Você pode complementar as informações abrindo o card depois.
{% endhint %}

## O Que Acontece Após Criar

Assim que o card é criado:

* Ele aparece na coluna da etapa de **Início** na visualização Kanban.
* Seu status inicial é **Em andamento**.
* Os botões **Marcar como ganho** e **Marcar como perda** já estão disponíveis no painel do card.
* O card pode ser movido livremente entre as etapas do funil arrastando-o no Kanban.

## Adicionando Mais Informações Depois

Após criar o card, abra-o clicando sobre ele no Kanban para acessar todas as opções disponíveis:

* Editar os campos preenchidos ou adicionar novos
* Registrar anotações e atividades
* Incluir etiquetas para categorização
* Avançar ou retroceder etapas no funil

<figure><img src="/files/Md86r5RX1oymX4VnxYz2" alt=""><figcaption></figcaption></figure>

***

## Artigos relacionados

* [O que é o funil de vendas no CRM](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/o-que-e-o-funil-de-vendas-no-crm)
* [Como marcar um card como Ganho](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/como-marcar-como-ganho)
* [Como marcar um card como Perda](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/como-marcar-como-perda)
* [Como arquivar um card](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/como-arquivar-um-card)
* [Ciclo de vida dos cards](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/arquivamento-ganho-perda)


# Migração

Saiba como converter um painel do tipo Gestão para Vendas sem perder os dados já cadastrados, com mapeamento das etapas finais e opção de reversão por 5 dias.

Se você começou com um painel de Gestão e percebeu que sua operação evoluiu para um modelo comercial com funil de vendas, métricas financeiras e controle de ganho e perda, é possível converter esse painel para o tipo **Vendas** sem perder nenhum dado já cadastrado.

A migração transforma o próprio painel de Gestão em um painel de Vendas. O ID do painel permanece o mesmo, garantindo que todas as automações, Webhooks, APIs e Chatbots vinculados continuem funcionando normalmente. A validação é feita por código OTP e você pode reverter a migração em até **5 dias** caso necessário.

{% hint style="warning" %}
Essa funcionalidade está disponível apenas para usuários com perfil de **Administrador da Conta** ou **Administrador do Painel**.
{% endhint %}

{% embed url="<https://drive.google.com/file/d/17XYdsS0sd3uM9qZ3uQPKGErXjEBJGKOW/view?usp=sharing>" %}

## Passo 1: Acesse a edição do painel

1. No menu principal, acesse **CRM → Painéis**.
2. Localize o painel de Gestão que deseja converter.
3. Clique no ícone de configurações para abrir a tela de edição (**Editar painel**).
4. Na aba **Gestão**, localize o botão **Migrar para vendas**, exibido ao lado do rótulo do tipo do painel.

<figure><img src="/files/YEmaIleXVfLl1frSxgtf" alt=""><figcaption></figcaption></figure>

## Passo 2: Confirme o início da migração

Ao clicar em **Migrar para vendas**, a janela **"Salvar Alterações e Migrar para Vendas"** será exibida com a mensagem:

*"Antes de iniciar a migração, todas as alterações feitas neste painel serão salvas automaticamente."*

{% hint style="warning" %}
**Atenção:** Como o ID do painel permanece o mesmo após a migração, Webhooks, APIs e Chatbots vinculados ao painel continuarão funcionando normalmente, sem necessidade de reconfiguração.
{% endhint %}

* Clique em **Cancelar** para voltar sem iniciar a migração.
* Clique em **Salvar e iniciar migração** para prosseguir.

<figure><img src="/files/wS8dkCxj2KLIPn0MkrZK" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Nota:** Todas as alterações feitas no painel serão salvas automaticamente antes de a migração começar.
{% endhint %}

## Passo 3: Defina o que acontece com as etapas finais

Após confirmar, o sistema abre o modal **"Migrar painel para o tipo Vendas"**. Nele, todas as etapas configuradas como **Etapa Final** no painel de Gestão são listadas, pois elas não existem na estrutura de um painel de Vendas e precisam ser tratadas antes da migração.

Para cada etapa final listada, selecione uma ação no dropdown:

* **Finalizar como Ganho:** todos os cards da etapa serão finalizados como Ganho (venda concluída). Cards já arquivados permanecem arquivados.
* **Finalizar como Perda:** todos os cards da etapa serão finalizados como Perda. O motivo aplicado será **"Via migração"**. Cards já arquivados permanecem arquivados.
* **Manter etapa no painel (Em andamento):** a etapa volta ao Kanban como etapa intermediária. Cards finalizados voltarão a aparecer nos atendimentos.
* **Arquivar cards:** todos os cards da etapa serão arquivados e não aparecerão no Kanban do novo painel.

{% hint style="warning" %}
O botão **Confirmar e migrar** ficará desabilitado enquanto houver etapas sem ação definida. Ele só é habilitado após todas as etapas terem uma ação selecionada.
{% endhint %}

<figure><img src="/files/7KhdkDrpfkRc7VCyfPzl" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/0yhqdzsI00JEEkrEMdwV" alt=""><figcaption></figcaption></figure>

## Passo 4: Valide o acesso com código OTP

Ao clicar em **Confirmar e migrar**, a migração **não começa imediatamente**. O sistema exibe o modal de **Validação de acesso** e envia um código OTP para o e-mail do usuário autenticado.

1. Acesse seu e-mail e copie o código recebido.
2. Insira o código no campo indicado.
3. Confirme para autorizar a migração.

<figure><img src="/files/yRsVXC7KiUyBtLCbJsME" alt=""><figcaption></figcaption></figure>

## Passo 5: Acompanhe a migração em andamento

Após a validação do OTP, a migração é iniciada. Você verá:

* Uma **notificação com barra de progresso percentual** exibida na tela enquanto os dados são processados.
* O badge **"Em migração"** exibido no topo do painel enquanto o processo ocorre.

<figure><img src="/files/uVOFyVVm3cbHYroRCqG3" alt=""><figcaption></figcaption></figure>

## O que acontece após a conclusão?

Quando a migração for concluída:

* O painel passa a funcionar como um painel de **Vendas**, com funil comercial, métricas financeiras e controle de ganho e perda.
* O ID do painel permanece o mesmo, então automações, Webhooks, APIs e Chatbots vinculados continuam funcionando sem necessidade de reconfiguração.
* Por **5 dias** após a migração, o botão **Reverter para Gestão** fica disponível nas configurações do painel, permitindo desfazer a conversão caso necessário.
* A tela de **relatórios** do painel exibe um banner laranja com a mensagem: *"Cards migrados não afetam os relatórios. Apenas novos cards serão considerados."* Esse banner some automaticamente após 30 dias.

<figure><img src="/files/HnBszk7PHNgEY3NbzxrB" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Sobre os dados no relatório:** Cards provenientes da migração não são contabilizados nos indicadores do painel (Ganhos, Perdas, Ticket médio, Taxa de conversão, etc.). Apenas cards criados diretamente no painel após a migração alimentam os relatórios.
{% endhint %}

## Precisa reverter após a conclusão?

{% embed url="<https://drive.google.com/file/d/1Gpj2i_J4PtoBoSqj3qcQgAqpYd4MrYAc/view?usp=sharing>" %}

Caso a migração já tenha sido concluída, você pode reverter o painel para o tipo Gestão em até **5 dias**:

1. Abra o painel de Vendas e clique no ícone de configurações ⚙️ para abrir a tela de edição (**Editar painel**).
2. Localize o botão **Reverter para Gestão**, exibido ao lado do rótulo do tipo do painel com a indicação de quantos dias ainda restam.
3. Clique em **Reverter para Gestão** e confirme no modal exibido clicando em **Sim, reverter**.
4. Insira o código OTP enviado para o seu e-mail para autorizar a reversão.

<figure><img src="/files/w4j4ujj1iJi43odSNamy" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5TusgD4FOktru2pOFty6" alt=""><figcaption></figcaption></figure>

Após confirmar, o processo de reversão é iniciado. Você verá:

* O **toast** "Processo de reversão iniciado." na parte inferior da tela.
* O badge **"Revertendo migração"** exibido no topo do painel enquanto o processo ocorre.
* Uma **notificação com barra de progresso percentual** no painel de notificações, indicando o andamento da reversão.

<figure><img src="/files/qMnsxVcrv3rPzxaN3ckK" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
⚠️ Após 5 dias da migração, a opção de reversão deixa de estar disponível e a conversão para Vendas passa a ser permanente.
{% endhint %}

***

### Artigos relacionados

* [Visão geral do painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/configurando-seu-painel)
* [Como criar e configurar um Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
* [Como gerenciar motivos de perda](/guide/documentacao/crm/paineis/vendas/motivos-de-perda/como-gerenciar-motivos-de-perda)
* [Ciclo de vida](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/arquivamento-ganho-perda)
* [Entendendo o Relatório de Vendas no CRM](/guide/documentacao/crm/paineis/vendas/entendendo-o-relatorio-de-vendas-no-crm)


# Duplicação

Saiba como criar uma cópia da estrutura de um painel existente para agilizar a configuração de novos funis.

A funcionalidade **Duplicar estrutura** cria um novo painel com toda a configuração do painel original — etapas, etiquetas, campos personalizados e, no caso de painéis de Vendas, os motivos de perda. Nenhum card é copiado para o novo painel, apenas a estrutura.

Isso é útil para criar novos funis com configurações já testadas e aprovadas sem precisar configurar tudo do zero.

{% embed url="<https://drive.google.com/file/d/1vxUeewdaiaPG1d_3FGeJfPNBAayDDBXa/view?usp=sharing>" %}

## Como duplicar

**Passo 1:** Acesse **CRM → Painéis** e localize o painel que deseja duplicar.

**Passo 2:** Clique no ícone de configurações ⚙️ para abrir a tela de edição do painel.

**Passo 3:** No rodapé da tela, clique no botão **Duplicar estrutura**.

<figure><img src="/files/8ZiwVTIdJMHQTgPEhDV9" alt=""><figcaption></figcaption></figure>

**Passo 4:** O modal **"Duplicar painel"** será exibido informando o que será copiado para o novo painel. Clique em **Continuar** para confirmar.

<figure><img src="/files/jYV1Iu0rtwTP79xA38PC" alt=""><figcaption></figcaption></figure>

O novo painel é criado imediatamente e aparece na listagem de painéis ativos, pronto para ser configurado e utilizado.

### O que é copiado na duplicação?

O que é copiado depende do **tipo do painel original**:

| Elemento                | Painel de Vendas | Painel de Gestão |
| ----------------------- | ---------------- | ---------------- |
| Fases (etapas do funil) | ✅ Sim            | ✅ Sim            |
| Etiquetas               | ✅ Sim            | ✅ Sim            |
| Campos personalizados   | ✅ Sim            | ✅ Sim            |
| Motivos de Perda        | ✅ Sim            | ❌ Não se aplica  |

{% hint style="info" %}
A duplicação copia apenas a **estrutura** — nenhum card é copiado para o novo painel.
{% endhint %}

### Como funcionam os Motivos de Perda duplicados

Ao duplicar um painel de Vendas, os motivos de perda são copiados como **novos registros independentes**. Eles têm os mesmos nomes dos originais, mas pertencem exclusivamente ao novo painel.

Qualquer alteração feita nos motivos de um painel — adicionar, renomear ou excluir — **não afeta o outro**.

***

## Artigos relacionados

* [Como criar e configurar um Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
* [Como adicionar e reordenar etapas](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/como-adicionar-e-reordenar-etapas)
* [Como excluir e restaurar um painel no CRM](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-excluir-e-restaurar-um-painel-no-crm)


# Exclusão de Painel

Saiba como excluir um painel com segurança, onde encontrá-lo após a exclusão e como restaurá-lo dentro do prazo de 30 dias.

Ao excluir um painel no CRM, ele não é removido permanentemente de imediato. O painel e todos os seus cards ficam disponíveis para restauração por **30 dias** — um prazo de segurança para desfazer exclusões acidentais sem precisar acionar o suporte.

{% hint style="warning" %}
Essa funcionalidade está disponível apenas para usuários com perfil de **Administrador da Conta**, **Super Administrador** ou **Administrador do Painel**. Usuários com outros perfis visualizam o botão de exclusão bloqueado — ao passar o mouse sobre ele, é exibido o tooltip: *"Funcionalidade disponível apenas para administradores"*.
{% endhint %}

{% embed url="<https://drive.google.com/file/d/1Z3cv6lwQFPBVbQWFN9M5-bAi9IP6cD6J/view?usp=sharing>" %}

## Excluir um painel

**Passo 1:** Acesse **CRM → Painéis** e localize o painel que deseja excluir.

**Passo 2:** Clique no ícone de configurações ⚙️ para abrir a tela de edição do painel.

**Passo 3:** No rodapé da tela, clique no botão **Excluir**.

<figure><img src="/files/f7qoqHKPK3fAAcohxTsq" alt=""><figcaption></figcaption></figure>

**Passo 4:** O modal **"Excluir painel"** será aberto com a mensagem:

*"Ao excluir este painel, ele e todos os seus cards serão removidos da plataforma."*

**E um alerta em destaque:**

*"A recuperação poderá ser realizada por administradores em até 30 dias. Após esse período, a exclusão será permanente."*

* Clique em **Cancelar** para voltar sem excluir.
* Clique em **Excluir painel** para prosseguir.

<figure><img src="/files/75OiXaki5czZveIpqxts" alt=""><figcaption></figcaption></figure>

**Passo 5:** Após clicar em **Excluir painel**, a exclusão **não ocorre imediatamente**. O sistema abre o modal de **Validação de acesso**, que envia um código OTP para o e-mail do usuário autenticado.

1. Acesse seu e-mail e copie o código recebido.
2. Insira o código no campo indicado.
3. Confirme para autorizar a exclusão.

<figure><img src="/files/f15ocfSNElfsdU2cKytM" alt=""><figcaption></figcaption></figure>

Após a validação, o painel é removido da listagem ativa e fica disponível apenas na visualização de **painéis excluídos** pelo prazo de 30 dias.

## Visualizar painéis excluídos

{% hint style="warning" %}
O acesso à lista de painéis excluídos é restrito a usuários com perfil de **Administrador da Conta** ou **Super Administrador**. Para outros perfis — incluindo Administradores de Painel — o toggle fica desabilitado. Ao passar o mouse sobre ele, é exibido o tooltip: *"Apenas administradores podem ver painéis excluídos"*.
{% endhint %}

**Passo 1:** Acesse **CRM → Painéis**.

**Passo 2:** Ative o toggle **"Ver painéis excluídos"** no cabeçalho da página.

A listagem muda e passa a exibir **apenas** os painéis excluídos que ainda estão dentro do prazo de 30 dias de recuperação.

<figure><img src="/files/lPEVaLbaDPibG3xO3PcO" alt=""><figcaption></figcaption></figure>

Cada card nessa visualização exibe:

* Uma faixa vermelha clara na base com o tempo restante para recuperação (ex: *"Faltam 24 dias para o fim do prazo de recuperação"*).
* O badge cinza **"Inativo"** ao lado do ícone de configurações.
* O botão de ação rápida **"Reativar painel"**.

{% hint style="info" %}
**Nota:** Você pode usar o campo **Pesquisar por painel** normalmente nessa visualização — apenas painéis excluídos serão retornados nos resultados.
{% endhint %}

### Consultar as configurações de um painel excluído

Ao clicar no ícone de configurações ⚙️ de um painel excluído, a tela de edição é aberta em **modo leitura**. Todos os campos — título, descrição, responsáveis, etapas e regras de ganho/perda — ficam bloqueados para edição.

O botão **Salvar** não é exibido. Em seu lugar, aparece o botão **"Reativar painel"** no canto inferior direito.

<figure><img src="/files/YiPVWxaTvZ6qsPwF2iPZ" alt=""><figcaption></figcaption></figure>

## Restaurar um painel excluído

Há dois caminhos para restaurar um painel dentro do prazo de 30 dias:

**Pelo atalho no card:**

1. Ative o toggle **"Ver painéis excluídos"**.
2. Localize o painel desejado e clique em **Reativar painel**.

**Pelas configurações do painel:**

1. Clique no ícone ⚙️ do painel excluído.
2. Na tela em modo leitura, clique em **Reativar painel** no rodapé.

Em ambos os casos, o modal de confirmação **"Reativar painel"** será exibido com a mensagem:

*"Ao reativar, o painel e seus cards voltarão a ser exibidos na plataforma, mantendo todas as informações já salvas. Deseja reativar este painel?"*

* Clique em **Cancelar** para voltar.
* Clique em **Reativar painel** para confirmar.

<figure><img src="/files/vJ7kYfXBKr5IR0NAAsfd" alt=""><figcaption></figcaption></figure>

Após a confirmação, o painel desaparece da lista de excluídos e volta imediatamente para a listagem principal, com todas as informações e cards intactos e a tela de edição totalmente funcional.

## O que acontece após os 30 dias?

Após o prazo de recuperação, o painel deixa de aparecer na visualização de painéis excluídos e **não pode mais ser restaurado pela interface**.

{% hint style="warning" %}
**Atenção:** Após 30 dias, a recuperação do painel não é mais possível pelo painel de administração. Não deixe o prazo vencer se precisar restaurar o painel.
{% endhint %}

***

## Artigos relacionados

* [Duplicação de Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/duplicacao-de-painel)
* [Como criar e configurar um Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
* [Como excluir uma etapa do painel no CRM](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/exclusao-de-etapas)


# Funil e Etapas

Gerencie as etapas do seu funil comercial com segurança, entendendo o impacto de cada alteração nos cards e nos dados da operação.

{% content-ref url="/pages/5MtDBo1Y1IFWlSLei9me" %}
[Funil de vendas](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/o-que-e-o-funil-de-vendas-no-crm)
{% endcontent-ref %}

{% content-ref url="/pages/q3uP9gfTMLSbOygOhgzF" %}
[Configurar etapas](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/como-adicionar-e-reordenar-etapas)
{% endcontent-ref %}

{% content-ref url="/pages/tk4zVra6Ybzz1bUBN9WW" %}
[Excluir etapa](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/exclusao-de-etapas)
{% endcontent-ref %}


# Funil de vendas

Entenda o conceito de funil de vendas, como ele funciona na plataforma e como estruturá-lo para o seu processo.

O funil de vendas é a representação visual do caminho que um negócio percorre desde o primeiro contato com o cliente até o fechamento. Na plataforma, o funil aparece como as colunas do seu painel de CRM de Vendas — cada coluna é uma etapa.

{% embed url="<https://drive.google.com/file/d/1ZQB9eH9HbHnQbn5BjNAcRDcFxzPeci8L/view>" %}

## **Como funciona o funil no CRM**

Cada painel de vendas tem o seu próprio funil, ou seja, você pode ter processos diferentes para produtos, equipes ou tipos de venda distintos.

* **Etapas:** são as colunas do painel. Representam fases do processo (ex: Prospecção, Qualificação, Proposta, Fechamento).
* **Cards:** são os negócios. Cada card avança pelo funil conforme a negociação progride.
* **Conversão:** ao final, um negócio pode ser marcado como **Ganho** ou **Perdido**.

<figure><img src="/files/GXL0lDAsSy2LwePA0Tc2" alt=""><figcaption></figcaption></figure>

## **Como estruturar bem o seu funil**

Um bom funil reflete o que realmente acontece no seu processo de vendas. Considere:

* **Quantas etapas fazem sentido?** Evite criar etapas demais. O ideal é entre 4 e 7 colunas.
* **Os nomes das etapas são claros?** Use verbos ou estados bem definidos (ex: "Proposta enviada", "Aguardando retorno").
* **Existe uma etapa de entrada e uma de saída?** O funil deve ter um ponto claro de início e de finalização.

#### Exemplos de funis comuns

| Processo                  | Etapas sugeridas                                                           |
| ------------------------- | -------------------------------------------------------------------------- |
| Vendas B2B                | Prospecção → Qualificação → Proposta enviada → Negociação → Fechamento     |
| Vendas B2C / Inside Sales | Novo lead → Contato realizado → Proposta → Aguardando retorno → Fechamento |
| Renovação de contratos    | A renovar → Contato feito → Proposta enviada → Aprovado → Renovado         |

{% hint style="info" %}
**Nota:** Você pode **criar funis diferentes para processos diferentes** dentro da mesma conta — por exemplo, um funil de vendas diretas e outro para renovações.
{% endhint %}

***

## Artigos relacionados

* [Como criar e configurar um Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)
* [Como adicionar e reordenar etapas](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/como-adicionar-e-reordenar-etapas)
* [Arquivamento, Ganho e Perda — entendendo as diferenças](/guide/documentacao/crm/paineis/vendas/finalizando-negociacoes/arquivamento-ganho-perda)


# Configurar etapas

Saiba como personalizar as colunas do seu funil de vendas adicionando novas etapas e ajustando a ordem.

As **etapas do funil** são as **colunas do seu painel de CRM de Vendas**. Você pode adicionar novas etapas conforme seu processo evolui e reorganizá-las a qualquer momento sem perder os negócios já cadastrados.

{% embed url="<https://drive.google.com/file/d/1k3sLEBsaQJ5FO54FEdAMydTzOlGydG97/view>" %}

## **Como adicionar uma etapa**

### **Passo 1: Acessar as configurações do funil**

1. Abra o painel de vendas desejado.
2. Clique em **Configurações** (⚙️) no canto superior direito.
3. No menu, selecione **Etapas do funil**.

<figure><img src="/files/5Z4J79I2NU4YD2xEbo0S" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wTQHVSz8fL6Pf6QepoDJ" alt=""><figcaption></figcaption></figure>

### **Passo 2: Criar a nova etapa**

1. Clique em **+ Adicionar etapa**.
2. Digite o nome da etapa (ex: "Follow-up", "Demonstração agendada").
3. **Opcional:** defina uma cor para identificar visualmente a etapa.
4. Clique em **Salvar**.
5. A nova etapa aparecerá como uma coluna no seu painel.

<figure><img src="/files/aq7maqY9boA3vmOQxL6D" alt=""><figcaption></figcaption></figure>

## **Como reordenar etapas**

1. Na lista de etapas (em Configurações > Etapas), clique e segure o ícone de **arrastar** (⠿) ao lado da etapa.
2. Arraste a etapa para a posição desejada.
3. Solte para confirmar a nova ordem.
4. Clique em **Salvar**.

<figure><img src="/files/1eFuyElpfhO8wBQr4wh9" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Reordenar etapas não afeta os negócios já cadastrados — eles permanecem na etapa em que estão, independentemente da nova posição.
{% endhint %}

***

## Artigos relacionados

* [Como excluir uma etapa do painel no CRM](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/exclusao-de-etapas)
* [O que é o funil de vendas no CRM](/guide/documentacao/crm/paineis/vendas/funil-e-etapas/o-que-e-o-funil-de-vendas-no-crm)
* [Como criar e configurar um Painel de Vendas](/guide/documentacao/crm/paineis/vendas/configuracao-inicial/como-criar-e-configurar-um-painel-de-vendas)




---

[Next Page](/llms-full.txt/1)