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

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 WhatsApp 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/send envia uma mensagem para um número. Obrigatórios: to e text.
  • POST /api/v1/sms/bulk envia o mesmo texto para uma lista. O to vira 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

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.

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.