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

# Récupérer les expéditeurs WhatsApp

> Liste les expéditeurs WhatsApp Business configurés dans votre compte Famulor

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Récupère tous les expéditeurs WhatsApp Business (numéros de téléphone) configurés dans votre compte Famulor. Utilisez ce point de terminaison pour obtenir les valeurs `sender_id` nécessaires à l'envoi de messages WhatsApp via l'API Famulor.

### Paramètres de requête

<ParamField query="status" type="string" optional>
  Filtre les expéditeurs par statut. Par défaut : `online`. Utilisez `all` pour renvoyer tous les expéditeurs quel que soit leur statut.
</ParamField>

### Champs de réponse

<ResponseField name="data" type="array">
  <Expandable title="Propriétés de l'objet expéditeur">
    <ResponseField name="id" type="integer">
      L'identifiant unique de l'expéditeur WhatsApp. Utilisez cet ID pour envoyer des messages.
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Le numéro de téléphone de l'expéditeur au format E.164 (par ex. `+14155551234`)
    </ResponseField>

    <ResponseField name="display_name" type="string">
      Le nom d'affichage WhatsApp Business (nom commercial affiché aux destinataires)
    </ResponseField>

    <ResponseField name="status" type="string">
      Le statut actuel de l'expéditeur : `online` ou `offline`
    </ResponseField>

    <ResponseField name="quality_rating" type="string">
      La note de qualité Meta pour cet expéditeur : `GREEN`, `YELLOW` ou `RED`
    </ResponseField>

    <ResponseField name="messaging_limit" type="integer">
      La limite de messagerie actuelle (nombre de destinataires uniques par tranche de 24 heures). `null` signifie illimité.
    </ResponseField>

    <ResponseField name="messaging_limit_formatted" type="string">
      Limite de messagerie au format lisible (par ex. `1,000 / 24hr`, `10,000 / 24hr`, ou `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>

### Remarques

* Seuls les expéditeurs avec le statut `online` sont renvoyés par défaut. Utilisez `?status=all` pour inclure les expéditeurs hors ligne.
* Le statut de l'expéditeur est synchronisé automatiquement avec Meta toutes les 5 minutes.
* Le champ `id` est ce que vous devez transmettre en tant que `sender_id` lors de l'envoi de messages.
* La note de qualité affecte vos limites de messagerie. Une note `RED` peut restreindre votre capacité à envoyer des messages.

<Tip>
  Pages associées : [Introduction](/fr/api-v1/introduction) et [Guide d'authentification](/fr/api-v1/authentication), et [Exemples d'intégration API](/fr/api-v1/introduction).
</Tip>