Pular para o conteúdo
EnviarBrasil
Integração e API

Uma requisição HTTP e a mensagem sai

Sem SDK obrigatório, sem homologação de meses, sem projeto de TI. Conecte o seu ERP, CRM, e-commerce ou sistema próprio e deixe o disparo acontecer no evento certo.

Solicitar acessoVer a infraestrutura
Começando

Da chave ao primeiro envio

Três passos, com o mesmo remetente e os mesmos créditos do painel.

  1. 1Peça o seu acesso à equipe da Enviar Brasil, que coloca os créditos.
  2. 2Gere a chave de API no painel, em API e integração.
  3. 3Faça um POST para /v1/sms com número e mensagem.
curl -X POST https://api.enviarbrasil.com/v1/sms \
  -H "Authorization: Bearer $ENVIAR_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "numero": "5565999217864",
    "mensagem": "Seu pedido 88421 saiu para entrega.",
    "referencia": "pedido-88421"
  }'
Envio em lote

Até 10.000 mensagens em uma chamada só

A mesma autenticação, uma rota diferente. Com agendamento opcional: sem fuso em agendar_para, a hora é a de Cuiabá.

POST /v1/sms/lote HTTP/1.1
Host: api.enviarbrasil.com
Authorization: Bearer $ENVIAR_CHAVE
Content-Type: application/json

{
  "agendar_para": "2027-03-01T09:00:00-03:00",
  "mensagens": [
    { "numero": "5511999990001", "mensagem": "Ana, sua parcela vence hoje." },
    { "numero": "5511999990002", "mensagem": "Bruno, sua parcela vence hoje." }
  ]
}
Consulta

Status, saldo e campanhas quando o seu sistema precisar

A mesma chave consulta mensagens, campanhas e créditos, sempre só da sua conta.

Rotas de consulta

# situação de uma mensagem
curl https://api.enviarbrasil.com/v1/sms/msg_9f2c4a1b \
  -H "Authorization: Bearer $ENVIAR_CHAVE"

# saldo de créditos
curl https://api.enviarbrasil.com/v1/saldo \
  -H "Authorization: Bearer $ENVIAR_CHAVE"

# campanhas e o detalhe de uma delas
curl https://api.enviarbrasil.com/v1/campanhas \
  -H "Authorization: Bearer $ENVIAR_CHAVE"

curl "https://api.enviarbrasil.com/v1/campanhas/cmp_7d1e03c2?limite=100" \
  -H "Authorization: Bearer $ENVIAR_CHAVE"

Resposta de uma mensagem

{
  "id": "msg_9f2c4a1b",
  "campanha_id": "cmp_7d1e03c2",
  "numero": "5565999217864",
  "status": "entregue",
  "erro": null,
  "enviada_em": "2026-11-05T13:00:04.120Z",
  "atualizada_em": "2026-11-05T13:00:31.480Z"
}

Status possíveis

  • pendente — Na fila, ainda não saiu.
  • enviado — Aceita para envio, ainda sem confirmação de entrega.
  • entregue — A operadora confirmou a entrega. É o status que vale.
  • nao_entregue — A operadora não conseguiu entregar. O crédito não volta.
  • expirado — Passou da validade sem entrega. O crédito não volta.
  • falhou — Recusada antes de sair. O crédito volta para o saldo.
Dúvidas técnicas

O que o seu desenvolvedor vai perguntar

Não. A API é HTTP com JSON. Qualquer linguagem que faça uma requisição HTTP consegue integrar — inclusive ferramentas no-code que permitem chamada HTTP.

A equipe da Enviar Brasil abre o seu acesso, define o remetente e coloca os créditos. Depois disso, você mesmo gera a chave no painel, em API e integração. Ela aparece uma única vez, então guarde-a no servidor.

Sim. Toda chamada de envio manda um SMS real e consome os créditos da sua conta, os mesmos do painel.

Consulte GET /v1/sms/{id} ou GET /v1/campanhas/{id}. A API não chama o seu sistema quando o status muda: é ele que pergunta. O mesmo status aparece no relatório do painel.

1 crédito é uma parte de SMS. Até 160 caracteres ocupam uma parte; texto maior ocupa mais. O envio só sai com saldo para todas as mensagens, e o que for recusado volta para o saldo.

Até 10.000 mensagens por chamada, que viram uma campanha só. Um número repetido sai uma vez, e os números da blacklist são descartados antes de custar crédito.

Estas são as rotas da API. Os códigos de erro e o passo a passo ficam no painel, em API e integração, junto com a sua chave.

Solicitar acesso