> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar SMS

> Envía un mensaje SMS con tu número de teléfono de Famulor a través de la API. Activa mensajes transaccionales o de seguimiento después de llamadas de voz con IA, captación de leads o campañas.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint te permite enviar mensajes SMS a través de tus números de teléfono comprados. El SMS se envía mediante Twilio y el coste se deduce automáticamente del saldo de tu cuenta.

### Cuerpo de la solicitud

<ParamField body="from" type="integer" required>
  El ID de tu número de teléfono desde el que se enviará el SMS (debe ser compatible con SMS)
</ParamField>

<ParamField body="to" type="string" required>
  El número de teléfono del destinatario en formato internacional (p. ej., "+4915123456789")
</ParamField>

<ParamField body="body" type="string" required>
  El contenido del mensaje SMS (máx. 300 caracteres)
</ParamField>

### Campos de respuesta

<ResponseField name="message" type="string">
  Mensaje de éxito que confirma que el SMS se envió
</ResponseField>

<ResponseField name="data" type="object">
  Datos adicionales sobre el SMS enviado
</ResponseField>

### Respuestas de error

<ResponseField name="400 Bad Request" type="object">
  <Expandable title="Detalles del error">
    <ResponseField name="message" type="string">
      Mensaje de error que describe el problema (número de teléfono no válido, saldo insuficiente, etc.)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="500 Internal Server Error" type="object">
  <Expandable title="Error del servidor">
    <ResponseField name="message" type="string">
      Mensaje de error que indica un fallo al enviar el SMS
    </ResponseField>

    <ResponseField name="error" type="string">
      Información detallada del error
    </ResponseField>
  </Expandable>
</ResponseField>

### Notas

* El número de teléfono remitente debe pertenecer al usuario autenticado
* El número de teléfono remitente debe ser compatible con SMS
* La suscripción del número de teléfono debe estar activa (no caducada)
* Se requiere saldo suficiente en la cuenta para cubrir el coste del SMS
* Los números de teléfono se formatean automáticamente al formato E.164
* El coste del SMS varía según el país de destino y se cobra por segmento
* Los mensajes largos pueden dividirse en varios segmentos, lo que aumenta el coste
* El número de teléfono del destinatario debe cumplir los estándares internacionales

<ResponseExample>
  ```json 200 Sent Successfully theme={null}
  {
    "message": "SMS sent successfully",
    "data": {
      "sms_id": "SMS_67890",
      "from": "+4912345678",
      "to": "+4915123456789",
      "body": "Hello! This is a test SMS from Famulor.",
      "segments": 1,
      "cost": 0.05,
      "currency": "EUR",
      "status": "sent"
    }
  }
  ```

  ```json 400 Invalid Request theme={null}
  {
    "message": "Invalid phone number format"
  }
  ```

  ```json 400 Insufficient Balance theme={null}
  {
    "message": "Insufficient balance to send SMS"
  }
  ```

  ```json 400 Phone Number Not SMS-Capable theme={null}
  {
    "message": "Phone number is not SMS-capable"
  }
  ```

  ```json 400 Phone Number Not Found theme={null}
  {
    "message": "From number not found"
  }
  ```

  ```json 500 Server Error theme={null}
  {
    "message": "Failed to send SMS",
    "error": "Twilio service temporarily unavailable"
  }
  ```
</ResponseExample>

<Tip>
  Páginas relacionadas: [Introducción](/es/api-v1/introduction) y [Guía de autenticación](/es/api-v1/authentication), y [Ejemplos de integración de la API](/es/api-v1/introduction).
</Tip>