A resposta curta: se o número é o da sua empresa e as mensagens contam para o negócio, use a Cloud API oficial. Se é um número de ensaio, que pode perder sem prejuízo, o Baileys serve para experimentar. A diferença não é técnica, é de quem autoriza: na Cloud API quem autoriza é a Meta; no Baileys ninguém autorizou nada.
O que cada um é
O Baileys é uma biblioteca de terceiros que se comporta como o WhatsApp Web: lê um código QR com o telemóvel, fica ligada como um dispositivo associado e passa a enviar e receber mensagens por um programa. A Evolution API usa-a numa das suas integrações. A Cloud API é a interface que a própria Meta oferece a empresas, com conta de programador, app, número, token e webhook.
Lado a lado
|
Baileys |
Cloud API |
| Estatuto |
Não oficial, feito por engenharia inversa. |
Oficial, documentado pela Meta. |
| Arranque |
Ler um QR e está feito. |
Conta de programador, app, número, token e webhook verificado. |
| Bloqueio do número |
É o risco principal. Pode acontecer sem aviso e sem recurso. |
Existe se violar as regras, mas as regras são públicas e há canais da Meta para recorrer. |
| Mensagens de iniciativa sua |
Sem modelos. A Meta não vê a diferença entre automação legítima e abuso, e age pelo comportamento. |
Modelos aprovados fora da janela de 24 horas. |
| Estabilidade |
Pode partir quando o WhatsApp muda. A instância fica em «connecting» até a biblioteca ser actualizada. |
Estável por contrato, com versões documentadas. |
| Quem responde se falhar |
Ninguém. Comunidade e fóruns do projecto. |
A Meta, nos seus canais. |
O que a Meta pede, em termos gerais
| 1 |
Consentimento. Só se escreve a quem aceitou ser contactado. É a regra que mais números queima, com qualquer tecnologia.
|
|
| 2 |
Nada de envio em massa a desconhecidos. Listas compradas, números apanhados em sites e grupos reaproveitados dão denúncias, e as denúncias dão bloqueios.
|
|
| 3 |
Um motivo claro para cada mensagem. Na Cloud API cada modelo tem uma categoria e é revisto antes de usar.
|
|
| 4 |
Ler os termos actuais. As regras da Meta mudam. O que está aqui é um resumo, e o que vale é o texto dela.
|
|
|
Não se prometem recuperações. Um número bloqueado por usar uma ligação não oficial pode não voltar. Se há clientes que o conhecem, a perda é a do número inteiro e do canal com eles. Veja também os riscos e as práticas que os evitam.
|
Como decidir em três perguntas
| 1 |
Pode perder este número? Se não, Cloud API. Se sim, o Baileys serve para provar uma ideia.
|
|
| 2 |
Vai escrever primeiro a alguém? Se sim, precisa de modelos, logo Cloud API.
|
|
| 3 |
Tem quem mantenha o servidor? A Evolution API é sua para actualizar, com qualquer das duas integrações. Se não tem, a Cloud API usada directamente tem menos peças.
|
|
|
Pode começar com o Baileys num número de teste e passar à Cloud API quando o projecto for a sério. Como a Evolution API fala com as duas, o resto da sua automação não tem de mudar. Antes de escolher, compare as opções em WhatsApp normal, Business ou Cloud API.
|
|
Quer pôr a Evolution API num servidor seu para experimentar? Comece pelo VPS.
Ver servidores VPS
|
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
