WhatsApp

O WhatsApp é o canal que a maioria dos membros realmente lê. Taxas de abertura acima de 95 por cento são típicas. O GCM suporta WhatsApp por vários provedores, incluindo canais via WAHA (WACRM) e a API oficial do WhatsApp Business.

Configurar um provedor

Antes de poder enviar, configure um canal de WhatsApp em Configurações → Canais:

Provedor	Melhor para	Dificuldade de configuração
WACRM (via WAHA)	a maioria das igrejas; usa uma conta WhatsApp pessoal/comercial	baixa
WhatsApp Official	alto volume, mensagens apenas com template	alta (requer verificação de negócios na Meta)
smsmobileapi WhatsApp	regiões onde os outros não estão disponíveis	média

Para via WAHA: escaneie um código QR de um telefone que tenha a conta WhatsApp da sua igreja. A conexão fica ativa até você sair da lista de dispositivos vinculados daquele telefone.

Para Official: configure seu Meta Business Manager, registre um número de telefone e forneça o token de acesso no GCM. Nós te guiamos — escreva para nós se precisar do caminho da API oficial.

Enviar uma mensagem individual

A partir de um perfil de membro:

1. Clique na ação de mensagem.
2. Escolha WhatsApp como canal.
3. Escreva a mensagem. Tokens de mesclagem (ex.: {{member.first_names}}) funcionam aqui.
4. Clique em enviar.

A mensagem chega ao provedor em segundos. O status de entrega vai de Na fila → Enviada → Entregue → Lida nos próximos minutos (assumindo que o destinatário esteja com o WhatsApp aberto).

Enviar uma mensagem em massa

Em Mensageria → Enviar:

1. Escolha destinatários — uma lista salva, um filtro ou números de telefone colados.
2. Escolha WhatsApp como canal.
3. Componha a mensagem.
4. Clique em enviar.

Para envios acima de algumas centenas de destinatários, o endpoint de massa cadencia automaticamente ao longo de dias UTC. Isso evita o erro de limite de taxa 429 burst_gate dos provedores upstream e mantém sua conta em boa situação.

A resposta inclui:

• estimated_completion — quando a última mensagem será enviada.
• spans_days — quantos dias de calendário o envio vai percorrer.

WARNING

Um envio em massa de WhatsApp para 10.000 destinatários pode se estender por 3 dias de calendário. Se você precisa de um disparo no mesmo dia, divida sua audiência e envie a metade urgente primeiro.

Mensagens de template

A API oficial do WhatsApp Business só permite texto livre em uma janela de 24 horas após a última mensagem do destinatário. Fora dessa janela, você deve usar uma mensagem de template pré-aprovada pela Meta.

O GCM suporta templates:

1. Registre o texto do template com a Meta (no seu Business Manager).
2. Em Mensageria → Templates, adicione o ID do template e as variáveis.
3. Ao compor, escolha o template — as variáveis são preenchidas por tokens de mesclagem.

Para canais via WAHA, essa restrição não se aplica — você pode enviar texto livre a qualquer momento.

Lendo o status de entrega

Cada envio aparece em Mensageria → Log (a tabela communication_log). Para cada mensagem:

• Status — Na fila / Enviada / Entregue / Lida / Falhou.
• Código de resposta do provedor — específico do gateway, útil ao depurar.
• Enviada em — carimbo de data/hora.
• Custo (se seu provedor expõe) — custo por mensagem.

Para envios em massa, o log agrupa por lote de envio com contagens agregadas.

Respostas

Quando um membro responde, a mensagem recebida cai em Conversas. O encadeamento da conversa mantém as duas direções em uma única linha do tempo.

TIP

Se o WhatsApp de um membro mostra que ele ainda está "digitando" horas depois de você enviar, o provedor frequentemente ainda não recebeu uma confirmação de leitura. As configurações de privacidade do WhatsApp permitem que o destinatário oculte confirmações de leitura — você ainda veria Entregue mas nunca Lida.

Números de telefone

O WhatsApp usa o mesmo número de telefone do chip SIM. Normalizamos números para E.164 (+876...) antes de enviar. Se o perfil de um membro tem o número em formato local (876-555-1234), o módulo de mensageria vai avisar mas tenta interpretar.

Defina o código de país padrão da sua igreja em Configurações → Organização para que números em formato local sejam convertidos corretamente.

Custos

Os custos dependem do provedor:

• WACRM — assinatura fixa, sem cobrança por mensagem.
• WhatsApp Official — cobranças por conversa da Meta. Barato para as primeiras 1.000 / mês, depois ~$0,005 por mensagem.
• smsmobileapi — por mensagem; confira as taxas atuais deles.

Acompanhe o uso pela página de canais se você está em um provedor por mensagem.

Perguntas comuns

Posso enviar mídia (imagens, PDFs)? Sim para WACRM e Official. O anexo vai em uma linha separada do formulário de composição.

Por que minha mensagem está presa em "Na fila"? O provedor pode estar fora do ar ou limitando a taxa. Confira Configurações → Canais para o status da conexão — um ponto vermelho significa que o provedor está inacessível. Para WACRM, re-escaneie o QR se o telefone ficou offline.

Os destinatários veem o nome da minha igreja ou meu número de telefone? Eles veem a conta WhatsApp que você vinculou. A maioria das igrejas usa um número dedicado rotulado com o nome da igreja, então os destinatários veem a igreja e não uma pessoa.

Próximos passos

• Conversas — fluxo de respostas.
• Canais e cancelamento de inscrição — gerencie provedores e limites de taxa.
• Fluxos de trabalho — automatize acompanhamentos por WhatsApp.