API de SMS

A API de SMS da FCATI foi desenvolvida para oferecer uma integração rápida e totalmente confiável aos seus sistemas. Através do nosso webhook principal, você pode não apenas enviar mensagens de texto de forma ágil, mas também monitorar o quantitativo de créditos da sua conta em tempo real.

Siga os passos abaixo, copiando as referências em cURL para realizar seus testes iniciais.

Introdução: Autenticação

A segurança das suas requisições é fundamental. Todas as chamadas para o webhook da nossa API devem ser obrigatoriamente autenticadas utilizando um Token Bearer por meio do cabeçalho (Header) HTTP:

Authorization: Bearer <SEU_TOKEN_AQUI>

Consultar Saldo

Utilize este endpoint para verificar a quantidade atual de créditos disponíveis para envio na sua conta. É fortemente recomendado monitorar o seu saldo através de rotinas agendadas para garantir a prestação contínua da sua operação.

Estruturanto sua Requisição

Para consultar, você deve enviar o parâmetro acao com o valor definido como saldo direto no corpo da sua requisição (body):

curl -X POST 'https://api-sms-gateway.fcati.com.br' \
-H 'Authorization: Bearer eyJz2123dasdWIiOiIxM123jM0NTY3ODkwIi..' \
-H 'Content-Type: application/json' \
-d '{
  "acao": "saldo"
}'

{
  "balance": 998
}

Envio de Mensagens

Este processo inicializa o envio das suas mensagens SMS diretamente para o destinatário a partir da sua plataforma. É indispensável estruturar corretamente o payload (informações como número e texto).

Estruturando sua Requisição

(A estrutura completa do payload de envio será interpretada conforme as regras de negócio alinhadas previamente no momento da integração webhook. Abaixo listamos as rotas e tipos de cabeçalho mandatórios.)

curl -X POST 'https://api-sms-gateway.fcati.com.br' \
-H 'Authorization: Bearer eyJzdWIiOiIx...' \
-H 'Content-Type: application/json' \
-d '{
  "acao": "enviar",
  "recipient": "5511947651152",
  "text": "Teste da API estruturada!"
}'

{
  "messageId": "227336587",
  "message": "Mensagem enviada com sucesso!",
  "remaining_balance": 998
}

Suporte Técnico

Encontrou algum problema durante a integração ou possui dúvidas adicionais? Entre em contato com nossa equipe técnica abrindo um chamado.