> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cooby.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Conectar o WhatsApp à Cooby: qual opção é a certa para você?

A Cooby sincroniza as conversas de WhatsApp da sua equipe com o seu Cooby Workspace e o seu CRM. Cada membro da equipe pode se conectar de uma de três formas, e membros diferentes podem usar opções diferentes.

## Compare as opções

|  | **API do WhatsApp Business** (recomendada) | **Cloud Sync** | **Extensão do Chrome** |
| Ideal para | Números do aplicativo WhatsApp Business, ou um número novo só para a Cooby | Números pessoais de WhatsApp e conversas em grupo | Equipes que já usam a extensão da Cooby |
| Precisa de um navegador aberto? | Não | Não | Sim, o WhatsApp Web precisa estar aberto |
| Dá para continuar usando o WhatsApp no celular? | Sim | Sim | Sim |
| Mensagens anteriores importadas | Até 6 meses, se você permitir | Até 90 dias | Enquanto a extensão está ativa |
| Conversas em grupo | Ainda não. Adicione o Cloud Sync ou a extensão para os grupos | Sim | Sim |

As mensagens anteriores só são importadas nos planos **Growth** e **Custom**, qualquer que seja a opção que você usa. Nos planos Trial e Starter, a sincronização começa a partir do momento em que você se conecta.

## Qual opção devo escolher?

* **Você usa o aplicativo WhatsApp Business.** Escolha a API do WhatsApp Business. Você pode continuar usando o aplicativo no celular.
* **Você usa um número pessoal de WhatsApp.** Escolha o Cloud Sync.
* **Você precisa sincronizar conversas em grupo.** Escolha o Cloud Sync, sozinho ou junto com a API.
* **Você quer um número novo só para a sua equipe.** Escolha a API do WhatsApp Business e crie um número novo.
* **Sua equipe já usa a extensão da Cooby.** Continue usando, ou adicione o Cloud Sync ou a API quando quiser.

## Como as opções funcionam juntas

* Você pode instalar a extensão da Cooby e vincular o Cloud Sync ao mesmo tempo. Eles não entram em conflito.
* Apenas um deles sincroniza por vez. Quando o WhatsApp Web está aberto com a extensão da Cooby instalada, a extensão sincroniza. Quando não está, o Cloud Sync sincroniza.
* Você pode adicionar a API do WhatsApp Business junto com qualquer um dos dois. A API sincroniza suas conversas individuais, e o Cloud Sync ou a extensão sincroniza suas conversas em grupo.

## Opção 1. API do WhatsApp Business (recomendada)

A API funciona em três situações.

* **Você já usa o aplicativo WhatsApp Business.** Continue conversando no celular normalmente. A Cooby conecta o mesmo número à API, sincroniza as mensagens novas e pode importar até 6 meses de conversas anteriores.
* **Você quer migrar totalmente para a API.** Pare de usar o aplicativo WhatsApp Business e responda todas as conversas pela Cooby.
* **Você ainda não tem um número.** Crie um número novo de API na Cooby. Você não precisa de celular nem de chip.

### Se você já usa o aplicativo WhatsApp Business

Verifique estes dois pontos antes de conectar.

