Integração do WhatsApp com o seu sistema: o que o InvestCRM conecta

• ✓WhatsApp, API Oficial ou Coexistência: liga o número da empresa pelo Cadastro Incorporado da Meta. Quem configura: você, numa janela da Meta. Plano: todos.
• ✓API REST por chave: cria e atualiza contatos, aplica tags e inscreve em sequências. Quem configura: o seu sistema, com a chave gerada no painel. Plano: Business e Enterprise.
• ✓Webhooks de saída: avisam o seu sistema de mensagens, contatos, automações, funil e conversas. Quem configura: a equipe do InvestCRM, junto com você. Plano: Business e Enterprise.
• ✓API de Conversões da Meta: envia o lead qualificado do funil para a Meta. Quem configura: você, em Conversões da Meta. Plano: Business e Enterprise.
• ✓Google Ads, conversões offline: devolvem ao Google os níveis do funil, até a venda. Quem configura: você, com a tag no site. Plano: Business e Enterprise.
• ✓OpenAI ou Anthropic: o agente de IA usa a chave da sua conta. Quem configura: você, em Agente de IA. Plano: do Start para cima.
• ✓Odonto Invest: liga a agenda da clínica ao agente de IA. Quem configura: você, em conta de saúde liberada pela equipe. Plano: Business e Enterprise.
• ✓Planilhas CSV e XLSX: importam contatos e exportam nome e telefone. Quem configura: você, em Contatos. Plano: importar em todos; exportar do Start para cima.

Conectar um número novo abre uma janela do Facebook: você escolhe o portfólio e a conta do WhatsApp lá, e ela se fecha sozinha ao terminar. Não é preciso criar aplicativo. Quem já tem um app próprio na Meta também pode conectar por credenciais manuais (o ID do número, o ID da conta do WhatsApp Business, um token permanente e a chave secreta do app).

Cada conta do InvestCRM usa um número, para que tags, funis, envios e caixa de entrada nunca se misturem; para outro número, abre-se outra conta.

Modo Coexistência WhatsApp Business

Se o número já está no app WhatsApp Business do celular, o botão da Coexistência mantém o app funcionando e passa a mostrar as conversas também no InvestCRM. Confirmando no celular, vêm os contatos e até 6 meses de conversas individuais (as de grupo não vêm). A Meta só aceita esse pedido nas 24 horas seguintes ao cadastro, e o InvestCRM faz o pedido logo depois de conectar.

• ✓O app perde, neste número, as mensagens temporárias, a visualização única, a localização em tempo real e as listas de transmissão (as que existem ficam só para leitura).
• ✓Os aparelhos vinculados são desconectados; o WhatsApp para Windows e o WearOS não voltam.
• ✓O envio fica limitado a 20 mensagens por segundo.
• ✓O que você digita no celular aparece na Caixa de entrada; nesse modo, o perfil comercial se edita pelo celular.

Mais detalhes em Coexistência: o app e a API no mesmo número e no guia da API Oficial.

Em Integrações (API), nas Configurações, o Administrador e o Proprietário geram as chaves. A chave começa com ic_live_, aparece uma única vez e fica guardada só como hash; dá para revogar quando quiser e a tela mostra o último uso. A documentação de uso fica ali mesmo, no painel, com exemplos prontos para copiar: não há página pública de referência.

• ✓A chave vai no cabeçalho Authorization: Bearer ou x-api-key; a conta vem sempre da chave, nunca do corpo da chamada.
• ✓Até 60 chamadas por minuto por chave; acima disso, a resposta é 429, com Retry-After de 60 segundos.
• ✓O plano é conferido a cada chamada: se a conta sair do Business, a chave para de operar na hora, sem ser apagada, e volta a valer quando o plano voltar.
• ✓O limite de contatos do plano vale aqui também: contato novo além do teto é recusado.
• ✓O mesmo celular com e sem o nono dígito vira um contato só.
• ✓A tag "descadastro" aplicada pela API manda o contato para a blacklist, como em qualquer outra tela.

Com essas três chamadas o seu formulário, o seu ERP ou o seu sistema de cobrança já colocam o contato no WhatsApp: a tag aplicada pela API liga uma automação, que manda o modelo aprovado. Veja as montagens de automação.

Um webhook é um endereço do seu sistema que recebe um aviso a cada evento escolhido. São 18 eventos, em cinco grupos:

• ✓Até 5 endereços por conta, cada um com os eventos que quiser; só endereços públicos com https:// são aceitos.
• ✓Cada aviso leva o cabeçalho X-InvestCRM-Signature, com v1= e o HMAC-SHA256 de "timestamp.corpo" feito com o segredo do endereço. O seu sistema confere a assinatura e recusa aviso com mais de 5 minutos de diferença.
• ✓O segredo (whsec_…) aparece uma vez só. Na troca do segredo, durante 24 horas os avisos levam as duas assinaturas, a nova e a antiga.
• ✓Se o seu sistema não responder em 10 segundos ou der erro, o aviso é repetido depois de 1, 5 e 15 minutos, 1 hora e 6 horas.
• ✓Depois de 20 falhas seguidas, o endereço é desativado e o Proprietário e os Administradores recebem um e-mail.
• ✓Há um evento de teste (ping) para ver na hora a resposta do seu servidor, e o histórico de entregas fica guardado por 30 dias, com reenvio das que falharam.

