Skip to main content
POST
/
user
/
sms
Enviar SMS
curl --request POST \
  --url https://app.mayahub.ai/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 enviar mensagens SMS usando os números de telefone adquiridos.
O SMS será enviado por meio do Twilio e os custos serão automaticamente deduzidos do saldo da sua conta.

​
Corpo da solicitação

​
from
integer
required
O ID do seu número de telefone a partir do qual o SMS será enviado (deve ter capacidade para SMS)
​
to
string
required
O número de telefone do destinatário no formato internacional (exemplo: +1234567890)
​
body
string
required
O conteúdo da mensagem SMS (máximo de 300 caracteres)

​
Respostas

​
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 do remetente deve pertencer ao usuário autenticado.
  • O número de telefone do remetente deve ter capacidade para SMS.
  • A assinatura do número de telefone deve estar ativa (não expirada).
  • É necessário saldo suficiente na conta 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 vários segmentos, aumentando o custo.
  • O número de telefone do destinatário deve ser válido de acordo com os padrões internacionais.