---
title: Déployer sur WhatsApp
description: >-
  Répondez sur un numéro WhatsApp Business avec un agent texte via la Meta Cloud
  API : créez le déploiement, puis connectez l'identifiant de numéro et le
  jeton.
---
<Badge variant="accent">Agents textuels</Badge>

Un déploiement WhatsApp *répond sur un numéro WhatsApp Business via la Meta
Cloud API*. Les clients écrivent au numéro ; l'agent répond, et chaque numéro qui
écrit correspond à une conversation.

:::note[Avant de commencer]
Vous avez besoin d'un agent texte publié et d'une application développeur Meta
avec **WhatsApp** ajouté, ce qui vous fournit un phone number id (identifiant de
numéro de téléphone) et un jeton d'accès. Le numéro doit être enregistré pour la
Cloud API et ne peut pas être utilisé en même temps par l'application WhatsApp
Business sur un téléphone.
:::

## Créer le déploiement

1. **Start the wizard**

    Sous **Launch AI Text** (lancer l'IA texte), choisissez **New Deployment**
    (nouveau déploiement), puis **WhatsApp**. Ce choix fait passer l'assistant
    directement à l'étape de l'agent.

2. **Pick the agent**

    Choisissez l'agent texte sous **Agent**. **Next** (suivant).

3. **Name it**

    Acceptez ou modifiez le **Display Name** (nom affiché), puis
    **Create Deployment** (créer le déploiement). Le déploiement apparaît dans la
    liste avec la mention **Needs setup** (configuration requise) et une
    **Webhook URL** (URL du webhook).

![L'étape de l'agent dans New Deployment pour WhatsApp.](/media/deploy/new-deployment-whatsapp.webp)

## Connecter WhatsApp

Ouvrez le déploiement et saisissez ce que fournit l'application Meta : le
**phone number id**, un **access token** (jeton d'accès) permanent pour un
utilisateur système disposant de l'autorisation
`whatsapp_business_messaging`, et un **verify token** (jeton de vérification) de
votre choix. Dans la configuration WhatsApp de l'application Meta, définissez la
**callback URL** (URL de rappel) du webhook sur la **Webhook URL** du
déploiement, collez le même verify token et abonnez-vous au champ `messages`.

## Comportement et limites

- WhatsApp autorise une entreprise à répondre uniquement dans les 24 heures
  suivant le dernier message du client ; en dehors de cette fenêtre, une réponse
  nécessite un modèle approuvé. L'agent répond aux messages entrants, qui se
  situent toujours dans la fenêtre.
- Un numéro en mode test ne peut écrire qu'aux destinataires que vous listez dans
  l'application Meta. Effectuez la vérification d'entreprise de Meta avant de
  l'ouvrir aux clients.

## Vérifier

- Le déploiement affiche **Active** (actif).
- Écrivez au numéro depuis un téléphone. L'agent répond et l'échange apparaît
  sous **Conversations** avec la plateforme `whatsapp`.

## Dépannage

- **Meta ne parvient pas à vérifier la callback URL.** Le verify token diffère
  entre Meta et le déploiement, ou le déploiement n'a pas été enregistré au
  préalable.
- **Les messages arrivent mais les réponses échouent.** L'access token a expiré
  (les jetons temporaires durent 24 heures) ou ne dispose pas de l'autorisation
  de messagerie. Utilisez un jeton d'utilisateur système.
- **Seuls certains téléphones reçoivent des réponses.** Le numéro est encore en
  mode test avec une liste de destinataires.

## Voir aussi

- [Présentation des déploiements de bots](/fr/deploy/bot-deployments/overview)
- [Conversations](/fr/operate/conversations)