---
title: "Criar CRM com IA: as 3 partes que ela não resolve"
description: "A IA entrega modelo de dados, funil e painel em dias. Ela não entrega canal, entrega de mensagem nem multi-inquilino. O que fazer com cada uma das três partes."
url: "https://api-wa.me/blog/criar-crm-com-ia-o-que-a-ia-nao-resolve"
language: "pt-BR"
og:type: "article"
og:site_name: "WAME API"
---

[Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Como criar um CRM do zero com IA

Raphael Serafim· Publicado em 23 de setembro de 2026· 11 min de leitura

Compartilhar

# Como criar um CRM do zero com IA

A IA entrega modelo de dados, funil e painel em dias. Ela não entrega canal, entrega de mensagem nem multi-inquilino. O que fazer com cada uma das três partes.

Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/criar-crm-com-ia-o-que-a-ia-nao-resolve.md)

Você abre o Cursor, descreve um CRM e em duas horas tem tabela de contatos, estágios de funil, autenticação, uma tela de kanban que arrasta e um gráfico de conversão. Funciona. Você testa, cria três contatos de mentira, move um card e pensa: isso costumava levar um mês.

Costumava mesmo. O que não mudou é o que vem depois — e o que vem depois é a parte pela qual o cliente paga. Um CRM sem canal de mensagem é uma planilha com login. As três partes abaixo são as que a IA não resolve por você, não porque ela seja incapaz de escrever o código, mas porque o obstáculo não é código.

## O que a IA realmente faz bem, e rápido

Vale registrar o que funciona, porque é muita coisa.

Modelagem de dados: descreva o negócio em três parágrafos e você recebe as entidades, os relacionamentos e os índices. Ela erra menos do que a média dos humanos em chave estrangeira esquecida.

CRUD e telas: a parte mais tediosa do trabalho é a que ela faz melhor. Formulário, validação, lista paginada, filtro, ordenação. Um painel decente sai numa tarde.

Regras de funil: "quando o contato ficar sete dias no mesmo estágio, marcar como frio". Isso é lógica pura, sem dependência externa, e ela acerta.

Relatório: agregação, gráfico, exportação para CSV. Também sai rápido.

Se o seu produto termina aí, ele está pronto. O problema é que quase nenhum CRM brasileiro termina aí, porque o cliente não quer registrar conversa — ele quer conversar.

## Parte 1: o canal

Aqui é onde o projeto para, e para de um jeito específico: você pede à IA "agora integra o WhatsApp" e ela escreve, com absoluta confiança, um código que não pode funcionar.

Não é alucinação no sentido usual. É que a instrução não tem código como resposta. Integrar WhatsApp oficialmente envolve:

- Uma conta no Business Manager da Meta, no CNPJ de quem vai usar o número.
- Verificação de negócio, com documento, que pode sair em dias ou levar semanas.
- Um número de telefone que **não pode** estar registrado no app do WhatsApp — se estiver, precisa ser liberado antes.
- Um app na Meta, ou um parceiro que já tenha um.
- Token, webhook com HTTPS público e verificação de assinatura.
- Template aprovado pela Meta para qualquer mensagem enviada fora da janela de 24 horas.

