Skip to main content
POST
/
user
/
sms
Enviar SMS
curl --request POST \
  --url https://suasofia.online/api/user/sms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": 123,
  "to": "<string>",
  "body": "<string>"
}
'
{
  "message": "SMS sent successfully",
  "data": {
    "id": 456,
    "phone_number_id": 78,
    "to": "+1234567890",
    "body": "Hello! This is a test message from Your Company. How can we help you today?",
    "user_id": 1,
    "segments": 1,
    "segment_price": 0.0075,
    "total_cost": 0.0075,
    "status": "sent",
    "sms_sid": "SM1234567890abcdef1234567890abcdef",
    "created_at": "2025-08-04 15:30:00",
    "updated_at": "2025-08-04 15:30:02"
  }
}
Este endpoint permite que você envie mensagens SMS usando seus números de telefone adquiridos. O SMS será enviado via Twilio e os custos serão automaticamente deduzidos do saldo da sua conta.

​
Corpo da Requisição

​
from
integer
required
O ID do seu número de telefone para enviar o SMS (deve ter capacidade de SMS)
​
to
string
required
O número de telefone do destinatário em formato internacional (ex: “+551234567890”)
​
body
string
required
O conteúdo da mensagem SMS (máximo 300 caracteres)

​
Resposta

​
message
string
Mensagem de sucesso confirmando que o SMS foi enviado
​
data
object

​
Respostas de Erro

​
400 Bad Request
​
500 Internal Server Error
{
  "message": "SMS sent successfully",
  "data": {
    "id": 456,
    "phone_number_id": 78,
    "to": "+1234567890",
    "body": "Hello! This is a test message from Your Company. How can we help you today?",
    "user_id": 1,
    "segments": 1,
    "segment_price": 0.0075,
    "total_cost": 0.0075,
    "status": "sent",
    "sms_sid": "SM1234567890abcdef1234567890abcdef",
    "created_at": "2025-08-04 15:30:00",
    "updated_at": "2025-08-04 15:30:02"
  }
}

​
Observações

  • O número de telefone remetente deve pertencer ao usuário autenticado
  • O número de telefone remetente deve ter capacidade de SMS
  • A assinatura do número de telefone deve estar ativa (não expirada)
  • Saldo suficiente na conta é necessário para cobrir os custos de SMS
  • Os números de telefone são automaticamente formatados para o formato E.164
  • Os custos de SMS variam de acordo com o país de destino e são cobrados por segmento
  • Mensagens longas podem ser divididas em múltiplos segmentos, aumentando o custo
  • O número de telefone do destinatário deve ser válido de acordo com os padrões internacionais