sla e alta disponibilidade
API WhatsApp com SLA em contrato para o SaaS que não pode parar
Uma API WhatsApp com SLA de 99,9% garantido em contrato, 4 datacenters no Brasil e cada número isolado na própria instância. Quando algo falha, a recuperação começa antes de o seu cliente abrir um chamado.
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
99,9% em contrato
Disponibilidade medida por trimestre, com crédito proporcional ao tempo fora do ar quando a indisponibilidade causa prejuízo.
4 datacenters no Brasil
Infraestrutura distribuída no país, sem você contratar servidor, VPS ou região.
Uma instância por número
Problema numa conexão fica nela. Os outros clientes do seu SaaS seguem enviando e recebendo.
Self-healing 24/7
Monitoramento contínuo, reinício automático da instância e troca de proxy sem ação do seu time.
Uma API WhatsApp com SLA em contrato muda a conversa que você tem com o seu próprio cliente. Quando o WhatsApp é parte do produto que o seu SaaS vende, cada hora fora do ar vira chamado no seu suporte, cancelamento no seu churn e explicação na sua reunião de renovação. “A infraestrutura de terceiros caiu” não serve de resposta para quem paga você. Por isso, disponibilidade precisa estar escrita no contrato, com medição, crédito e exclusões claras, e não só em uma frase de site.
A API de WhatsApp da D-API tem 99,9% de uptime garantido em contrato, roda em 4 datacenters no Brasil e já sustenta 1.875 conexões na D-API. Esta página mostra o que está por trás desse número e o que o seu SaaS precisa fazer do lado dele para que a disponibilidade chegue até o cliente final.
O que o SLA de 99,9% cobre
Os termos de uso da D-API definem a regra:
| Item | Como funciona |
|---|---|
| Meta de disponibilidade | 99,9% |
| Período de medição | Trimestral |
| Compensação | Crédito proporcional ao tempo de indisponibilidade, quando ela causa prejuízo |
| Limite do crédito | 30% da mensalidade do trimestre afetado |
| Como pedir | Solicitação ao suporte, com abatimento nas faturas seguintes |
| Fora do SLA | Instabilidades do WhatsApp ou da Meta, força maior, ataques e ações de terceiros |
Incidentes de infraestrutura que afetem a operação são publicados na página de status, em status.d-api.cloud, e manutenções programadas são avisadas com antecedência sempre que possível. Para o seu SaaS, isso significa ter um documento para mostrar ao cliente corporativo que pergunta “qual é o SLA do seu fornecedor de WhatsApp?”.
Isolamento por número: falha local fica local
O primeiro pilar da alta disponibilidade é o isolamento. Na D-API, cada número de WhatsApp da API não-oficial roda na própria instância. Se a conexão de um cliente do seu SaaS trava, as outras seguem funcionando. Não existe um processo compartilhado que, ao cair, leve junto a base inteira.
O isolamento também dá controle fino. A rota GET /api/v1/sessions/{sessionId}/connect força a reconexão daquela sessão reiniciando a instância dela, e cai para uma reconexão simples se o reinício falhar. O seu suporte resolve o caso de um cliente sem afetar mais ninguém.
Self-healing: recuperação sem plantão no seu time
O segundo pilar é a recuperação automática. Três mecanismos trabalham juntos:
- Verificação de saúde por instância. Cada instância é monitorada, e a que fica travada é reiniciada.
- Troca de proxy. Cada conexão sai por um proxy atribuído a ela. Quando um proxy falha, ele é desativado, as conexões dele recebem outro proxy e são reiniciadas. A página sobre IP dedicado detalha esse fluxo.
- Proteção contra efeito cascata. Muitos pedidos de reinício pelo mesmo motivo no mesmo minuto costumam indicar uma dependência compartilhada fora do ar, e reiniciar tudo de uma vez não resolve. A plataforma limita os reinícios por motivo a cada minuto, e a verificação de saúde continua como rede de segurança para a instância que realmente travou.
Do lado da API, o GET /health devolve o estado do serviço, incluindo banco de dados, RabbitMQ e Redis.
Entrega de eventos que aguenta o seu endpoint fora do ar
Disponibilidade não para no envio. Se o seu endpoint de webhook está lento ou fora do ar, o que acontece com as mensagens recebidas? A política de entrega da D-API, conforme a documentação da D-API:
- Retentativas. Até 7 tentativas com backoff exponencial, de aproximadamente 5, 10, 20, 40, 80 e 160 segundos entre elas.
- Timeout. 30 segundos por tentativa.
- Falha permanente. Respostas 404 ou 410 encerram as tentativas para aquela URL.
- Circuit breaker por URL. Endpoints que falham repetidamente têm a entrega pausada por um tempo, para não acumular tentativas inúteis.
- Deduplicação. Eventos passam por deduplicação com janela de 5 minutos, reduzindo entregas duplicadas em sequência.
Para arquiteturas que precisam de mais folga, cada sessão pode publicar os eventos numa fila RabbitMQ configurada por você. E se o seu lado perdeu eventos por um período, o reenvio do histórico de conversas recupera as mensagens armazenadas filtrando por data.
Envio que não depende do request ficar aberto
Comandos com async: true respondem na hora com um commandId e entregam o resultado pelo evento command.result. O comando nunca é reexecutado automaticamente, porque reenviar uma mensagem sem saber se a primeira saiu pode duplicar. A entrega do command.result tem a própria retentativa, e o mesmo resultado pode ser consultado em GET /api/v1/commands/{commandId} por cerca de 1 hora. Na prática, o seu worker grava o commandId junto da entidade (pedido, notificação, conversa) e reconcilia depois, sem segurar conexões HTTP abertas.
O que o seu SaaS precisa fazer do lado dele
Uma infraestrutura com SLA só chega ao cliente final se a integração acompanhar. O checklist que o time técnico da D-API revisa com clientes SaaS no onboarding:
- Webhook rápido. Responda
2xxassim que validar o evento e processe em fila própria. Processamento pesado dentro do request é a causa mais comum de retentativa. - Idempotência. Grave eventos com chave única no ID. Retentativa e deduplicação reduzem duplicados, mas o seu handler precisa tolerar repetição.
- Estado da conexão visível. Assine
connection.statuse mostre ao cliente final quando o número dele desconectou, com o motivo emreason. - Roteamento por tenant. Todo evento traz o
sessionId. Use-o para encontrar o cliente antes de qualquer lógica, como descreve o artigo sobre API de WhatsApp multi-tenant. - Sem estado em memória. Handlers que não guardam estado no processo podem rodar em várias réplicas, e a sua parte da disponibilidade acompanha a da D-API.
A conta de quem pensa em montar essa infraestrutura internamente está no artigo sobre construir ou contratar uma API de WhatsApp. Para ver como a mesma infraestrutura atende vários números do mesmo cliente, siga para a página de múltiplos números.
Time D-API. Atualizado em .
Perguntas frequentes
Como o SLA de 99,9% é medido?
Pelos termos de uso da D-API, a disponibilidade é medida por trimestre. Se ficar abaixo de 99,9% e a indisponibilidade causar prejuízo, o cliente tem crédito proporcional ao tempo fora do ar, limitado a 30% da mensalidade do trimestre, pedido ao suporte e abatido nas faturas seguintes.
Instabilidade do próprio WhatsApp entra no SLA?
Não. Os termos excluem interrupções causadas por fatores externos, como instabilidades do WhatsApp ou da Meta, força maior e ações de terceiros. O SLA cobre a infraestrutura da D-API.
Onde vejo se há um incidente em andamento?
Incidentes de infraestrutura que afetam a operação são publicados na página de status da D-API, em status.d-api.cloud. Janelas de manutenção programada são comunicadas com antecedência sempre que possível.
Qual o prazo de resposta do suporte em um incidente?
Os termos preveem suporte por e-mail e WhatsApp todos os dias, das 8h à 0h, horário de Brasília. Em severidade crítica, com plataforma ou envios fora do ar, a primeira resposta é em até 30 minutos dentro desse horário.
Se o meu endpoint de webhook cair, eu perco os eventos?
A entrega é repetida até 7 vezes com backoff exponencial, de cerca de 5 segundos até 160 segundos entre tentativas. Para uma janela maior de indisponibilidade no seu lado, a fila RabbitMQ por sessão e o reenvio de histórico ajudam a recuperar.