Configuração do WhatsApp

WhatsApp é o canal que os membros realmente leem. Taxas de abertura acima de 95% são típicas, e a maior parte da nossa base de usuários relata maior engajamento no WhatsApp do que em e-mail ou SMS. O GCM suporta três formas diferentes de conectar uma conta de WhatsApp, cada uma com trade-offs diferentes.

Esta página cobre a conexão das credenciais do provedor. Para usar o WhatsApp uma vez conectado, veja o guia de mensageria do WhatsApp.

Escolher um provedor

Três opções, com perfis de custo e complexidade muito diferentes:

Provedor	O que é de fato	Configuração	Custo	Ideal para
WACRM (baseado em WAHA)	Sua conta real do WhatsApp, controlada pela API web do WAHA	baixa — escanear um QR	baixo	a maioria das igrejas
WhatsApp Official	A Business API da Meta diretamente	alta	por mensagem após o tier gratuito	alto volume, somente modelos
smsmobileapi WhatsApp	Um relay pelo WhatsApp do seu celular	baixa	incluso com SMS	regiões onde os outros são limitados

TIP

Recomendamos o WACRM para quase todo mundo. Troque para o Official apenas quando precisar genuinamente de mensagens-modelo fora da janela de atendimento ao cliente de 24 horas em escala.

Opção 1 — WACRM (baseado em WAHA)

O WACRM roda o WAHA (a HTTP API do WhatsApp) sobre uma sessão de celular. Você escaneia um QR code de um celular que tem a conta de WhatsApp da sua igreja, e a partir daí o GCM pode enviar e receber nessa conta pela plataforma WAHA.

Vá em Settings → Channels → WhatsApp, escolha WACRM (WAHA) como provedor, e informe:

• API key — emitida pelo WACRM (https://wa.locatecrm.com).
• API base — padrão https://wa.locatecrm.com/v1; só mude se seu revendedor hospedar em outro lugar.
• Default session ID — a sessão WACRM que possui o celular vinculado.
• Webhook secret — opcional, assina webhooks de entrada de volta para o GCM.

Vincule seu celular

Em Settings → WhatsApp devices, clique em Link a device. O WACRM mostra um QR code; abra o WhatsApp no celular da igreja, vá em Aparelhos conectados → Conectar um aparelho, e escaneie. O status muda para working em até dez segundos.

Uma sessão vinculada permanece ativa até você sair pela lista de aparelhos conectados do celular. Monitoramos a saúde da sessão — se o WACRM reportar que a sessão caiu, o canal WhatsApp se desativa automaticamente e enviamos um e-mail para os admins da organização.

Envio em massa

O WACRM tem seu próprio motor de cadência que espalha envios em massa ao longo de horas para evitar as heurísticas anti-spam da Meta. Você pode enviar para 5.000 membros em um clique; o WACRM os enfileira automaticamente e mostraremos o status queued nos logs de mensagens até cada um ser entregue.

Opção 2 — WhatsApp Official (Business API)

Esta é a API em nuvem oficial da Meta. A configuração é significativamente mais envolvida — mas você ganha throughput maior, mensagens-modelo e a legitimidade de um badge de empresa verificada.

Você vai precisar de:

1. Uma conta Meta Business Manager.
2. Uma empresa verificada (passaporte / documentos da empresa).
3. Um número de telefone do WhatsApp Business que não esteja registrado em um WhatsApp pessoal.
4. A Cloud API habilitada no seu app Meta.

Depois no GCM:

• Access token — token de longa duração do Business System User da Meta.
• Phone number ID — o ID numérico que a Meta atribui ao seu número de empresa.
• Business account ID — o WABA ID.
• App secret — usado para verificar assinaturas de webhooks de entrada.
• Default template name / language — usado ao enviar fora da janela de atendimento ao cliente de 24 horas.

A janela de 24 horas

A Meta só permite mensagens de formato livre dentro de 24 horas desde a última mensagem enviada pelo destinatário. Fora dessa janela, você só pode enviar mensagens-modelo pré-aprovadas.

O GCM detecta isso automaticamente: se um membro não te enviou mensagem em 24 horas, voltamos para o modelo que você configurou em default_template_name. Se nenhum modelo estiver configurado, o envio é rejeitado com outside_24h_window. Você verá isso no log de mensagens — não é um bug, é a regra da Meta.

Webhook de entrada

Após salvar as credenciais, copie a URL do webhook que o GCM mostra (/channel-webhook?provider=whatsapp_official) e cole na configuração de Webhooks do seu app Meta. Use o token de verificação que o GCM exibe. Uma vez que a Meta confirma, mensagens de entrada, atualizações de status e confirmações de entrega fluem para o GCM.

Opção 3 — smsmobileapi WhatsApp

Um serviço de relay que usa o WhatsApp do seu próprio celular. Mesma configuração do serviço de SMS deles: uma chave de API alimenta tanto envios de SMS quanto WhatsApp, faturados juntos.

• API key — do seu painel smsmobileapi.

Trade-off: isso é limitado em taxa pelo celular em que você instalou o app deles. Bom para envios abaixo de 1.000 mensagens, doloroso em altos volumes.

Recursos por canal

Uma vez que um provedor está configurado, Settings → Channels → WhatsApp permite ajustar:

• Media support — desligue se seu provedor não suporta imagens / PDFs de saída.
• Max recipients per bulk — padrão 500, pode ser reduzido se quiser batching forçado.
• Merge tokens — habilitar personalização no estilo {{first_name}} em modelos.
• Two-way conversation routing — mensagens de entrada criam conversas para a equipe responder.

Testando a conexão

Em Settings → Channels → WhatsApp, clique em Send test message. Enviamos uma mensagem "Hello from GCM" para o celular principal do admin da organização. Se chegar em <30 segundos, está pronto. Caso contrário, verifique:

1. O log de atividade do provedor (painel WACRM, ferramenta de teste da API da Meta, histórico do smsmobileapi).
2. O celular ainda está ligado, online, e a sessão está working.
3. O destinatário não bloqueou o número remetente.

Quando as credenciais quebram

O modo de falha mais comum: alguém reinicia o celular da igreja e esquece de reconectar. A sessão WAHA cai, os envios começam a falhar. Enviaremos e-mail para os admins após 5 falhas consecutivas — religue o celular em Settings → WhatsApp devices para recuperar.

Referências cruzadas

• Mensageria WhatsApp — como enviar de fato após configurar.
• Conversas — gerenciar respostas de entrada.
• Configuração de SMS — o fallback de texto de menor custo.