api não-oficial
API WhatsApp não oficial para o seu SaaS usar o número que o cliente já tem
A API WhatsApp não oficial da D-API conecta o número do seu cliente como um aparelho conectado, sem aprovação da Meta e sem cobrança por mensagem, com infraestrutura gerenciada e 99,9% de uptime em contrato.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Sem tarifa por mensagem
A cobrança é por conexão ativa. O seu cliente pode mandar mil ou cem mil mensagens no mês e o custo da conexão continua o mesmo.
Ativação na hora
O cliente escaneia um QR code ou digita um código de pareamento e o número já está pronto para enviar e receber pela API.
Recursos do aplicativo
Grupos, comunidades, etiquetas, catálogo, canais e ligações de WhatsApp ficam disponíveis pela mesma API key.
Infraestrutura que se recupera sozinha
Uma conexão isolada por número, IP dedicado por conexão e reinício automático quando a conexão cai, 24 horas por dia.
A API WhatsApp não oficial conecta o número do seu cliente do mesmo jeito que o WhatsApp Web: o dono do número escaneia um código, a conta ganha um novo aparelho conectado, e daí em diante o seu SaaS envia e recebe mensagens por HTTP. Não existe cadastro de conta comercial na Meta, fila de aprovação de template nem tarifa por conversa. Para uma plataforma de atendimento ou um CRM, isso significa ativar o WhatsApp de um cliente novo no mesmo dia em que ele assina.
Na D-API, cada número vira uma sessão identificada por um sessionId que você escolhe, e é esse identificador que aparece em todas as rotas e em todos os webhooks.
Como a API WhatsApp não oficial funciona
O caminho do seu cliente até o primeiro envio tem três momentos.
Você cria a sessão pela API, já com a URL do webhook e as opções de recebimento. A D-API sobe uma conexão isolada para aquele número, com proxy de IP dedicado, e começa a gerar o pareamento. O seu produto mostra o QR code para o cliente escanear, ou pede o número de telefone e exibe um código de pareamento de 8 caracteres, útil quando quem conecta está só com o celular na mão.
Quando o pareamento termina, chega o evento connection.status com status: "connected", o número, o nome exibido e o JID da conta. A partir dali, toda mensagem recebida, enviada, entregue ou lida chega ao seu endpoint.
curl -X POST https://api.d-api.cloud/api/v1/sessions \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "crm-acme-vendas",
"type": "unofficial",
"connectionMode": "qr",
"webhookUrl": "https://seu-crm.com/webhooks/whatsapp",
"ignoreGroups": true,
"ignoreStatus": true,
"historySync": false,
"receiveCalls": false
}'
Os quatro booleanos do exemplo estão com os valores padrão. Mensagens de grupo e atualizações de status (os stories) vêm desligadas para não inundar o seu webhook; o histórico do aparelho e o recebimento de ligações são opcionais. Um CRM de vendas costuma manter os grupos desligados. Já uma plataforma de comunidade liga ignoreGroups: false desde o início.
Quando escolher a API não oficial
A decisão é por cliente, e muitos SaaS oferecem as duas. A não oficial costuma ganhar nestes casos.
Volume alto com margem apertada. Um sistema de delivery que confirma cada pedido, avisa a saída do motoboy e pede avaliação manda várias mensagens por cliente final. Sem tarifa por mensagem, o custo do canal é previsível e cabe no plano.
Cliente que não quer trocar de número nem de rotina. A clínica continua atendendo no celular da recepção e o seu sistema trabalha em paralelo, no mesmo número. Nada do histórico se perde.
Recursos do aplicativo. Grupos e comunidades, etiquetas que aparecem no app, catálogo de produtos, canais e ligações de WhatsApp são parte da conexão não oficial.
Ativação sem burocracia. Onboarding de cliente novo em minutos, sem esperar verificação de empresa.
A API Oficial entra quando o cliente precisa de templates aprovados pela Meta ou quer a conta oficial no nome da própria empresa. Na D-API, as duas compartilham POST /api/v1/messages/send/*, então trocar um cliente de tipo não exige reescrever o seu código de envio.
O que vem na conexão não oficial
O escopo é o que uma pessoa faz no aplicativo, exposto como API.
| Área | Exemplos de rotas |
|---|---|
| Mensagens e mídia | /messages/send/text, /image, /video, /audio, /document, /poll, /location |
| Interativas | /interactive/send/list, /carousel, /pix |
| Grupos | /groups/create, /groups/{groupId}/participants, /groups/{groupId}/invite |
| Contatos | /contacts/check, /contacts/{phone}, /contacts/blocklist |
| Etiquetas e catálogo | /labels/upsert, /labels/attach, /catalog/product/create |
| Conversas | /chats/archive, /chats/pin, /chats/read, /chats/messages/search |
| Ligações | /calls/place, /calls/stream, /calls/accept |
As ligações de WhatsApp merecem destaque: fazer e receber chamadas está incluído, sem custo extra, e o áudio pode ir para o navegador por WebRTC ou para o seu backend por WebSocket.
Estabilidade da API não oficial
Quem usa API não oficial já viu conexão cair às três da manhã e só voltar quando alguém reinicia o servidor. A D-API trata isso como problema de infraestrutura, com garantia em contrato: 99,9% de uptime e 4 datacenters no Brasil.
Três escolhas de arquitetura sustentam esse número. Cada número roda isolado, então uma conexão com problema não afeta as outras do mesmo cliente nem as de outros clientes. Cada conexão sai por um proxy com IP dedicado, gerenciado pela D-API. E o self-healing monitora as conexões o tempo todo e reinicia automaticamente a que cair.
Do lado do seu produto, o ciclo de conexão é observável. O connection.status informa connected, disconnected, logged_out (quando alguém remove o aparelho no celular) e qrcode_timeout, que indica uma sessão que ficou 45 minutos gerando QR sem ser escaneada e foi colocada em espera. Nada se perde nesse caso: a próxima consulta ao QR acorda a sessão. Com esses eventos, a sua tela de configurações pode mostrar “conectado”, “precisa reconectar” ou “aguardando leitura” sem polling.
Ajustes por sessão que fazem diferença no SaaS
Algumas configurações existem justamente para quem atende muitos clientes com perfis diferentes.
POST /api/v1/sessions/{sessionId}/assume-br-country-code-settings faz as rotas de envio assumirem +55 para números sem código do país, com validação de DDD. Ajuda quando o seu cliente importa uma planilha com telefones no formato local.
POST /api/v1/sessions/{sessionId}/mark-previous-as-read-settings marca como lidas as mensagens anteriores do contato logo depois de um envio, o que mantém o contador de não lidas do celular coerente com o atendimento feito pelo seu sistema.
POST /api/v1/sessions/{sessionId}/rabbitmq-config configura a entrega dos eventos da sessão numa fila RabbitMQ sua. Para arquiteturas orientadas a eventos, é menos um endpoint HTTP para escalar.
E GET /api/v1/limits/{sessionId} devolve as cotas de mensagens e as restrições que o próprio WhatsApp aplica à conta, um dado útil para exibir ao cliente antes de uma campanha grande.
A lista completa de rotas e parâmetros fica na documentação da D-API.
Quanto custa a API WhatsApp não oficial
A conta é por conexão ativa. Não há cobrança por mensagem enviada ou recebida, nem por ligação. O preço por conexão cai conforme o número de conexões da conta aumenta, o que favorece o SaaS que cresce a base de clientes. As faixas estão na seção de preços da página inicial.
Por onde começar
Crie uma sessão com connectionMode: "qr", abra o QR no navegador com GET /api/v1/sessions/{sessionId}/qr?image=1 e escaneie com o seu próprio celular. Com o connection.status de conectado chegando no seu endpoint, mande um texto para você mesmo e veja o messages.sent voltar. Esse é o esqueleto da integração; o resto é escolher quais recursos o seu produto vai expor para cada cliente. A visão geral de tudo que a plataforma oferece está na página da API de WhatsApp.
Time D-API. Atualizado em .
Perguntas frequentes
O cliente continua usando o WhatsApp no celular?
Sim. A conexão entra como mais um aparelho conectado da conta. O celular segue funcionando, e o que for enviado por ele também chega ao seu sistema pelo evento messages.sent.
Posso ter clientes na API não oficial e na API Oficial ao mesmo tempo?
Pode. As duas conexões usam o mesmo sessionId e a mesma rota de envio, e a D-API cobra o mesmo valor por conexão nos dois tipos.
Preciso de aprovação da Meta para usar a API não oficial?
Não. A conexão é feita pelo próprio dono do número, escaneando o QR code ou digitando o código de pareamento no aplicativo.
As ligações de WhatsApp custam a mais?
Não. Fazer e receber ligações está incluído na conexão da API não oficial, sem custo por chamada.
Funciona com conta pessoal e com WhatsApp Business?
Funciona com as duas. Alguns recursos, como catálogo de produtos, dependem de a conta ser do app WhatsApp Business.