# Formulaires

> Colle l'adresse de ton agent dans ton outil de formulaire : quand quelqu'un laisse son numéro, l'agent lui écrit en premier sur WhatsApp.

Source: https://docs.whatsetter.com/fr/dashboard/forms/

Quelqu'un laisse son numéro dans l'un de tes formulaires, et ton agent lui
écrit en premier sur WhatsApp. La page **Formulaires** donne l'adresse de
chaque agent : tu la colles une fois dans ton outil de formulaire.

## À quoi sert la page Formulaires

Ouvre **Formulaires** dans le menu, sous **Prospecter**. Quelqu'un remplit
l'un de tes formulaires, sur ton site, une page de vente ou une publicité, et
laisse son numéro de téléphone. Après un court délai, 3 minutes par défaut,
ton agent lui écrit en premier sur WhatsApp. La personne n'a rien à cliquer.

Cela fonctionne avec une adresse. Chaque agent en a une. Tu la colles une fois
dans ton outil de formulaire, et chaque nouvelle réponse que l'outil reçoit
est transmise à l'agent. Cette adresse s'appelait auparavant l'URL du webhook.

Rien ne se crée sur cette page : elle liste tes agents, dit lesquels sont
prêts, et te laisse copier leur adresse.

C'est l'une des trois façons dont un contact arrive chez un agent, avec les
[liens](/fr/dashboard/tracked-links/), où la personne clique et écrit en
premier, et les [listes](/fr/dashboard/lists/), où tu importes les contacts.

## Trouver et copier l'adresse d'un agent

Ouvre **Formulaires**. Sous **L’adresse de chaque agent**, chaque agent est
une ligne avec un bouton **Copier l’adresse**.

Clique sur une ligne pour l'ouvrir. L'adresse complète apparaît sous
**Adresse à coller dans ton outil de formulaire**, avec un bouton **Copier**,
le **Délai du premier message** et un lien **Voir le premier message**.

L'adresse est sur le domaine de ton tableau de bord et se termine par `/f/`
suivi d'un code propre à l'agent, par exemple `https://app.whatsetter.com/f/k3x9…`.
C'est ce code qui la rend privée : ne la colle que dans ton outil de
formulaire.

Il y a une adresse par agent : ce qui arrive à cette adresse est pour lui. Un
agent a son adresse dès le jour de sa création. Les agents qui ne sont pas
encore actifs sont rangés sous **Brouillons** : ils ont déjà leur adresse,
mais n'écrivent à personne tant qu'ils ne sont pas actifs. Les agents qui
suivent des groupes ne sont pas listés.

Si la page indique « Crée d’abord un agent », vois
[Créer ton agent IA](/fr/getting-started/agent/).

## Coller l'adresse dans ton outil de formulaire

Dans ton outil de formulaire, cherche le mot « webhook » : c'est là que va
l'adresse. L'outil doit envoyer chaque réponse à l'adresse avec la méthode
POST. La page **Formulaires** indique où la coller, sous
**Où coller l’adresse** :

| Outil | Où va l'adresse |
|---|---|
| Typeform | Connect, puis Webhooks, puis « Add a webhook ». |
| Tally | Intégrations, puis Webhooks. |
| Systeme.io | Formulaire, Paramètres, puis « URL Webhook ». |
| HubSpot | Formulaire, Intégrations, puis « Ajouter un webhook ». |
| Zapier ou Make | Ajoute une action « Webhook » qui envoie un POST vers l'adresse. À utiliser pour les formulaires de tes publicités sur les réseaux sociaux. |

Colle l'adresse de l'agent qui doit écrire à ces personnes. Un formulaire
envoie vers un agent. Une réponse de plus de 1 Mo est refusée, et une adresse
qui reçoit plus de 60 réponses en une minute refuse les suivantes un court
moment.

## Recevoir les contacts de tes publicités Facebook et Instagram

Les formulaires de publicité de Facebook et d'Instagram (les Lead Ads) n'ont pas de champ webhook : ils passent par Zapier ou Make. Ton agent écrit ensuite en premier à chaque personne qui laisse son numéro.

1. Ouvre **Formulaires** et copie l'adresse de l'agent qui doit écrire à ces personnes.
2. Dans Zapier ou Make, crée un scénario qui démarre à chaque nouveau contact de ton formulaire de publicité.
3. Ajoute une action « Webhook » qui envoie un POST vers l'adresse de ton agent, avec le numéro de téléphone et le prénom.

## Changer l'adresse d'un agent partagée par erreur

Si l'adresse d'un agent a circulé là où elle ne devait pas, change-la : la
nouvelle remplace l'ancienne.

