Exemplo de recebimento de SMS via API

Este guia mostra um exemplo conceitual, de ponta a ponta, de como receber um SMS via API. Os endpoints oficiais e a autenticação ficam na documentação da API.

Resposta rápida

Um exemplo de recebimento de SMS via API tem três etapas: criar a ativação, obter o número e consultar o status até o código chegar. A autenticação é por chave de API. Os trechos aqui são conceituais; veja a documentação oficial para detalhes.

Para que serve

Ver o fluxo completo em um exemplo.
Entender as etapas da integração.
Preparar sua automação permitida.
Servir de ponto de partida para testes.

Como funciona

Gere a chave de API na conta.
Crie a ativação (país + serviço).
Obtenha o número.
Consulte o status até o código chegar.

Quando usar

Integração

Conecte o recebimento ao seu sistema, em usos permitidos.

QA

Use em testes automatizados autorizados.

Prototipagem

Valide a ideia antes de investir na automação completa.

Exemplos (conceituais)

Exemplos ilustrativos. Para a referência oficial de endpoints e autenticação, veja a documentação da API.

1) Criar ativação (conceitual)

curl -X POST "https://recebasms.ai/api/activations" \
  -H "x-api-key: SUA_CHAVE" -H "content-type: application/json" \
  -d '{ "serviceCode": "tg", "countryIso": "BR" }'
# => { "id": "abc123", "e164": "+55...", "status": "ACTIVE" }

2) Consultar o código (conceitual)

curl "https://recebasms.ai/api/activations/abc123" \
  -H "x-api-key: SUA_CHAVE"
# => { "status": "SMS_RECEIVED", "latestOtp": "12345" }

Cuidados e uso permitido

Use números virtuais e temporários de forma legal, responsável e conforme as regras dos serviços que você utiliza. A plataforma não deve ser usada para fraude, spam, abuso, violação de direitos de terceiros, criação de contas não autorizadas ou tentativa de contornar sistemas de verificação.

Perguntas frequentes

É a documentação oficial?

Não. É um exemplo conceitual; a referência oficial fica na documentação da API.

Os IDs são reais?

Não, são ilustrativos. Use os valores retornados pela sua conta.

Preciso de chave?

Sim, a integração usa uma chave de API.

Posso usar webhook?

Sim; veja o guia de webhook para receber em tempo real.

Há limites?

Sim: limites de uso, disponibilidade e regras antifraude se aplicam.

Páginas relacionadas

Pronto para começar?

Ver documentação da API

RecebaSMS.ai