====== Configuração do WhatsApp ======

Para que o Ello ERP possa enviar mensagens pelo WhatsApp, é preciso conectá-lo a um serviço de envio. Este serviço faz a ponte entre o sistema e o WhatsApp.

===== Serviços de envio disponíveis =====

O sistema suporta os seguintes serviços:

^ Serviço ^ Observação ^
| Evolution API | Recomendado. Usado pela maioria dos clientes Ello |
| OmnieChat (Ello Chat) | Integrado ao módulo de chat do Ello |
| Gupshup | Serviço internacional |
| Twilio | Serviço internacional |
| Zenvia | Serviço nacional |
| WhatsGW | Serviço nacional |

> **Importante:** A contratação do serviço de envio é feita diretamente com o fornecedor, separada da licença do Ello ERP.

===== Onde configurar =====

Acesse: **Configurações → Parâmetros → WhatsApp**

Nessa tela, selecione o serviço que será utilizado e preencha os dados de acesso fornecidos pelo serviço contratado.

===== Configuração por usuário =====

É possível configurar um serviço de WhatsApp **por usuário**, diferente do configurado para a empresa. Isso é útil quando cada operador usa um número de WhatsApp próprio.

Quando configurado por usuário, o sistema usa o serviço do usuário para envios manuais (como enviar uma nota fiscal ou relatório). Para envios automáticos (como boletos), o sistema sempre usa a configuração da empresa.

===== Evolution API (configuração mais comum) =====

==== Passo 1: Informar o nome da instância ====

Na aba **Evolution**, informe o nome da instância fornecido pela equipe de implantação.

==== Passo 2: Autenticar com QR Code ====

Clique no botão **Autenticar com QR Code**. Um código QR será exibido na tela.

Abra o WhatsApp no celular da empresa e escaneie o código:
  - No WhatsApp, toque nos três pontos (menu)
  - Escolha **Dispositivos conectados**
  - Toque em **Conectar um dispositivo**
  - Aponte a câmera para o QR Code na tela

Se o código for lido corretamente, o sistema exibirá a mensagem **"Seu WhatsApp foi conectado com Sucesso!"**.

==== Passo 3: Testar o envio ====

Após autenticar, informe um número de celular no campo de teste e clique em **Testar Envio**. Uma mensagem de teste será enviada para esse número.

===== Reconexão =====

Se o WhatsApp for desconectado do serviço (por exemplo, caso o celular da empresa fique sem internet por muito tempo), será necessário repetir o processo de autenticação com o QR Code.

Para saber se o WhatsApp está conectado, basta acessar a tela de configuração e verificar o status exibido.

===== Formato do número de celular =====

Os números de celular dos clientes devem estar cadastrados **com DDD**, por exemplo: **44 99999-1234**.

O sistema adiciona automaticamente o código do país (55) ao enviar a mensagem.

===== Veja também =====

  * [[whatsapp:notificacoes|Notificações automáticas]]
  * [[whatsapp:nfe|Envio de Nota Fiscal por WhatsApp]]
  * [[whatsapp|Voltar ao índice]]