api de whatsapp gerenciada
API de WhatsApp para colocar o WhatsApp dos seus clientes dentro do seu SaaS
Uma API de WhatsApp REST que conecta o número de cada cliente do seu SaaS, envia e recebe mensagens, mídia e ligações, e roda em 4 datacenters no Brasil com 99,9% de uptime garantido 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
Dois tipos de conexão, uma integração
QR code ou código de pareamento na API não-oficial, Cloud API da Meta na oficial. As duas usam o mesmo sessionId e a mesma rota de envio.
99,9% de uptime em contrato
Quatro datacenters no Brasil, uma conexão isolada por número, proxy com IP dedicado e reinício automático quando uma conexão cai.
Cobrança por conexão ativa
Na API não-oficial não existe cobrança por mensagem nem por ligação. O preço por conexão cai conforme a sua base cresce.
Voz, URA e SMS na mesma plataforma
Ligações de WhatsApp incluídas, disparo de voz, URA e SMS ficam na mesma conta, para o seu produto crescer sem trocar de fornecedor.
Uma API de WhatsApp é o que permite ao seu software mandar e receber mensagens pelo número de WhatsApp do seu cliente sem ninguém abrir o celular. O CRM registra a conversa no card do lead, o sistema da clínica confirma a consulta do dia seguinte, a plataforma de delivery avisa que o pedido saiu e o agente de IA responde de madrugada. Para quem constrói SaaS, a API vira mais uma funcionalidade do produto, vendida dentro do plano que o seu cliente já paga.
Esta página reúne o tema inteiro: o que a API de WhatsApp da D-API faz, a diferença entre a conexão não-oficial e a oficial, o que dá para automatizar, como a infraestrutura se mantém de pé e como integrar o primeiro número em poucos minutos.
O que uma API de WhatsApp resolve para um SaaS
O seu cliente já atende pelo WhatsApp. O problema é que esse atendimento vive fora do seu produto, num celular em cima do balcão ou num computador com o WhatsApp Web aberto. Cada conversa que acontece ali é um dado que o seu sistema não vê.
Com a API, o número do cliente passa a ser uma conexão gerenciada pela D-API, e tudo que acontece nela chega ao seu backend por webhook: mensagem recebida, mensagem enviada pelo celular, confirmação de entrega e de leitura, ligação tocando, participante entrando num grupo. No sentido contrário, o seu sistema envia texto, mídia, enquetes, localização e mensagens interativas por chamadas HTTP.
Um exemplo de agenda online mostra o ganho. Antes, a recepcionista copiava o horário do sistema e colava no WhatsApp, um paciente por vez. Com a integração, o sistema envia o lembrete sozinho na véspera, recebe a resposta “confirmo” pelo webhook e atualiza o status da consulta. A recepcionista só entra quando o paciente pede para remarcar.
API de WhatsApp não-oficial e API Oficial
A D-API oferece os dois tipos de conexão no mesmo ecossistema. A escolha é por cliente, então você pode ter clientes de cada tipo no mesmo produto, sem duas integrações.
| API não-oficial | API Oficial (Cloud API) | |
|---|---|---|
| Como conecta | QR code ou código de pareamento, como o WhatsApp Web | Conta WhatsApp Business (WABA) do cliente na Meta |
| Cobrança da D-API | Por conexão ativa | Por conexão ativa, mesmo valor |
| Custo por mensagem | Nenhum | Tarifas da Meta, cobradas pela Meta na WABA do cliente |
| Ligações de WhatsApp | Incluídas, sem custo extra | Não disponíveis pela D-API |
| Templates aprovados pela Meta | Não se aplica | Sim, por POST /api/v1/messages/send/template |
| Envio | POST /api/v1/messages/send/* |
A mesma rota, com o sessionId da conexão oficial |
A API não-oficial é a escolha natural quando o seu cliente quer continuar usando o próprio número e o próprio celular, sem processo de aprovação, e quando o volume de mensagens tornaria a tarifa por conversa pesada. Ela conecta pelo QR code, exatamente como o WhatsApp Web, ou pelo código de pareamento, quando quem conecta está longe do computador.
A API Oficial atende o cliente que precisa de templates aprovados ou quer a conta oficial (WABA) no nome da própria empresa. A D-API atua como provedora, e as tarifas da Meta caem na conta do próprio cliente final, sem intermediação.
O que dá para fazer com a API de WhatsApp
A API cobre o que uma pessoa faz no aplicativo e o que um sistema precisa para automatizar em escala. Os blocos mais usados por SaaS são estes.
Mensagens. Texto com resposta citada, menção e pré-visualização de link, além de enquete, localização, contato, reação e edição de mensagem já enviada. O guia de enviar mensagem pela API mostra os campos e o modo assíncrono com ordem garantida por contato.
Mídia. Imagem, vídeo, áudio como nota de voz, documento com nome de arquivo, figurinha e álbum. A mídia vai por URL pública ou base64, e a que chega é salva em storage com link pronto no webhook. Os detalhes estão em enviar mídia pela API.
Mensagens interativas. Lista, carrossel, botão de Pix e templates. Para quem vende cobrança ou e-commerce, o botão de Pix dentro da conversa encurta o caminho até o pagamento.
Grupos e comunidades. Criar grupo com regras de administração, adicionar e remover participantes, gerar e revogar convite, aprovar pedidos de entrada e acompanhar tudo por eventos. Uma edtech cria a turma, coloca os alunos e fecha o grupo para só o professor escrever. Veja a API de grupos.
Contatos, etiquetas, catálogo e canais. Verificar se um número tem WhatsApp antes de cadastrar, buscar foto e perfil comercial, sincronizar etiquetas com o funil do CRM, manter o catálogo de produtos igual ao estoque e publicar em canais do WhatsApp.
Conversas e histórico. Listar, arquivar, fixar e marcar conversas como lidas, buscar mensagens e sincronizar o histórico do aparelho ao conectar, para o seu cliente não começar com a caixa vazia.
Estabilidade da API de WhatsApp: SLA, datacenters e isolamento
Quando o WhatsApp do seu cliente para, quem recebe a reclamação é o seu suporte. Por isso a estabilidade vem antes de qualquer feature na D-API.
A infraestrutura roda em 4 datacenters no Brasil, com 99,9% de uptime garantido em contrato. Cada número roda numa conexão isolada, então um problema numa conexão não derruba as outras. Cada conexão sai por um proxy com IP dedicado, gerenciado pela D-API. E o self-healing funciona 24 horas: o monitoramento detecta a queda e reinicia a conexão automaticamente, sem esperar alguém abrir chamado.
Hoje são 1.875 conexões na D-API. Do lado da integração, a entrega também foi pensada para falhar bem. Os webhooks têm retentativa com backoff exponencial, e quem prefere consumir eventos de uma fila pode ligar a entrega por RabbitMQ por sessão. Para envios pesados, o modo assíncrono responde na hora com um commandId e entrega o resultado depois, sem segurar o request do seu servidor.
Ligações, URA e SMS no mesmo lugar
Muito SaaS começa pelo WhatsApp e, meses depois, precisa de voz ou de SMS. Na D-API isso já está na mesma plataforma.
As ligações de WhatsApp pela API estão incluídas na conexão não-oficial, sem custo por chamada. O seu produto faz e recebe chamadas no número do cliente e leva o áudio para o navegador por WebRTC ou para o backend por WebSocket, onde um agente de voz com IA pode conversar com quem ligou. Para uma clínica, isso significa o botão “ligar para o paciente” dentro da agenda.
Fora do WhatsApp, a URA e o disparo de voz em massa ficam em POST /api/v1/voice/call e POST /api/v1/voice/bulk, e o SMS em POST /api/v1/sms/send e POST /api/v1/sms/bulk. Um software de cobrança, por exemplo, manda a mensagem no WhatsApp, usa o SMS para quem não tem o app e liga com mensagem gravada para a fatura vencida. Há também um builder visual de automação que junta os canais com Meta Lead Ads, anúncios de clique para WhatsApp, formulários e chamadas HTTP.
Como integrar a API de WhatsApp em quatro passos
A API é REST, autenticada pelo header Authorization com a sua API key, e a base é https://api.d-api.cloud. O fluxo mínimo tem quatro passos.
1. Crie a sessão. Uma sessão representa um número. O sessionId é escolhido por você e aparece em todos os webhooks.
curl -X POST https://api.d-api.cloud/api/v1/sessions \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "clinica-sorriso-recepcao",
"type": "unofficial",
"webhookUrl": "https://seu-saas.com/webhooks/whatsapp"
}'
2. Conecte o número. Busque o QR em GET /api/v1/sessions/{sessionId}/qr e mostre na tela do seu produto, ou receba cada QR novo pelo evento connection.qrcode. Quando o cliente escaneia, chega connection.status com status: "connected".
3. Envie a primeira mensagem. O destino vai no formato internacional, só com dígitos.
curl -X POST https://api.d-api.cloud/api/v1/messages/send/text \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "clinica-sorriso-recepcao",
"to": "5511999999999",
"text": "Olá, Ana! Sua consulta está marcada para amanhã às 14h."
}'
4. Receba os eventos. Toda notificação chega com o mesmo envelope, com event, sessionId, data e timestamp. O sessionId diz a qual cliente do seu SaaS o evento pertence. Responda 2xx rápido e processe em fila.
Em Node.js e TypeScript, o SDK oficial faz o mesmo com tipagem:
import { DApi } from 'd-api-sdk';
const dapi = new DApi({ apiKey: process.env.DAPI_API_KEY! });
await dapi.sessions.create({ sessionId: 'clinica-sorriso-recepcao', connectionMode: 'qr' });
const qr = await dapi.sessions.getQRCode('clinica-sorriso-recepcao');
await dapi.messages.sendText({
sessionId: 'clinica-sorriso-recepcao',
to: '5511999999999',
text: 'Olá, Ana! Sua consulta está marcada para amanhã às 14h.',
});
A referência completa de endpoints, campos e respostas está na documentação da D-API.
API de WhatsApp para SaaS multi-tenant
Num SaaS, cada cliente tem um ou mais números, e o modelo da D-API acompanha isso: uma sessão por número, cobrada por conexão ativa. Três decisões evitam retrabalho.
Primeiro, monte o sessionId a partir do identificador do seu cliente. O nome da sessão é único em toda a plataforma, então um prefixo do tenant evita colisão e deixa o roteamento do webhook trivial. O campo metadata da criação guarda dados livres seus junto da sessão.
Segundo, isole o acesso. Uma API key pode ser restrita a uma sessão, o que limita o estrago se uma chave vazar e combina com o modelo em que cada cliente só enxerga o próprio número.
Terceiro, trate o ciclo de conexão como parte do produto. Mostre o QR dentro da sua tela de configurações, avise o cliente quando chegar logged_out e ofereça o botão de reconectar. Na listagem, GET /api/v1/sessions vem paginado e com filtros, o que permite montar um painel de saúde das conexões de todos os clientes.
O artigo sobre API de WhatsApp multi-tenant, listado ao fim desta página, aprofunda roteamento de eventos e isolamento por cliente.
Por onde começar
Crie uma sessão de teste com o seu próprio número, conecte pelo QR e envie uma mensagem para você mesmo. Depois aponte o webhookUrl para um endpoint do seu backend e veja os eventos chegando. Com isso funcionando, o resto é escolher quais recursos entram no seu plano: mensagens e mídia primeiro, depois grupos, etiquetas ou ligações, conforme o segmento do seu cliente.
Se a dúvida agora é custo, a tabela de faixas por conexão fica na seção de preços da página inicial.
Time D-API. Atualizado em .
api de whatsapp
Tudo sobre api de whatsapp na D-API
- API de WhatsApp grátis para testar por 14 dias no seu SaaSAPI de WhatsApp grátis para testar: 14 dias para SaaS liberado pelo time, com grupo técnico de onboarding, ou 3 dias no cadastro direto. Sem plano grátis.
- API WhatsApp com IP dedicado e proxy gerenciado por conexãoAPI WhatsApp com IP dedicado por conexão: proxy atribuído ao criar o número, troca automática se ele falhar e o IP do seu servidor fora do caminho.
- API WhatsApp com SLA de 99,9% em contrato e 4 datacentersAPI WhatsApp com SLA de 99,9% garantido em contrato, 4 datacenters no Brasil, conexão isolada por número e self-healing para o SaaS que não pode parar.
- API WhatsApp contatos para verificar número, foto e bloqueioAPI WhatsApp contatos para o seu SaaS verificar se o número tem WhatsApp, buscar foto e perfil comercial, e bloquear ou reportar contatos por API.
- API WhatsApp grupos para criar e gerenciar turmas e timesAPI WhatsApp grupos para o seu SaaS criar grupos e comunidades, gerenciar participantes, convites e pedidos de entrada, e acompanhar tudo por webhook.
- API WhatsApp não oficial gerenciada, com SLAAPI WhatsApp não oficial para SaaS: conecte o número do cliente por QR code, sem cobrança por mensagem, com ligações incluídas e 99,9% de uptime.
- API WhatsApp para múltiplos números, um por cliente do SaaSAPI WhatsApp para múltiplos números: uma conexão isolada por cliente do seu SaaS, webhook próprio por número e listagem paginada de todas as sessões.
- API WhatsApp QR code para conectar números no seu SaaSUse a API WhatsApp QR code para mostrar o código de conexão dentro do seu produto, em JSON, PNG ou por webhook, e saber na hora quando o número conectou.
- Botão Pix no WhatsApp por API para cobrar na conversaEnvie botão Pix no WhatsApp por API: chave, valor e mensagem num endpoint só, para o seu SaaS cobrar dentro da conversa e acompanhar a entrega.
- Canais do WhatsApp (newsletter) por API para o seu SaaSCrie canais do WhatsApp (newsletter) por API, liste os canais da conta com papel e seguidores e publique texto e imagem direto do seu SaaS.
- Carrossel WhatsApp API para vitrine de produtos no seu SaaSEnvie carrossel pela WhatsApp API com até 10 cards, imagem e botões, e entregue ao cliente do seu SaaS uma vitrine que funciona dentro da conversa.
- Catálogo de produtos WhatsApp API sincronizado com a lojaCatálogo de produtos WhatsApp API para o seu SaaS criar, editar, ocultar e organizar produtos e coleções do WhatsApp Business a partir do estoque.
- Código de pareamento WhatsApp API, conectar sem QR codeCódigo de pareamento WhatsApp API para o seu cliente conectar o número digitando 8 caracteres no celular, sem escanear QR code e sem segunda tela.
- Enquete WhatsApp API, com localização, contato e reaçãoEnvie enquete pela WhatsApp API e receba o voto com o nome da opção. Localização, cartão de contato e reação no mesmo padrão, para o seu SaaS.
- Enviar imagem, áudio, vídeo e documento pela APIComo enviar imagem, áudio, vídeo e documento pela API de WhatsApp no seu SaaS, por URL ou base64, e receber a mídia dos contatos com link pronto.
- Enviar mensagem WhatsApp API com resposta, menção e filaComo enviar mensagem WhatsApp API pelo seu SaaS: texto, resposta citada, menção, envio assíncrono em ordem, edição e confirmação de entrega e leitura.
- Etiquetas WhatsApp API sincronizadas com o seu CRMEtiquetas WhatsApp API para criar, aplicar e remover etiquetas nas conversas e receber cada mudança por webhook, com o funil do CRM igual ao do celular.
- Gerenciar conversas do WhatsApp pela API, com busca e estadoGerencie conversas do WhatsApp pela API: liste, busque, arquive, fixe, silencie e marque como lida, com o inbox do seu SaaS igual ao celular.
- Preço da API de WhatsApp por conexão, sem custo por mensagemPreço da API de WhatsApp para SaaS: cobrança por conexão ativa, sem custo por mensagem na não-oficial e preço por conexão que cai com o volume.
- Sincronizar histórico de conversas do WhatsApp pela APISincronize o histórico de conversas do WhatsApp no seu SaaS: backfill ao conectar, pedido sob demanda e reenvio em massa com vazão controlada.
Perguntas frequentes
Preciso manter servidor próprio para rodar a API de WhatsApp?
Não. A D-API provisiona e mantém a conexão de cada número em datacenters no Brasil. O seu SaaS só chama a API REST e recebe os eventos por webhook.
Funciona com WhatsApp pessoal e com WhatsApp Business?
Sim. Na API não-oficial a conexão funciona com contas pessoais e com contas do app WhatsApp Business.
Em que linguagem posso integrar?
Em qualquer uma. A API é REST com especificação OpenAPI 3. Para Node.js e TypeScript existe o SDK oficial d-api-sdk, e para quem automatiza sem código há o community node n8n-nodes-d-api.
O que acontece com os eventos se o meu servidor ficar fora do ar?
A entrega do webhook é repetida até 7 vezes com backoff exponencial, e cada tentativa espera até 30 segundos pela resposta. Respostas 404 ou 410 encerram as tentativas para aquela URL.
Consigo testar antes de contratar?
Sim. SaaS liberado pelo time testa por 14 dias, com um grupo de onboarding em que o time técnico acompanha a implementação. No cadastro direto pelo painel o teste é de 3 dias.