1. Ouvre **Formulaires** et clique sur la ligne de l'agent.
2. À côté de **Adresse partagée par erreur ?**, clique sur **Changer d’adresse**.
3. Confirme avec **Nouvelle adresse**. **Annuler** ne change rien.
4. Copie la nouvelle adresse et colle-la dans ton outil de formulaire, à la place de l'ancienne.

L'ancienne adresse cesse de marcher tout de suite : les formulaires qui
l'utilisent encore n'arrivent plus. Il te faut le droit
**Connecter des outils (calendrier, liens, Instagram)**.

## Quels champs ton formulaire doit envoyer

Aucun format n'est imposé : tes champs gardent leur nom. WhatSetter lit les
réponses et y trouve ce qu'il lui faut. La page **Formulaires** le résume sous
**Ce que ton formulaire envoie** :

| Champ | Nécessaire ? | À quoi il sert |
|---|---|---|
| Le numéro de téléphone | Obligatoire | Le numéro auquel l'agent écrit. |
| Le prénom | Conseillé | L'agent salue la personne par son prénom. |
| Toutes les autres réponses | Facultatif | Email, besoin, budget : l'agent les lit et s'en sert dans son premier message. |

Exemple de ce qu'un outil envoie :

```json
{
  "prénom": "Camille",
  "téléphone": "+33 6 12 34 56 78",
  "besoin": "Refaire ma cuisine"
}
```

Sans numéro de téléphone, l'agent ne peut pas écrire, et rien n'est créé.

## Quel format de numéro envoyer

Envoie le numéro avec l'indicatif du pays : `+33 6 12 34 56 78` ou
`0033 6 12 34 56 78`. Un numéro qui commence par `+` ou `00` est utilisé tel
quel. C'est le format le plus sûr. Les espaces, les points, les tirets et les
parenthèses ne comptent pas.

Un numéro envoyé sans indicatif est deviné d'après sa forme, et la lecture
peut être fausse :

- 10 chiffres qui commencent par 0 sont lus comme un numéro français ;
- 11 chiffres qui commencent par 0 sont lus comme un numéro britannique ;
- 10 chiffres qui ne commencent pas par 0 sont lus comme un numéro des États-Unis ou du Canada.

Les autres formats locaux peuvent être lus dans le mauvais pays, et le message
ne part alors nulle part. Quand ton formulaire sert dans un seul pays, fais
demander l'indicatif par le champ téléphone, ou ajoute-le dans ton outil
avant l'envoi.

## Quel agent reçoit le contact

L'agent dont l'adresse a reçu le formulaire. Il n'y a pas de liste à choisir
ni rien à attribuer : une adresse appartient à un agent, et cet agent écrit
depuis son propre numéro WhatsApp, avec son propre premier message.

- Pour envoyer deux formulaires à deux agents différents, colle une adresse différente dans chaque formulaire.
- Pour envoyer plusieurs formulaires au même agent, colle la même adresse dans tous.
- Un contact arrivé par un formulaire n'apparaît pas dans **Listes**. Une fois que l'agent a écrit, la personne est dans [Conversations](/fr/dashboard/conversations/) et dans [Leads](/fr/dashboard/leads/), comme tout autre lead.

Un formulaire reçoit sa réponse une personne à la fois, après le délai réglé
sur l'agent. Pour choisir toi-même le rythme, les jours et les horaires,
importe plutôt les contacts dans une [liste](/fr/dashboard/lists/).

## Quand l'agent écrit après un formulaire, et ce qu'il écrit

Ouvre **Formulaires** et clique sur la ligne d'un agent.
**Délai du premier message** est le temps entre le formulaire et le premier
message de l'agent. Il est de 3 minutes au moins. Clique sur **Modifier** pour
le changer : tu arrives dans l'onglet **Réglages** de l'agent, section
**Envoi**, où les choix sont 3, 10 ou 30 minutes, ou 1, 2, 4, 8 ou 24 heures.

**Ce que l’agent écrit** est son premier message, écrit pour chaque personne à
partir du prompt de l'agent et des réponses du formulaire. Clique sur
**Voir le premier message** pour le lire ou le changer dans l'onglet
**Prompt** de l'agent, sous **Premier message**.

Le message peut partir un peu après le délai quand le numéro vient d'écrire à
quelqu'un d'autre : les premiers messages sont espacés pour protéger le
numéro. Vois [Comment on protège ton numéro](/fr/dashboard/anti-ban/).

## Ce que veut dire chaque statut de la page Formulaires

Ouvre **Formulaires**. La ligne du haut compte les agents prêts à recevoir tes
formulaires, et chaque agent a un statut :