Nada disso é escrito em TypeScript. É formulário, documento e espera. Nenhum modelo de linguagem vai passar pela verificação de negócio no seu lugar, e a maior parte do tempo de um projeto de WhatsApp é justamente esse tempo em que ninguém digita nada. O [levantamento honesto de prazo entre construir e contratar](https://api-wa.me/blog/quanto-tempo-integrar-whatsapp-build-vs-buy) mostra onde as horas vão parar.

### A janela de 24 horas é uma regra de produto, não de código

Essa é a que mais pega quem vem do vibecoding, porque ela não aparece em nenhum tutorial de "enviar mensagem no WhatsApp".

A regra: depois que um cliente escreve para você, você tem 24 horas para responder com o texto que quiser. Passadas as 24 horas, só é possível iniciar a conversa com um **template aprovado** pela Meta — um texto submetido com antecedência, com as variáveis marcadas, que passa por análise.

Isso muda o seu modelo de dados. A sua conversa precisa de um campo dizendo quando a janela fecha, e a sua tela precisa saber bloquear a caixa de digitação quando ela fechar. Se você descobrir isso depois de a tela estar pronta, é retrabalho na camada mais cara. O artigo sobre [criar, aprovar e disparar templates](https://api-wa.me/blog/templates-whatsapp-api-criar-aprovar-enviar) tem o mecanismo inteiro, inclusive o que a Meta recusa e por quê.

### O atalho honesto

Existe uma saída, e ela é a mesma de sempre em software: não construa o que não é o seu produto. Uma API gerenciada de mensagem resolve a parte que não é código — a conexão com a Meta, o número, o token, o formato do webhook — e te devolve um `POST` e um endereço para receber eventos.

É o que a [WAME API](https://api-wa.me/whatsapp-api-para-crm-e-saas) faz: a conexão do número acontece pelo Embedded Signup da Meta, sem você criar app nem virar Tech Provider, e os três canais oficiais — WhatsApp, Instagram Direct e Messenger — vivem na mesma instância, com o mesmo formato de requisição e o mesmo envelope de webhook.

Para quem está escrevendo com IA, o detalhe que mais economiza tempo é outro: a documentação existe em formato de texto para modelo, em [`https://api-wa.me/llms.txt`](https://api-wa.me/llms.txt). Colar esse endereço no contexto do seu editor é a diferença entre o modelo adivinhar um endpoint e o modelo ler qual é.

## Parte 2: a entrega

A segunda parte que a IA não resolve é mais sutil, porque ela escreve o código e o código parece certo.

Peça a ela um endpoint de webhook. Você vai receber algo assim: uma rota `POST`, leitura do corpo, gravação no banco, resposta `200`. Está correto e está incompleto, em quatro pontos que só aparecem com tráfego real.

**Reentrega.** Todo provedor de webhook reenvia quando não recebe `200` rápido o bastante — e às vezes reenvia mesmo tendo recebido. Sem idempotência, o mesmo evento vira duas mensagens na tela e o cliente acha que o sistema está com defeito. A defesa é um índice único no identificador externo da mensagem, e descartar a repetição em silêncio.

**Ordem.** Os eventos não chegam na ordem em que aconteceram. O `read` pode chegar antes do `delivered`. Se o seu código faz `status = evento.status`, o tique duplo azul vira tique cinza sozinho. A defesa é tratar status como uma escada que só sobe.

**Latência.** Se você processa antes de responder `200`, o provedor marca o seu endereço como lento e passa a reentregar mais. A defesa é responder primeiro e processar depois.

**Endereço público.** Em desenvolvimento nada disso aparece, porque `localhost` não recebe webhook. Você precisa de um túnel para testar, e o dia em que trocar o túnel por um domínio é o dia em que tudo para até alguém reapontar a URL.

Esses quatro são o assunto inteiro do artigo sobre [webhook em produção: assinatura, reentrega e idempotência](https://api-wa.me/blog/webhook-producao-assinatura-retry-idempotencia). Leia antes de escrever o seu, não depois.

## Parte 3: o multi-inquilino

A terceira é a que custa mais caro se for descoberta tarde, e a IA quase nunca a antecipa — porque você pediu um CRM, não um SaaS.

Um CRM que você usa sozinho tem uma coleção de contatos. Um CRM que você vende para dez clientes tem uma coleção de contatos com um campo dizendo de quem é cada um, e **toda** consulta do sistema precisa filtrar por esse campo. Toda. Uma que esqueça devolve o contato de um cliente na tela do outro.

O detalhe cruel: esse defeito não quebra nada. Nenhum teste fica vermelho, nenhuma exceção sobe no log. O sistema simplesmente passa a mostrar demais, e você descobre quando um cliente liga.

Três decisões evitam isso, e vale tomá-las antes de ter o primeiro cliente:

1. **O identificador do cliente não viaja por parâmetro.** Ele entra num contexto de requisição, aberto na autenticação, e o repositório lê dali. Esquecer de abrir o contexto derruba a requisição — que é um erro barulhento. Esquecer de passar um parâmetro devolve dado alheio, que é um erro mudo.
2. **O repositório nunca recebe a coleção crua.** Ele recebe um invólucro que injeta o filtro do cliente por último em toda consulta e o crava em toda inserção.
3. **A sala de tempo real também é escopada.** Se você usa WebSocket, uma sala chamada `admins` entrega a mensagem de um cliente na tela do administrador de outro. O nome da sala precisa carregar o identificador da empresa.

Vale um quarto item, que é de processo e não de código: escreva um teste que **lê os arquivos** dos seus repositórios e falha se algum deles usar a coleção crua em vez do invólucro. É a única defesa que funciona aqui, porque o compilador não reclama — a coleção crua tem exatamente os mesmos métodos que a versão segura, e o erro só se manifesta em dado vazado.

## O que delegar e o que não

| Parte do CRM | A IA resolve? | O que sobra para você |
| --- | --- | --- |
| Modelo de dados e migrações | Sim | Revisar índice e chave única |
| CRUD, formulários, listas | Sim | Ajuste de layout |
| Funil, regras de estágio, relatório | Sim | Definir a regra do negócio |
| Autenticação e sessão | Quase | Conferir expiração e revogação |
| Conexão com a Meta | Não | Conta, documento, número, espera |
| Janela de 24h e templates | Parcial | Ela codifica, você decide o produto |
| Webhook resistente a reentrega | Parcial | Idempotência e ordem de status |
| Escopo por cliente | Não | Decisão de arquitetura, antes do código |

A leitura da tabela é simples: a IA é excelente no que está inteiramente dentro do seu repositório e fraca em tudo que depende de um terceiro — porque o terceiro não está no contexto dela.

## Como conferir isso sem acreditar em ninguém

Este artigo afirma que a parte do canal vira um `POST` e um endereço de webhook quando você para de integrar contra a Meta direto. Isso é verificável antes de você escrever qualquer linha, e leva poucos minutos.

**Abra a especificação.** `https://us.api-wa.me/docs/swagger.json` é o OpenAPI da API, público. É ali que está, de forma inequívoca, quais campos existem, quais são obrigatórios e o que o servidor devolve. Uma API que não publica isso é uma API cuja superfície você vai descobrir por tentativa.

**Leia o SDK.** Há cliente de Node/TypeScript e de PHP. O que interessa neles não é a conveniência: é ver o tamanho real do que você vai escrever. Se mandar uma mensagem cabe em cinco linhas, o módulo de canal do seu CRM não é um projeto — é um arquivo.

**Confira o webhook.** Os três canais chegam no mesmo envelope, o da Cloud API da Meta, com um campo `provider` dizendo de qual deles veio. Isso significa um parser, não três, e os eventos disponíveis estão documentados: `messages`, `presence`, `connection`, `qrcode`, `call`, `groups`, `health`.

Nada disso exige conta, cartão ou conversa com vendedor. E vale o hábito geral: antes de escolher qualquer dependência externa para o seu produto, veja se dá para ler a especificação dela sozinho. Se não der, a sua estimativa de prazo é um chute.

## Conclusão

Criar um CRM com IA hoje é honestamente rápido. O modelo de dados, o funil, o painel e o relatório saem em dias, e o resultado é bom.

As três partes que sobram — canal, entrega e multi-inquilino — não sobram por falta de capacidade do modelo. Sobram porque duas delas dependem de um terceiro que não está no seu editor, e a terceira é uma decisão de arquitetura que precisa ser tomada antes de existir código para revisar.

A ordem que economiza retrabalho é esta: decida o escopo por cliente antes de escrever o primeiro repositório, resolva o canal por uma API gerenciada em vez de por integração própria, e escreva o webhook já sabendo que ele vai ser reentregue. O resto pode ser delegado sem medo.

Se o seu plano é vender esse CRM, [o que falta no protótipo para virar produto](https://api-wa.me/blog/de-prototipo-a-produto-vender-o-crm-que-voce-criou) é a continuação natural deste texto. Se ele já vai para um cliente na semana que vem, comece por [o que quebra quando o sistema sai da sua máquina](https://api-wa.me/blog/vibecoding-primeiro-cliente-o-que-quebra).

### Pronto para automatizar seu WhatsApp?

Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.

[Começar grátis](https://portal.api-wa.me/sign-up)

## Perguntas frequentes

Dá para criar um CRM completo só com IA?+

A parte de dentro, sim: dados, telas, funil, relatório e autenticação saem rápido e com qualidade razoável. A parte que depende de terceiros — conta na Meta, número verificado, template aprovado — não é código e não sai de um prompt. Na prática você entrega 80% do sistema em dias e gasta o resto do tempo nos 20% que atravessam a fronteira.

Por que a IA escreve código errado para a API do WhatsApp?+

Porque ela treinou com material de várias épocas e várias abordagens ao mesmo tempo: documentação antiga da Meta, bibliotecas não oficiais e tutoriais de anos diferentes. Sem uma referência atual no contexto, ela mistura tudo e inventa endpoint com aparência plausível. A correção é dar a ela a documentação atual da API que você vai usar, em formato que caiba no contexto.

Quanto tempo leva para plugar o WhatsApp num CRM já pronto?+

Com uma API gerenciada, o primeiro envio costuma funcionar no mesmo dia e o módulo completo leva de uma a duas semanas. Construindo do zero contra a Cloud API, o prazo é dominado pela aprovação da Meta, que não depende de você. O artigo de build vs buy detalha as duas contas.

O que é a janela de 24 horas do WhatsApp?+

É o período em que você pode responder com texto livre depois que o cliente escreveu para você. Fechada a janela, iniciar conversa exige um template previamente aprovado pela Meta. Isso muda o seu modelo de dados: a conversa precisa guardar quando a janela expira, e a sua tela precisa respeitar isso.

Preciso me preocupar com multi-inquilino se tenho um cliente só?+

Precisa, e é mais barato agora. Acrescentar escopo por empresa depois significa revisar toda consulta do sistema, e a que escapar não vai quebrar nada — vai só mostrar dado de um cliente para outro. É o defeito mais caro possível num SaaS e o mais silencioso de todos.

## Continue lendo

[### Fiz meu CRM num fim de semana com IA. Aí chegou o WhatsApp.

Sábado: CRUD, funil e login prontos. Domingo: o WhatsApp. A parede tem nomes — Business Manager, verificação, template, janela de 24 horas — e este é o mapa dela.](https://api-wa.me/blog/crm-em-um-fim-de-semana-e-ai-chegou-o-whatsapp)[### Cursor, Claude Code e Copilot: a integração de WhatsApp certa na 1ª tentativa

O modelo não erra por burrice: erra por falta de contexto. O checklist do que dar ao editor, o que pedir antes do código e os três enganos que ele repete todo dia.](https://api-wa.me/blog/cursor-claude-code-integrar-whatsapp)[### De protótipo a produto: o que falta no CRM que você criou com IA para poder vendê-lo

A lista honesta entre o sistema que funciona para um cliente e o produto que você vende para trinta: multi-inquilino, contrato, auditoria, cobrança e o canal.](https://api-wa.me/blog/de-prototipo-a-produto-vender-o-crm-que-voce-criou)

[Voltar ao blog](https://api-wa.me/blog)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "foundingDate": "2017",
  "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.",
  "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Como criar um CRM do zero com IA",
  "description": "A IA entrega modelo de dados, funil e painel em dias. Ela não entrega canal, entrega de mensagem nem multi-inquilino. O que fazer com cada uma das três partes.",
  "image": "https://api-wa.me/blog/criar-crm-com-ia-o-que-a-ia-nao-resolve/opengraph-image",
  "datePublished": "2026-09-23",
  "dateModified": "2026-09-23",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/blog/criar-crm-com-ia-o-que-a-ia-nao-resolve"
  },
  "keywords": "criar crm com ia, crm do zero com ia, integrar whatsapp no crm, api whatsapp, multi-inquilino saas, janela de 24 horas whatsapp, vibecoding",
  "inLanguage": "pt-BR"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog da API do WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Como criar um CRM do zero com IA",
      "item": "https://api-wa.me/blog/criar-crm-com-ia-o-que-a-ia-nao-resolve"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Dá para criar um CRM completo só com IA?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A parte de dentro, sim: dados, telas, funil, relatório e autenticação saem rápido e com qualidade razoável. A parte que depende de terceiros — conta na Meta, número verificado, template aprovado — não é código e não sai de um prompt. Na prática você entrega 80% do sistema em dias e gasta o resto do tempo nos 20% que atravessam a fronteira."
      }
    },
    {
      "@type": "Question",
      "name": "Por que a IA escreve código errado para a API do WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Porque ela treinou com material de várias épocas e várias abordagens ao mesmo tempo: documentação antiga da Meta, bibliotecas não oficiais e tutoriais de anos diferentes. Sem uma referência atual no contexto, ela mistura tudo e inventa endpoint com aparência plausível. A correção é dar a ela a documentação atual da API que você vai usar, em formato que caiba no contexto."
      }
    },
    {
      "@type": "Question",
      "name": "Quanto tempo leva para plugar o WhatsApp num CRM já pronto?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Com uma API gerenciada, o primeiro envio costuma funcionar no mesmo dia e o módulo completo leva de uma a duas semanas. Construindo do zero contra a Cloud API, o prazo é dominado pela aprovação da Meta, que não depende de você. O artigo de build vs buy detalha as duas contas."
      }
    },
    {
      "@type": "Question",
      "name": "O que é a janela de 24 horas do WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "É o período em que você pode responder com texto livre depois que o cliente escreveu para você. Fechada a janela, iniciar conversa exige um template previamente aprovado pela Meta. Isso muda o seu modelo de dados: a conversa precisa guardar quando a janela expira, e a sua tela precisa respeitar isso."
      }
    },
    {
      "@type": "Question",
      "name": "Preciso me preocupar com multi-inquilino se tenho um cliente só?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Precisa, e é mais barato agora. Acrescentar escopo por empresa depois significa revisar toda consulta do sistema, e a que escapar não vai quebrar nada — vai só mostrar dado de um cliente para outro. É o defeito mais caro possível num SaaS e o mais silencioso de todos."
      }
    }
  ]
}
```