Nos planos Business e Enterprise, o funil devolve resultado aos anúncios. A Meta recebe pela API de Conversões o evento de lead qualificado (QualifiedLead) de quem veio de um anúncio de clique para o WhatsApp, com clique de até 7 dias. O Google Ads recebe conversões offline em até três níveis: uma tag no site guarda o clique, um código de 6 caracteres vai na mensagem e o Google busca um arquivo CSV uma vez por dia. A Meta recebe só o lead qualificado; a venda vai só para o Google.

O passo a passo está em Conversões Meta e Google.

O Odonto Invest é um sistema de clínica odontológica da mesma empresa do InvestCRM. Ligado, ele traz os pacientes em páginas de 200, depois só as mudanças a cada 15 minutos, cria o agente "Recepção Odonto Invest" e deixa a IA marcar, confirmar e remarcar consultas na agenda da clínica.

• ✓Exige o plano Business, o mesmo recurso da API.
• ✓Uma clínica liga a uma conta só.
• ✓O cartão aparece para conta de saúde, liberada pela equipe do InvestCRM.

Como montar lembretes e retornos com ele: WhatsApp para clínica odontológica.

• ✓Importa CSV (separado por ponto e vírgula, vírgula ou tabulação: o sistema descobre sozinho) ou XLSX. Reconhece colunas como nome, telefone, celular, whatsapp e var1 a var5, e você pode ligar cada coluna a um campo.
• ✓Antes de gravar, uma prévia mostra o que vai acontecer, e dá para aplicar tags na importação.
• ✓Linha com telefone ausente ou inválido volta com o motivo; número da blacklist é pulado; o mesmo celular com e sem o nono dígito não vira dois contatos.
• ✓Há um modelo .xlsx para baixar e o modo "só completar nomes vazios", que traz os nomes sem criar contato.
• ✓O limite de contatos do plano vale para quem a importação cria.
• ✓Exportar gera um .xlsx com nome e telefone, do plano Start para cima, só para Editor, Administrador ou Proprietário, e a ação fica registrada.

• ✓Meta: cada mensagem entregue, pela categoria. Para número do Brasil, marketing custa R$ 0,3217, utilidade R$ 0,0350 e serviço R$ 0,0350 por mensagem, cobrados no cartão da conta do WhatsApp.
• ✓OpenAI ou Anthropic: o uso da IA, na chave da sua conta.
• ✓InvestCRM: a assinatura do plano. API, webhooks e conversões vêm no Business e no Enterprise, sem cobrança por chamada.

O caminho mais comum: o seu sistema aplica uma tag pela API (por exemplo, pedido-pago) e uma automação com o gatilho Tag atribuída ao contato manda o modelo. Três modelos que costumam nascer assim, com a categoria provável:

Pedido confirmado, enviado quando o seu sistema aplica a tag

Nome na Meta: pedido_confirmado · Categoria: Utilidade

Por que esta categoria: Confirma uma compra que a pessoa fez, com os dados do pedido, sem sugerir nada novo. É o caso de gerenciamento de pedidos que a Meta dá como utilidade.

Fatura disponível, vinda do sistema de cobrança

Nome na Meta: fatura_disponivel · Categoria: Utilidade

Por que esta categoria: Aviso sobre a conta de um serviço contratado é alerta de conta, utilidade para a Meta. Qualquer convite para contratar mais tiraria o modelo dessa categoria.

Produto de volta ao estoque

Nome na Meta: voltou_ao_estoque · Categoria: Marketing

Por que esta categoria: Mesmo que a pessoa tenha marcado o produto, avisar que ele voltou serve para vender: a Meta trata recomendação e retargeting como marketing.

Regras de cada categoria: categorias de modelo, na documentação da Meta. Mais textos em Modelos de mensagem.

Um mês de avisos vindos do seu sistema

Total estimado no mês, pago direto à Meta: R$ 188,18. As primeiras 1.000 mensagens de serviço de cada número, todo mês, são grátis. Se os modelos de utilidade desta conta fossem classificados como marketing, o mesmo mês passaria de R$ 188,18 para R$ 618,23. Os volumes são um exemplo para mostrar a conta, não dados de um cliente.

Tabela da Meta em reais para números do Brasil, vigente desde 01/10/2026, conferida em 09/10/2026. Ver a tabela na Meta · Faça a sua conta na calculadora

Integração faz dado pessoal sair de um sistema e entrar em outro. A LGPD põe a segurança entre os princípios do tratamento, com medidas técnicas e administrativas contra acesso não autorizado (art. 6º, VII), e diz que o operador trata os dados segundo as instruções do controlador (art. 39). A política do WhatsApp manda usar os dados da conversa só para a própria conversa e não repassar a conversa de um cliente para outro. Fonte: Lei 13.709/2018 · Fonte: política do WhatsApp Business

• ✓Chave de API guardada só como hash, presa a uma conta e com limite por minuto.
• ✓Webhook só para endereço https público, assinado com HMAC-SHA256 e com a hora no aviso, para o seu sistema recusar aviso velho.
• ✓Chave de IA e segredo do webhook guardados criptografados e mostrados uma vez.
• ✓Gerar chaves e mexer em integrações é do Administrador e do Proprietário; exportar a base é do Editor para cima.
• ✓Registros de atividade, do Business para cima, mostram quem fez o quê.

O que o InvestCRM não decide por você: que dados o seu sistema pode receber. Antes de ligar um webhook, confira a base legal e o contrato com quem vai receber os dados.

O número, a caixa de entrada e a importação de planilhas valem em todos os planos, dentro do limite de contatos. A chave de IA atendendo clientes começa no Start. API, webhooks, conversões Meta e Google e Odonto Invest são do Business e do Enterprise, que também mostram os registros de atividade.