Automação de gestão de trabalho
Integrar WhatsApp com monday.com
O monday.com é uma plataforma de gestão de trabalho e CRM onde equipes organizam projetos, funis de vendas e processos em quadros com colunas de status. A integração com a ZapZap API conecta esses quadros ao WhatsApp: sempre que um item muda de status, um webhook do monday dispara o envio de uma mensagem pela sua instância de WhatsApp. A ZapZap API é uma API de WhatsApp não oficial baseada em instâncias, que você controla pelo backend com as chaves x-api-key e x-api-secret, sem depender do WhatsApp Business oficial.
Por que conectar
Imagine um funil de vendas no monday.com. Quando um lead avança para o status "Proposta enviada", o cliente recebe no WhatsApp uma mensagem com o resumo da proposta. Quando muda para "Fechado", entra a mensagem de boas-vindas e os próximos passos. O mesmo vale para suporte, onboarding e cobrança: cada mudança de coluna vira uma notificação automática no WhatsApp do contato, sem ninguém copiar e colar mensagem. O time trabalha só no quadro do monday.com e a comunicação acontece sozinha.
Passo a passo
- 1
Crie sua instância e pegue as chaves
Na ZapZap API, crie um número de WhatsApp (R$15 por número ativo/mês, pré-pago, com crédito grátis para testar), leia o QR Code para conectar e anote o instanceId, a x-api-key e a x-api-secret no painel.
- 2
Prepare um endpoint intermediário
O monday.com envia webhook para uma URL, mas não formata a chamada final. Suba um endpoint próprio (backend, n8n ou Make) que receba o webhook do monday e chame a ZapZap API com suas chaves. Esse endpoint traduz a mudança de status em uma mensagem de WhatsApp.
- 3
Ative a integração de Webhooks no quadro
Abra seu quadro no monday.com, clique no botão Integrar (Integrate) no canto superior direito, pesquise por Webhooks no centro de integrações e selecione o app de Webhooks.
- 4
Configure a receita de automação
Escolha a receita 'Quando o status muda, enviar um webhook' (When a status changes, send a webhook). Selecione a coluna de status que dispara o envio e cole a URL do seu endpoint intermediário no campo do webhook.
- 5
Teste mudando o status de um item
Mova um item de teste para o status configurado. O monday.com dispara o webhook, seu endpoint chama a ZapZap API e a mensagem sai pelo WhatsApp. Confira a entrega e ajuste o texto da mensagem no seu endpoint.
Exemplo
// Exemplo ILUSTRATIVO: seu endpoint recebe o webhook do monday.com
// e chama a ZapZap API para enviar a mensagem no WhatsApp.
// Confira endpoints e campos exatos em https://api.zapzapapi.com/llms.txt
const instanceId = "SUA_INSTANCIA";
await fetch(`https://api.zapzapapi.com/api/v1/${instanceId}/send/text`, {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-api-key": process.env.ZAPZAP_API_KEY,
"x-api-secret": process.env.ZAPZAP_API_SECRET
},
body: JSON.stringify({
number: "5511999999999",
text: "Seu item avançou para 'Proposta enviada'. Qualquer dúvida, estou aqui!"
})
});Ilustrativo. Os campos e endpoints exatos estão na documentação.
Perguntas frequentes
Preciso do WhatsApp Business API oficial para usar com o monday.com?
Não. A ZapZap API é uma solução não oficial baseada em instâncias. Você conecta um número lendo o QR Code, como no WhatsApp Web, e integra ao monday.com via webhook. Não há processo de aprovação da Meta nem verificação de templates.
O monday.com consegue chamar a ZapZap API direto, sem intermediário?
O ideal é usar um endpoint intermediário (seu backend, n8n ou Make). O webhook nativo do monday envia um payload próprio, e o intermediário traduz esse payload no formato que a ZapZap API espera, além de guardar suas chaves x-api-key e x-api-secret com segurança em vez de expô-las.
Quanto custa manter essa integração funcionando?
O custo da ZapZap API é R$15 por número de WhatsApp ativo por mês, no modelo pré-pago, com crédito grátis para você testar antes. As automações e o webhook do monday.com fazem parte do seu plano do monday, sem custo adicional pela ZapZap.
Posso disparar mensagens diferentes para cada status?
Sim. Basta criar uma receita de webhook para cada coluna de status no monday.com, ou tratar os diferentes status dentro do seu endpoint intermediário, escolhendo o texto certo para cada etapa do funil antes de chamar a ZapZap API.
A mensagem pode incluir dados do item do monday.com?
Pode. O webhook do monday.com envia informações do item, como nome, número de telefone e valores das colunas. Seu endpoint lê esses campos e monta o texto personalizado que será enviado no corpo da chamada à ZapZap API.
Comece com crédito grátis
Crie sua conta, conecte um número em minutos e teste a API com aquecimento e anti-bloqueio. R$15 por número ativo/mês, pré-pago, sem fidelidade.