> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# WhatsApp

Les channels WhatsApp permettent à un agent Mastra de recevoir les messages des clients via WhatsApp Business Cloud. Mastra gère le câblage de l’agent et la route de webhook ; la documentation de l’adaptateur WhatsApp de Chat SDK couvre la configuration de l’application Meta, les identifiants et la configuration du webhook.

## Installer l’adaptateur

Installez l’adaptateur WhatsApp depuis Chat SDK :

**npm**:

```bash
npm install @chat-adapter/whatsapp
```

**pnpm**:

```bash
pnpm add @chat-adapter/whatsapp
```

**Yarn**:

```bash
yarn add @chat-adapter/whatsapp
```

**Bun**:

```bash
bun add @chat-adapter/whatsapp
```

## Configuration de l’agent

Ajoutez `createWhatsAppAdapter()` à l’objet `channels.adapters` de l’agent :

```typescript
import { Agent } from '@mastra/core/agent'
import { createWhatsAppAdapter } from '@chat-adapter/whatsapp'

export const whatsappAgent = new Agent({
  id: 'whatsapp-agent',
  name: 'WhatsApp Agent',
  instructions: 'Answer customer questions and help with tasks in WhatsApp.',
  model: 'openai/gpt-5.6-sol',
  channels: {
    adapters: {
      whatsapp: createWhatsAppAdapter(),
    },
  },
})
```

Enregistrez l’agent dans l’instance Mastra :

```typescript
import { Mastra } from '@mastra/core'
import { whatsappAgent } from './agents/whatsapp-agent'

export const mastra = new Mastra({
  agents: { whatsappAgent },
})
```

## Configuration de l’adaptateur

Suivez la [documentation de l’adaptateur WhatsApp de Chat SDK](https://chat-sdk.dev/adapters/official/whatsapp) pour la configuration propre à WhatsApp, notamment celle de l’application Meta, les tokens d’accès, les ID de numéros de téléphone, la vérification de webhook et les limites de messages.

L’adaptateur lit les identifiants WhatsApp depuis des variables d’environnement telles que :

```bash
WHATSAPP_ACCESS_TOKEN=your-meta-access-token
WHATSAPP_APP_SECRET=your-meta-app-secret
WHATSAPP_PHONE_NUMBER_ID=your-whatsapp-phone-number-id
WHATSAPP_VERIFY_TOKEN=your-webhook-verify-token
```

## URL du webhook

Mastra génère la route de webhook WhatsApp à partir de l’ID de l’agent et de la clé de l’adaptateur :

```text
/api/agents/whatsapp-agent/channels/whatsapp/webhook
```

Utilisez l’URL publique de votre serveur Mastra comme URL de base :

```text
https://your-app.example.com/api/agents/whatsapp-agent/channels/whatsapp/webhook
```

Utilisez cette URL pour la livraison des événements WhatsApp entrants. La route Mastra générée gère les événements POST provenant de WhatsApp ; suivez la documentation de l’adaptateur WhatsApp de Chat SDK pour le flux de rappel Meta et de vérification du webhook.

## Pages connexes

- [Présentation de Channels](https://mastra.zisheng.pro/fr/docs/capabilities/channels/overview)
- [Autres adaptateurs](https://mastra.zisheng.pro/fr/docs/capabilities/channels/other-adapters)