sms por api
API de SMS para o seu SaaS, ao lado do WhatsApp e da voz
Com a API de SMS da D-API, o seu SaaS envia código de verificação, aviso crítico e comunicado em massa para qualquer celular, recebe o status de entrega por webhook e usa a mesma conta do WhatsApp e da URA.
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 endpoints, sem sessão
POST /api/v1/sms/send e /api/v1/sms/bulk usam só a API key. Não há QR code nem conexão para manter ativa.
Rota para código e para aviso
route otp para envios transacionais, como códigos de verificação, e marketing para comunicados, que é o padrão.
Status final por webhook
Entregue, não entregue ou expirado, com errorCode normalizado e a quantidade de segmentos de cada mensagem.
Envio rejeitado não é cobrado
A cobrança acontece no aceite. Se a saída rejeitar a mensagem, o valor volta para o saldo da carteira.
Uma API de SMS resolve a mensagem que precisa chegar a qualquer celular com linha ativa, tenha ele WhatsApp ou não, esteja ele com internet ou não. Para um SaaS, isso aparece em três lugares: o código de verificação no login, o aviso que não pode esperar e o comunicado para uma base inteira. Na D-API, a API de SMS fica na mesma conta, na mesma API key e no mesmo padrão de webhook que o seu time já usa para WhatsApp e voz, então o canal novo entra no produto sem fornecedor, contrato ou formato de evento diferente.
Esta página apresenta o SMS por inteiro: quando ele faz sentido ao lado dos outros canais, como os dois endpoints funcionam, como o texto vira segmentos, como o status volta e como modelar tudo num SaaS com muitos clientes. Cada parte tem uma página filha com o detalhe.
Quando o SMS é o canal certo
O WhatsApp costuma ser o canal principal de um SaaS de comunicação, e com razão: tem conversa de mão dupla, mídia e botões. O SMS entra onde ele não cobre ou onde a mensagem não pode depender de um aplicativo.
| Situação | Canal | Por quê |
|---|---|---|
| Conversa com o cliente, mídia, botões | Mão dupla e formatos ricos | |
| Código de verificação, troca de senha | SMS | Chega sem app e sem internet |
| Aviso para quem não leu o WhatsApp | SMS | Segunda tentativa num canal diferente |
| Base com contatos sem WhatsApp | SMS | Alcança qualquer celular com linha ativa |
| Confirmação que precisa de resposta imediata | Voz | A ligação toca na hora e captura tecla |
Na prática, os três canais trabalham juntos. Um SaaS de agendamento confirma por WhatsApp, manda SMS para quem não abriu e liga pela API de URA para quem segue sem responder. Todos os passos usam a mesma API, e a regra de quando trocar de canal fica no seu backend.
Os dois endpoints da API de SMS
O SMS da D-API não depende de sessionId, porque o envio sai pela conta e não por uma conexão de WhatsApp. São dois endpoints:
POST /api/v1/sms/sendenvia uma mensagem para um número. Obrigatórios:toetext.POST /api/v1/sms/bulkenvia o mesmo texto para uma lista. Otovira um array de números.
Os dois aceitam route (otp ou marketing, com marketing como padrão) e sender (remetente exibido). Com o SDK Node, um aviso transacional de uma plataforma de delivery fica assim:
import { DApi } from "d-api-sdk";
const dapi = new DApi({ apiKey: process.env.DAPI_API_KEY! });
const envio = await dapi.sms.send({
to: "11999999999",
text: "Seu pedido 4821 saiu para entrega. Previsao de chegada: 19h40.",
route: "otp",
});
await salvarEnvio({ tenantId, pedidoId: 4821, messageId: envio.messageId, segmentos: envio.segments });
A resposta traz success: true, o messageId, a quantidade de segments e status: "sent". O messageId é a chave que liga o envio aos eventos de entrega, então ele vai para o banco junto com o tenant e o objeto de negócio.
O to aceita E.164 (+5511999999999) ou formato nacional com DDD (11999999999 ou 5511999999999); sem o +, a D-API assume Brasil e normaliza. Número que não pode ser normalizado volta HTTP 400 com BAD_PHONE. A diferença entre os dois endpoints, o limite prático por saldo e o resultado por número estão em SMS em massa por API.
Rotas otp e marketing
O campo route separa o tipo de envio. otp é a rota transacional, para códigos de verificação, confirmações de segurança e avisos ligados a uma ação do usuário. marketing é a rota de comunicados e campanhas, e é a usada quando o campo não vem. A rota define a categoria de preço do envio, então vale deixar a escolha explícita no seu código em vez de depender do padrão.
Para um SaaS com muitos clientes, a decisão costuma ficar no tipo de mensagem e não no cliente: todo código de login sai como otp, toda campanha criada na tela de marketing sai como marketing. O fluxo completo de código por SMS, com geração, expiração e fallback, está em SMS de código de verificação.
Texto, segmentos e cobrança
Antes do envio, a D-API converte o texto para o alfabeto GSM-7: acentos são removidos e caracteres fora do alfabeto, como emoji, viram ?. Por isso o exemplo acima já foi escrito sem acento em “Previsao”. Uma mensagem de até 160 caracteres ocupa um segmento; acima disso, ela é dividida em partes de 153 caracteres. Alguns símbolos, como €, [ e {, contam como dois.
A cobrança é por segmento, a partir do saldo da carteira da conta, e segue um modelo simples de explicar ao seu cliente. O valor é debitado no momento do envio; se a saída rejeitar a mensagem, o débito é estornado e a API responde HTTP 502. Sem saldo, a resposta é HTTP 402 com INSUFFICIENT_CREDITS e nada sai. O preço do SMS depende da rota e do volume e não está publicado no site; para uma tabela do seu volume, fale com o time comercial.
Mostrar a contagem de segmentos na tela de composição do seu produto é um detalhe que o seu cliente agradece, porque deixa claro por que uma mensagem longa custa mais.
Status de entrega por webhook
O SMS vira canal confiável quando o seu sistema sabe o que aconteceu com cada mensagem. A D-API notifica o status final por webhook, com quatro eventos: sms.delivered, sms.undelivered, sms.failed e sms.expired. Em caso de falha, o campo errorCode traz um código normalizado, como INVALID_NUMBER, LANDLINE ou NO_COVERAGE, que vira regra de produto sem interpretar mensagem de operadora.
Existem dois canais de webhook. O de conta é configurado uma vez no painel, recebe o status de todos os envios e tem fila durável com retentativas. O de campanha é configurado numa campanha de disparo em massa do painel, recebe só aquela campanha e é entregue numa única tentativa. Os dois assinam o corpo com HMAC-SHA256 no header X-DAPI-Signature quando há secret. Os eventos, os códigos e o tratamento idempotente estão em webhook de SMS, e a referência completa na documentação da D-API.
Exemplos por segmento
- Plataforma de e-commerce: código de confirmação de telefone no checkout pela rota
otp, e aviso de pedido despachado por SMS para quem não tem WhatsApp no número cadastrado. - Software de cobrança: lembrete de vencimento por WhatsApp; para quem não recebeu em duas horas, o mesmo aviso por SMS com o link da segunda via.
- Software de clínicas: confirmação de consulta por WhatsApp, SMS para quem não abriu e ligação de URA na véspera para quem continua sem confirmar.
- Gestão de academias: comunicado de feriado para todos os alunos ativos num único
/sms/bulk. - Plataforma de atendimento: alerta de chamado crítico para o plantonista por SMS, em paralelo ao WhatsApp.
SMS num SaaS multi-tenant
Como o webhook de conta concentra os envios de todos os clientes do seu SaaS, a separação por tenant acontece no seu banco: grave o messageId com o identificador do cliente e do objeto de negócio, e resolva o dono do evento por ele. É o mesmo raciocínio que você aplica aos eventos de WhatsApp.
Três práticas mantêm o canal previsível. Envie de um worker, com a ação do usuário só gravando a intenção de envio. Use uma chave de idempotência no seu lado antes de cada SMS de fallback, para não duplicar quando o webhook do WhatsApp chega atrasado. E responda o webhook rápido, processando o evento depois numa fila sua.
O artigo API de SMS para SaaS aprofunda o desenho do fallback com prazos por tipo de aviso. Para quem já usa a D-API no WhatsApp, a API key, a base URL e o envelope de evento são os mesmos, e o SMS entra como mais um módulo da integração que já existe.
Time D-API. Atualizado em .
sms
Tudo sobre sms na D-API
- Envio de SMS em massa por API para o seu SaaSEnvio de SMS em massa por API: o mesmo texto para uma lista numa chamada, com resultado por número, controle de saldo e status de entrega por webhook.
- SMS de código de verificação (OTP) por API no seu SaaSEnvie SMS de código de verificação (OTP) pela rota transacional da D-API, com status de entrega por webhook e fallback para WhatsApp na mesma conta.
- Webhook de status de SMS para o seu SaaSWebhook de status de SMS da D-API: entregue, não entregue ou expirado, com errorCode normalizado, assinatura HMAC e entrega com retentativa.
Perguntas frequentes
Quanto custa enviar SMS pela D-API?
O SMS é cobrado por segmento, a partir do saldo da carteira da conta, e o valor varia com a rota e o volume. O preço não está publicado no site; fale com o time comercial para receber a tabela do seu volume.
A API de SMS recebe respostas dos destinatários?
Não. O SMS da D-API é só de saída: você envia e recebe o status de entrega, sem evento de SMS recebido. Quando a conversa precisa de mão dupla, o canal certo é o WhatsApp, na mesma conta.
Posso trocar o remetente que aparece no celular?
O campo opcional sender troca o remetente exibido (alpha tag). Quando ele é omitido, vale o remetente padrão da rota.
Consigo enviar SMS sem integrar código?
Sim. O painel da D-API tem campanhas de SMS com upload de planilha, e o builder de automação tem bloco de SMS. A API serve para quando o envio nasce de um evento dentro do seu produto.
Dá para testar a API de SMS antes de contratar?
Dá. SaaS liberado pelo time testa a D-API por 14 dias, com um grupo de onboarding em que o time técnico acompanha a implementação. A gente também é SaaS e sabe o peso de colocar um canal novo em produção.