APIDOCS
API Restful v1.0

Conectando seu software ao Mundo.

Automatize envios de SMS, consulte saldos e gerencie campanhas em tempo real com nossa infraestrutura de alta performance. Desenvolvida para desenvolvedores.

Autenticação

O FT Telecom utiliza autenticação baseada em API Tokens. Cada requisição deve incluir o token no cabeçalho HTTP de autorização.

Nunca compartilhe seu token publicamente. Caso suspeite de vazamento, revogue-o imediatamente no painel administrativo e gere um novo.

Endpoints Base

Todos os endpoints da API são prefixados com a versão atual. Recomendamos o uso do HTTPS em todas as chamadas.

Production: https://smspro.net.br/api/v1
GET

Consultar Saldo

Retorna o saldo atual de SMS créditos e informações do inquilino em tempo real.

Resposta de Sucesso (200 OK)

tenant
Nome da Empresa
Identificação clara do tenant autenticado.
balance
Saldo Numérico
Quantidade de créditos disponíveis para envio imediato.
POST

Enviar Mensagem

Endpoint principal para despacho de SMS em massa ou individual.

Parâmetros da Requisição

Campo Tipo Obrigatório
number
E.164 (ex: 5511999999999)
 string SIM
message
Texto plano
 string SIM
GET

Histórico de Envios

Recupere a lista de mensagens enviadas, filtradas por período ou status.

Parâmetros de Consulta (Query Params)

Parâmetro Tipo Descrição
start_date
 string Data inicial no formato YYYY-MM-DD.
end_date
 string Data final no formato YYYY-MM-DD.
status
 string Filtro por status (ex: SENT, FAILED, PENDING).
CORE

Gestão de Campanhas

Crie campanhas automáticas vinculadas a suas listas de contatos salvas no painel.

Ao criar uma campanha via API, o sistema processará automaticamente todos os contatos da lista informada, respeitando as configurações de horário e velocidade definidas globalmente.

Códigos de Erro

401 Unauthorized

Token inválido ou expirado. Verifique os cabeçalhos Auth.

422 Unprocessable

Dados de envio mal formatados ou sem saldo suficiente.

404 Not Found

Endpoint inexistente ou record (id) não encontrado.

500 Server Error

Erro crítico interno. Contate o suporte técnico.

Taxas e Limites

Para garantir a estabilidade de todos os nossos clientes, aplicamos limites de requisições baseados no seu plano e tipo de token.

Rate Limit Padrão
60 req/min
Burst Limit
10 req/sec
Os cabeçalhos X-RateLimit-Remaining são enviados em todas as respostas para ajudá-lo a monitorar seu consumo programaticamente.
TIMEOUT: 5s
Requisição Exemplo
curl -X GET "https://smspro.net.br/api/v1/balance" \
-H "Authorization: Bearer YOUR_TOKEN"
curl -X POST "https://smspro.net.br/api/v1/sms/send" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{'
"number": "5511999999999",
"message": "Teste da API FT Telecom"
'}'
curl -X GET \
"https://smspro.net.br/api/v1/sms/history?status=SENT" \
-H "Authorization: Bearer YOUR_TOKEN"
curl -X GET "https://smspro.net.br/api/v1/campaigns" \
-H "Authorization: Bearer YOUR_TOKEN"
$client = new \GuzzleHttp\Client();
$response = $client->get('https://smspro.net.br/api/v1/balance', [
'headers' => ['Authorization' => 'Bearer YOUR_TOKEN']
]);
$client = new \GuzzleHttp\Client();
$response = $client->post('https://smspro.net.br/api/v1/sms/send', [
'headers' => ['Authorization' => 'Bearer YOUR_TOKEN'],
'json' => ['number' => '5511999999999', 'message' => '...']
]);
$client = new \GuzzleHttp\Client();
$response = $client->get('https://smspro.net.br/api/v1/sms/history', [
'headers' => ['Authorization' => 'Bearer YOUR_TOKEN'],
'query' => ['status' => 'SENT']
]);
axios.get('https://smspro.net.br/api/v1/balance', {
headers: { Authorization: 'Bearer YOUR_TOKEN' }
});
axios.post('https://smspro.net.br/api/v1/sms/send', { number: '...' }, {
headers: { Authorization: 'Bearer YOUR_TOKEN' }
});
axios.get('https://smspro.net.br/api/v1/sms/history', {
params: { status: 'SENT' },
headers: { Authorization: 'Bearer YOUR_TOKEN' }
});
Resposta JSON Exemplo 200 OK 
{
  "status": "success",
  "balance": 150.75,
  "company": "Minha Empresa"
}
{
  "status": "success",
  "message": "SMS encaminhado para fila",
  "data": {
    "id": "f47ac10b-58cc...",
    "cost": 0.05
  }
}
[
  {
    "id": 1250,
    "number": "5511999999999",
    "status": "SENT",
    "created_at": "2026-01-27 10:00"
  },
  ...
]
[
  {
    "id": 10,
    "name": "Promoção Verão",
    "total_contacts": 500
  }
]
Precisa de ajuda avançada?

Nossa equipe de engenharia está disponível para auxiliar em integrações complexas e alto volume.

Abrir Ticket de Suporte