* Atualize o **aplicativo WhatsApp Business** do seu celular para a versão mais recente.
* Confirme que você usa o aplicativo WhatsApp Business, e não o WhatsApp comum. Se você usa o WhatsApp comum, siga o [guia da Meta](https://faq.whatsapp.com/3059780464322392) para mudar. Suas conversas vão junto com você.

### Conectar

1. No seu [Cooby Workspace](https://app.cooby.co/whatsapp-connections), acesse **WhatsApp Connections** e clique em **Connect** em **API**. Você também pode fazer isso na etapa 3 do cadastro inicial.
2. Clique em **Connect my WhatsApp**. Uma janela da Meta será aberta.
3. Faça login com o Facebook e informe o seu número do WhatsApp Business.
4. A Meta mostra um código de pareamento. No celular, toque em **Connect** no aplicativo WhatsApp Business e digite o código.
5. Quando o WhatsApp perguntar se você quer compartilhar o histórico de conversas, permita. Assim a Cooby pode importar até 6 meses de conversas anteriores. Se você pular, apenas as mensagens novas serão sincronizadas. Você pode ativar isso depois pelo celular.
6. Aguarde o fim da importação. As mensagens novas começam a ser sincronizadas na hora.

### Mantenha seu número ativo

Abra o aplicativo WhatsApp Business no celular pelo menos uma vez a cada duas semanas. A Meta desconecta números após cerca de 14 dias sem atividade no celular. Se isso acontecer, a Cooby mostra **Action needed** e você pode reconectar com um toque.

## Opção 2. Cloud Sync

Use o Cloud Sync para números pessoais de WhatsApp, ou para sincronizar conversas em grupo se você já usa a API. O Cloud Sync se vincula ao WhatsApp da mesma forma que o WhatsApp Web. Se você também usa a API, o Cloud Sync sincroniza apenas as suas conversas em grupo.

### Conectar

1. No seu Cooby Workspace, acesse **WhatsApp Connections** e clique em **Connect** em **Cloud Sync**. Durante o cadastro inicial, clique em **Show QR code**.
2. No celular, abra o WhatsApp e acesse **Configurações** > **Dispositivos conectados** > **Conectar um dispositivo**.
3. Escaneie o QR code exibido na Cooby.

A sincronização agora acontece na nuvem. Seu celular não precisa ficar online.

## Opção 3. Extensão do Chrome

Se a sua equipe já usa a extensão da Cooby para Chrome no WhatsApp Web, nada muda. Suas conversas continuam sendo sincronizadas como antes, e os membros aparecem com o selo **Extension Sync** no seu Workspace. Não é preciso migrar nada.

Quer uma sincronização que funcione sem navegador? Vincule o Cloud Sync ou conecte a API quando quiser. O Cloud Sync sincroniza sempre que o WhatsApp Web com a extensão estiver fechado.

## Confira a conexão de cada membro

Acesse **WhatsApp Connections** no seu Cooby Workspace.

* **API Connection** mostra o status da API de cada membro.
* **Extension / Cloud Sync** mostra a outra conexão dele.
* **How Syncing Works** explica em palavras simples, por exemplo "1:1 chats through the API · Groups through Cloud Sync".

## Configure sua equipe

1. **Convide os membros.** Acesse **Settings** > **Members** e clique em **Invite members**.
2. **Cada membro conecta o próprio WhatsApp.** Novos membros verificam o e-mail, informam o nome, conectam o WhatsApp e conectam o CRM. Eles podem pular a etapa do WhatsApp e conectar depois em **WhatsApp Connections**.
3. **Controle quem pode se conectar.** Em **Settings** > **Members**, ative ou desative **WhatsApp Connection Permission** para cada membro. Quando estiver desativado, o membro não consegue se conectar pela API nem pelo Cloud Sync.
4. **Conecte o seu CRM uma única vez.** Conecte o HubSpot ou o Salesforce no cadastro inicial ou no **Integration Center**. As conversas de todos os membros conectados são sincronizadas de acordo com as permissões do seu Workspace.

## Privacidade

Os administradores controlam quem pode ver as conversas de cada membro. A Cooby importa as conversas apenas para que a sua equipe possa vê-las de acordo com essas permissões.

## Solução de problemas

* **A janela da Meta fechou antes de terminar.** Clique em **Try again**. A conexão recomeça do início.
* **Aparece um erro depois das etapas da Meta.** Confira se você usa o aplicativo WhatsApp Business e não o WhatsApp comum, se o aplicativo está atualizado para a versão mais recente e se você não fechou a janela antes da hora.
* **Minha conexão mostra Action needed.** Abra o aplicativo WhatsApp Business no celular. A Meta sinaliza números inativos há cerca de 14 dias.
* **Os botões Connect estão cinza.** Um administrador desativou a sua **WhatsApp Connection Permission**. Peça para ativar de novo.
* **Meu histórico de conversas não foi importado.** O compartilhamento do histórico foi recusado no celular durante a configuração. Você pode permitir depois no aplicativo WhatsApp Business, ou reconectar e permitir quando for solicitado.

Esperamos que isso ajude. Para qualquer dúvida, envie um e-mail para support@cooby.co 💜