> ## 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.

# Obtener remitentes de WhatsApp

> Lista los remitentes de WhatsApp Business configurados en tu cuenta de Famulor

<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>

Recupera todos los remitentes de WhatsApp Business (números de teléfono) configurados en tu cuenta de Famulor. Usa este endpoint para obtener los valores de `sender_id` necesarios para enviar mensajes de WhatsApp a través de la API de Famulor.

### Parámetros de consulta

<ParamField query="status" type="string" optional>
  Filtra los remitentes por estado. Predeterminado: `online`. Usa `all` para devolver todos los remitentes independientemente de su estado.
</ParamField>

### Campos de la respuesta

<ResponseField name="data" type="array">
  <Expandable title="Propiedades del objeto sender">
    <ResponseField name="id" type="integer">
      El identificador único del remitente de WhatsApp. Usa este ID al enviar mensajes.
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      El número de teléfono del remitente en formato E.164 (p. ej., `+14155551234`)
    </ResponseField>

    <ResponseField name="display_name" type="string">
      El nombre visible de WhatsApp Business (nombre de la empresa que se muestra a los destinatarios)
    </ResponseField>

    <ResponseField name="status" type="string">
      El estado actual del remitente: `online` u `offline`
    </ResponseField>

    <ResponseField name="quality_rating" type="string">
      La calificación de calidad de Meta para este remitente: `GREEN`, `YELLOW` o `RED`
    </ResponseField>

    <ResponseField name="messaging_limit" type="integer">
      El límite de mensajería actual (número de destinatarios únicos cada 24 horas). `null` significa ilimitado.
    </ResponseField>

    <ResponseField name="messaging_limit_formatted" type="string">
      Límite de mensajería legible para humanos (p. ej., `1,000 / 24hr`, `10,000 / 24hr` o `Unlimited`)
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null} theme={null}
  curl -X GET "https://app.famulor.de/api/user/whatsapp/senders" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```bash Filter all senders theme={null} theme={null}
  curl -X GET "https://app.famulor.de/api/user/whatsapp/senders?status=all" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null} theme={null}
  const response = await fetch(
    'https://app.famulor.de/api/user/whatsapp/senders',
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );

  const data = await response.json();
  console.log(data.data); // Array of senders
  ```

  ```python Python theme={null} theme={null}
  import requests

  response = requests.get(
      'https://app.famulor.de/api/user/whatsapp/senders',
      headers={'Authorization': 'Bearer YOUR_API_KEY'}
  )

  senders = response.json()['data']
  for sender in senders:
      print(f"{sender['display_name']}: {sender['phone_number']}")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Response theme={null} theme={null}
  {
    "data": [
      {
        "id": 12,
        "phone_number": "+14155551234",
        "display_name": "Acme Corp Support",
        "status": "online",
        "quality_rating": "GREEN",
        "messaging_limit": 10000,
        "messaging_limit_formatted": "10,000 / 24hr"
      },
      {
        "id": 15,
        "phone_number": "+442071234567",
        "display_name": "Acme Corp Sales",
        "status": "online",
        "quality_rating": "GREEN",
        "messaging_limit": null,
        "messaging_limit_formatted": "Unlimited"
      }
    ]
  }
  ```

  ```json 200 Empty Response theme={null} theme={null}
  {
    "data": []
  }
  ```
</ResponseExample>

### Notas

* De forma predeterminada, solo se devuelven los remitentes con estado `online`. Usa `?status=all` para incluir los remitentes desconectados.
* El estado del remitente se sincroniza con Meta automáticamente cada 5 minutos.
* El campo `id` es lo que debes pasar como `sender_id` al enviar mensajes.
* La calificación de calidad afecta a tus límites de mensajería. Una calificación `RED` puede restringir tu capacidad de enviar mensajes.

<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>