Integração CRM
Integrar WhatsApp com Salesforce
A integração entre WhatsApp e Salesforce conecta o CRM da sua operação à ZapZap API, uma API de WhatsApp não oficial baseada em instâncias. Em vez de depender de envio manual, o Salesforce passa a chamar a ZapZap API automaticamente quando um registro muda de estado, disparando mensagens de WhatsApp a partir dos próprios objetos padrão (Lead, Contact, Opportunity) ou de objetos customizados. A comunicação acontece por requisição HTTP autenticada com os cabeçalhos x-api-key e x-api-secret, sobre a base https://api.zapzapapi.com. Cada número ativo custa R$15 por mês em modelo pré-pago, e a conta começa com crédito grátis para você testar o fluxo ponta a ponta antes de escalar.
Por que conectar
O uso mais comum é reagir a eventos do funil comercial. Quando um Lead entra com origem específica, um Flow disparado por registro chama a ZapZap API e envia a mensagem de boas-vindas no WhatsApp do contato em segundos, sem depender do SDR estar online. Quando uma Opportunity muda para o estágio de proposta enviada, uma Outbound Message (ou um HTTP Callout dentro do Flow) aciona um webhook que notifica o cliente e o vendedor pelo WhatsApp. O mesmo padrão cobre lembretes de reunião agendada, cobrança de assinatura de contrato, reengajamento de oportunidades paradas e alertas internos para o time quando um deal de alto valor avança. Assim o Salesforce continua sendo a fonte de verdade, e o WhatsApp vira o canal de execução automática.
Passo a passo
- 1
Crie a instância e pegue as credenciais
No painel da ZapZap API, provisione um número, conecte o WhatsApp lendo o QR Code e copie o instanceId, o x-api-key e o x-api-secret. Esses dados vão autenticar as chamadas vindas do Salesforce.
- 2
Cadastre a Named Credential no Salesforce
Em Setup, busque por Named Credentials (Configuração > Segurança > Credenciais Nomeadas). Crie uma External Credential com os cabeçalhos x-api-key e x-api-secret como Custom Headers e uma Named Credential apontando para https://api.zapzapapi.com. Isso evita expor as chaves dentro do Flow.
- 3
Monte o Record-Triggered Flow
Em Setup > Automação de Processos > Flows, clique em New Flow e escolha Record-Triggered Flow. Selecione o objeto (Lead ou Opportunity), defina o gatilho como A record is created or updated e adicione a condição de entrada, por exemplo Stage igual a Proposta Enviada.
- 4
Adicione a ação de HTTP Callout
Dentro do Flow, adicione um elemento Action do tipo HTTP Callout usando a Named Credential criada. Configure o método POST para o endpoint de envio da ZapZap API e monte o corpo com o número do contato e o texto, referenciando campos do registro como {!$Record.Phone}.
- 5
Ative, teste e monitore
Clique em Activate no Flow, crie ou edite um registro real que atenda à condição e confirme a entrega no WhatsApp. Acompanhe execuções em Setup > Paused and Failed Flow Interviews e ajuste os cabeçalhos ou o mapeamento de campos se algum disparo falhar.
Exemplo
// Exemplo ILUSTRATIVO do corpo enviado pelo HTTP Callout do Salesforce.
// Confirme endpoints e campos exatos em https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text
Headers:
x-api-key: SUA_API_KEY
x-api-secret: SEU_API_SECRET
Content-Type: application/json
Body:
{
"number": "5511999999999",
"text": "Olá! Sua proposta foi enviada. Qualquer dúvida, é só responder por aqui."
}Ilustrativo. Os campos e endpoints exatos estão na documentação.
Perguntas frequentes
Preciso da API oficial do WhatsApp para integrar com o Salesforce?
Não. A ZapZap API é uma API de WhatsApp não oficial baseada em instâncias. Você conecta um número lendo o QR Code e o Salesforce passa a disparar mensagens por requisição HTTP, sem precisar de aprovação de templates ou processo de conta oficial.
Devo usar Flow ou Outbound Message para chamar a ZapZap API?
O Flow com HTTP Callout é o caminho mais direto, porque chama a ZapZap API sem intermediários e é a abordagem recomendada pela Salesforce hoje. A Outbound Message funciona quando você já tem um middleware ou endpoint próprio que recebe o webhook do Salesforce e depois repassa para a ZapZap API. O Process Builder ainda existe em orgs antigas, mas a Salesforce recomenda migrar para Flow.
Quanto custa manter essa integração rodando?
O custo é de R$15 por número ativo por mês, em modelo pré-pago. Você mantém saldo na conta e cada número consome desse saldo. A conta nova recebe crédito grátis, então dá para validar o Flow de disparo no Salesforce antes de investir.
Como o Salesforce autentica na ZapZap API sem expor as chaves no Flow?
Use Named Credentials. Você guarda o x-api-key e o x-api-secret em uma External Credential como cabeçalhos customizados e referencia a Named Credential no HTTP Callout. As chaves ficam protegidas na camada de configuração e não aparecem no desenho do Flow.
Onde encontro os endpoints e campos exatos para montar o corpo da requisição?
Consulte https://api.zapzapapi.com/llms.txt, que é a fonte de verdade da API. O exemplo de código mostrado aqui é ilustrativo. Sempre confirme o caminho do endpoint e os nomes dos campos na documentação antes de publicar o Flow em produção.
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.