| Statut | Ce que ça veut dire |
|---|---|
| **Prêt** | L'agent est actif et son numéro fonctionne. Sa ligne dit au bout de combien de temps il écrit. |
| **À vérifier** | L'agent est actif, mais son numéro est déconnecté, attend d'être reconnecté, ou manque. Ouvre la ligne et clique sur **Reconnecter** ou **Connecter un numéro** : la page **Numéros WhatsApp** s'ouvre, avec la fenêtre de connexion de cet agent pour **Reconnecter**. |
| **En pause** | Un formulaire reçu ne déclenche aucun message. Clique sur **Ouvrir l’agent** pour le relancer. |
| **Brouillon** | L'agent n'est pas encore actif : un formulaire reçu ne déclenche aucun message. |

Les formulaires reçus pendant qu'un agent est en pause ou en brouillon ne sont
pas gardés : personne ne reçoit de message plus tard. Un formulaire reçu
pendant que le numéro d'un agent actif est déconnecté attend, et le premier
message part après la reconnexion.

## Tester un formulaire

1. Ouvre **Formulaires** et vérifie que l'agent indique **Prêt**.
2. Remplis ton propre formulaire, comme le ferait un visiteur, avec un numéro WhatsApp auquel cet agent n'a jamais écrit. Écris le numéro avec l'indicatif du pays.
3. Attends le **Délai du premier message**, 3 minutes au moins.
4. Regarde WhatsApp sur ce téléphone : le premier message de l'agent arrive. Dans l'application, la personne apparaît dans [Conversations](/fr/dashboard/conversations/).

Utilise un nouveau numéro pour chaque test. La page **Formulaires** énonce la
règle : « Une personne que cet agent a déjà contactée ne reçoit pas un second
premier message. » Un second test avec le même numéro n'est donc pas un test
valable.

Pour lire ce que l'agent écrirait sans rien envoyer, utilise l'onglet
**Tester** de l'agent : vois [Tester ton agent](/fr/dashboard/playground/).

## Pourquoi un formulaire rempli n'envoie aucun message

Ouvre **Formulaires** et vérifie ces causes dans l'ordre :

1. L'agent est **En pause** ou en **Brouillon** : les formulaires sont ignorés tant qu'il n'est pas actif.
2. Le formulaire n'a envoyé aucun numéro, ou un numéro illisible. Envoie-le avec l'indicatif du pays.
3. Le numéro n'est pas sur WhatsApp : rien n'est envoyé.
4. Cet agent a déjà écrit à cette personne. La page énonce la règle : « Une personne que cet agent a déjà contactée ne reçoit pas un second premier message. » C'est la cause habituelle quand tu testes deux fois avec le même numéro.
5. Le message est en route : il part après le **Délai du premier message**, 3 minutes au moins.
6. Le numéro de l'agent est déconnecté (statut **À vérifier**) : le contact attend, et le message part après la reconnexion.
7. Les messages du mois de ton forfait sont épuisés, ou le compte est suspendu après un paiement échoué : vois [Abonnement](/fr/dashboard/billing/).
8. L'adresse dans ton outil de formulaire n'est pas celle affichée sur la page **Formulaires**, par exemple parce qu'elle a été changée avec **Changer d’adresse**, ou l'outil n'envoie pas avec la méthode POST.

## Envoyer tes leads vers un autre outil, le sens inverse

La page **Formulaires** reçoit des contacts. Pour faire l'inverse et envoyer
tes leads qualifiés vers ton CRM ou un autre outil, utilise le lien
**Ouvrir API et MCP** en bas de la page : il ouvre cette partie de
**Paramètres**.

Pour les développeurs, deux pages vont plus loin.
[Webhooks signés](/fr/developers/webhooks/) décrit ce que WhatSetter envoie à
tes outils quand il arrive quelque chose à un lead.
[API : campagnes](/fr/developers/guides/campaigns/) montre comment confier un
contact à un agent depuis ton propre code, au lieu d'un outil de formulaire.

## Qui peut ouvrir la page Formulaires

L'entrée **Formulaires** du menu et sa page n'apparaissent que pour les
personnes qui ont le droit
**Connecter des outils (calendrier, liens, Instagram)**. **Propriétaire** et
**Admin** l'ont. Les autres rôles ne l'ont pas, sauf si tu leur donnes ce
droit dans un rôle **Sur mesure**.

Copier une adresse ne demande rien de plus. Changer le délai ou le premier
message se fait dans l'agent, et demande le droit de modifier les agents.

Les rôles et les droits se règlent dans [Équipe](/fr/dashboard/team/).

## Voir aussi

- [Liens traqués](/fr/dashboard/tracked-links/)
- [Listes et import](/fr/dashboard/lists/)
- [Le prompt de ton agent](/fr/dashboard/prompt/)
- [API : campagnes](/fr/developers/guides/campaigns/)
