# Connexions WhatsApp

Enregistrer l'entreprise de votre client, puis connecter son compte WhatsApp Business et ses numéros.

## Enregistrer une entreprise cliente (propriétaire futur d’un compte WhatsApp Business)

`POST /connected-businesses`

Authentification : clé API, ou session de la console avec X-Environment-Id · portée : connections:manage

Corps (JSON) :

| Champ | Type | | Description |
|---|---|---|---|
| `name` | string | requis | Nom de l'entreprise de votre client (2 à 120 caractères). |
| `externalRef` | string | optionnel | Votre propre identifiant de ce client |

```bash
curl -X POST "$INBOX_API/connected-businesses" \
  -H "Authorization: Bearer $INBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Cabinet Dentaire Zokem",
    "externalRef": "client-42"
  }'
```

Réponse 201 :

```json
{
  "id": "39e2803f-79e7-4e99-8da0-1c15991f5985",
  "name": "Cabinet Dentaire Zokem",
  "externalRef": "client-42",
  "createdAt": "2026-11-12T08:33:45.469Z"
}
```

## Lister les entreprises de l'environnement de la clé

`GET /connected-businesses`

Authentification : clé API, ou session de la console avec X-Environment-Id · portée : connections:read

```bash
curl "$INBOX_API/connected-businesses" \
  -H "Authorization: Bearer $INBOX_KEY"
```

Réponse 200 :

```json
[
  {
    "id": "39e2803f-79e7-4e99-8da0-1c15991f5985",
    "name": "Cabinet Dentaire Zokem",
    "externalRef": "client-42",
    "createdAt": "2026-11-12T08:33:45.469Z"
  }
]
```

## Terminer l'Embedded Signup : connecter le compte et le numéro WhatsApp Business

`POST /connected-businesses/{businessId}/waba-connections`

Authentification : clé API, ou session de la console avec X-Environment-Id · portée : connections:manage

Paramètres :

| Nom | Emplacement | Type | Description |
|---|---|---|---|
| `businessId` | path | string |  |

Corps (JSON) :

| Champ | Type | | Description |
|---|---|---|---|
| `code` | string | requis | Code renvoyé par l'Embedded Signup (usage unique, bref) |
| `wabaId` | string | requis | Identifiant du compte WhatsApp Business (WABA) renvoyé par l'inscription intégrée. Chiffres uniquement. |
| `phoneNumberId` | string | requis | Identifiant du numéro WhatsApp renvoyé par l'inscription intégrée. Chiffres uniquement. |
| `mode` | string | optionnel | `cloud_api` (défaut), ou `coexistence` si le client garde l'application WhatsApp Business sur son téléphone. |

```bash
curl -X POST "$INBOX_API/connected-businesses/BUSINESS_ID/waba-connections" \
  -H "Authorization: Bearer $INBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "AQBx7…",
    "wabaId": "102290129340398",
    "phoneNumberId": "106540352242922",
    "mode": "cloud_api"
  }'
```

Réponse 201 :

```json
{
  "id": "b76a1f98-53d6-4078-8d28-6406482daabb",
  "wabaId": "102290129340398",
  "status": "active",
  "mode": "cloud_api",
  "phoneNumber": {
    "id": "4d8e654e-d744-4bf3-8211-9ceffcccfe87",
    "phoneNumberId": "106540352242922",
    "displayNumber": "+237 6 52242922",
    "verifiedName": "Cabinet Test",
    "qualityRating": "GREEN"
  }
}
```

## Comptes et numéros connectés d'une entreprise

`GET /connected-businesses/{businessId}/phone-numbers`

Authentification : clé API, ou session de la console avec X-Environment-Id · portée : connections:read

Paramètres :

| Nom | Emplacement | Type | Description |
|---|---|---|---|
| `businessId` | path | string |  |

```bash
curl "$INBOX_API/connected-businesses/BUSINESS_ID/phone-numbers" \
  -H "Authorization: Bearer $INBOX_KEY"
```

Réponse 200 :

```json
[
  {
    "id": "b76a1f98-53d6-4078-8d28-6406482daabb",
    "wabaId": "102290129340398",
    "status": "active",
    "mode": "cloud_api",
    "phoneNumbers": [
      {
        "id": "4d8e654e-d744-4bf3-8211-9ceffcccfe87",
        "phoneNumberId": "106540352242922",
        "displayNumber": "+237 6 52242922",
        "verifiedName": "Cabinet Test",
        "qualityRating": "GREEN"
      }
    ]
  }
]
```