Pular para o conteúdo
D-APITestar grátis

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

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.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.