Tâche (Task)

Introduction

La Tâche (Task) est la capacité de message proactif de l'Agent : c'est l'Agent qui engage la conversation avec l'utilisateur, au lieu d'attendre que celui-ci parle en premier.

Contrairement à une conversation classique, qui suit le schéma « l'utilisateur pose une question → l'Agent répond », une tâche fonctionne ainsi : « la plateforme, selon les conditions que vous avez définies, envoie un message à l'Agent à la place de l'utilisateur → l'Agent génère une réponse → la réponse est envoyée à l'utilisateur ». Le « message de déclenchement » que vous renseignez dans la tâche est en réalité une phrase envoyée à l'Agent au nom de l'utilisateur ; l'Agent génère une réponse comme s'il avait reçu un vrai message d'utilisateur, et ce que l'utilisateur final voit est la réponse de l'Agent, et non le message de déclenchement lui-même.

Cas d'usage typiques :

Prérequis

• Les tâches ne sont envoyées qu'aux utilisateurs ayant déjà eu une conversation avec l'Agent. Pour chaque utilisateur, la plateforme recherche la conversation « active le plus récemment » sur le canal cible et y injecte le message. Les utilisateurs sans historique de conversation ne reçoivent pas le message de la tâche (consigné comme NO_CONVERSATION dans le détail d'exécution).
• Si le canal cible est une intégration tierce (WhatsApp, Telegram, LINE, etc.), assurez-vous que l'intégration correspondante est correctement configurée et activée dans « Integrations » ; une intégration désactivée ou des identifiants expirés entraînent un échec d'envoi (CHANNEL_CONFIG_INVALID / CHANNEL_AUTH_FAILED).
• L'exécution d'une tâche fait appel au LLM de l'Agent pour générer la réponse et consomme donc normalement des crédits (Credits).

Accès

Accédez à Espace de développement → Agent → sélectionnez un Agent → menu de gauche « Tasks ».

La liste des tâches prend en charge : la recherche par nom de tâche, le filtrage par statut (Status), type de déclenchement (Trigger) et utilisateurs cibles (Target). Description des champs de la liste :

Créer une tâche

Cliquez sur New task en haut à droite, puis effectuez la configuration dans le panneau latéral droit.

1. Informations de base

Attention : la sélection de All users affiche une demande de confirmation, car cela revient à diffuser le message à l'ensemble des utilisateurs sur tous les canaux de cet Agent. Vérifiez impérativement que la plage des conversations cibles est correctement définie afin d'éviter tout envoi accidentel.

Canaux cibles pris en charge

Conseil : certains canaux ne prennent pas encore en charge l'envoi proactif côté serveur en raison des restrictions du protocole de la plateforme (par exemple Discord, DingTalk, SoBot) ; ils apparaissent grisés dans la liste déroulante des canaux avec l'indication du motif. Pour les canaux propres (Web / Widget, etc.), la réponse est directement écrite dans la conversation et l'utilisateur la verra à la prochaine ouverture de la fenêtre de dialogue ; pour les canaux de messagerie instantanée et les plateformes de service client, la réponse est envoyée proactivement à l'utilisateur via l'API de la plateforme correspondante.

2. Mode de déclenchement (Trigger)

Le mode de déclenchement détermine « quand envoyer ». Trois modes sont disponibles :

Actif - Déclenchement planifié (Active - Scheduled)

Déclenché proactivement par la plateforme selon le calendrier défini ; adapté aux diffusions périodiques et aux notifications uniques.

Les heures sont calculées selon le fuseau horaire sélectionné pour la tâche. Après sa création, une tâche planifiée est à l'état WAITING, puis passe à RUNNING une fois la première heure d'exécution atteinte ; une tâche Once passe automatiquement à COMPLETED une fois exécutée.

Actif - Déclenchement événementiel (Active - Event)

Déclenché par votre système métier via un appel Webhook à la plateforme ; adapté à l'intégration avec des événements métier tels que les commandes, les paiements ou les tickets.

Lors de la création de la tâche, sélectionnez la méthode d'authentification et renseignez les identifiants ; la plateforme génère automatiquement une URL de Webhook unique (consultable dans le détail de la tâche après création) :

Exemple d'appel Webhook

L'URL du Webhook est de la forme {domaine de la plateforme}/bot/proactive-task/webhook/{webhookPath} ; utilisez l'adresse complète affichée dans le détail de la tâche.

                      
                      POST {Webhook URL}
Content-Type: application/json
Authorization: Basic base64(username:password)

{
  "idempotency_key": "order-20260903-0001",
  "target": {
    "channel": "TELEGRAM",
    "user_id": "customer_123"
  },
  "variables": {
    "order_no": "SO-20260903-0001",
    "eta": "5 septembre"
  }
}

                    

Attention : une requête Webhook réussie signifie uniquement que la demande a été « reçue et placée dans la file d'envoi » ; consultez l'historique d'exécution pour connaître le résultat réel de l'envoi. Un échec d'authentification, une tâche arrêtée ou un canal cible hors du périmètre des canaux cibles de la tâche renvoient une erreur de permission. Chaque adresse de Webhook est limitée à 120 appels / minute.

Passif - Déclenchement utilisateur (Passive - User Triggered)

La plateforme analyse chaque minute l'ensemble des utilisateurs cibles ; les utilisateurs correspondant aux règles déclenchent l'envoi. Adapté à la réactivation des utilisateurs silencieux, à l'attention portée aux utilisateurs à forte valeur, etc.

Configuration des règles

Cliquez sur Add rule pour ajouter une règle ; entre plusieurs règles, vous pouvez choisir AND (toutes satisfaites) ou OR (au moins une satisfaite).

Remarque : les attributs utilisateur proviennent de « Gestion des variables → Attributs utilisateur » ; leur valeur est lue individuellement pour chaque utilisateur (la valeur par défaut de l'attribut est utilisée si l'utilisateur ne l'a pas définie), ce qui convient au filtrage par profil utilisateur. Les attributs personnalisés proviennent de « Gestion des variables → Variables personnalisées » ; il s'agit d'une valeur unique au niveau de l'Agent, identique pour tous les utilisateurs, adaptée aux conditions de type « interrupteur général ». Tous les champs de règle sont évalués sur la base de la conversation active le plus récemment de l'utilisateur sur le canal cible.

Limitation de fréquence des messages (Message Frequency)

Une tâche à déclenchement passif doit obligatoirement définir une limitation de fréquence : dans la fenêtre définie (N heures / N jours), un même utilisateur ne peut être déclenché qu'une seule fois par cette tâche, afin d'éviter de solliciter de manière répétée les utilisateurs qui continuent de correspondre aux règles.

Conseil : la date de la dernière conversation de l'utilisateur (User's last chat time) est une date « passée » ; utilisez donc les opérateurs de type « il y a plus de N unités ». Les opérateurs de type « dans N unités à partir de maintenant » ne s'appliquent qu'aux champs de date future (par exemple la date d'expiration d'un abonnement) et ne correspondront jamais s'ils sont utilisés sur la date de la dernière conversation.

3. Message de déclenchement (Message)

Renseignez le contenu du message à envoyer à l'Agent « au nom de l'utilisateur ». L'Agent génère une réponse à partir de ce message ainsi que de son propre prompt, de sa base de connaissances, etc., puis l'envoie à l'utilisateur.

Vous pouvez référencer les variables suivantes avec la syntaxe {{variable}} :

Exemples

• Diffusion planifiée : Résume-moi, sur un ton bref et convivial, les actualités importantes du secteur aujourd'hui.
• Réactivation d'un utilisateur silencieux : Je ne suis pas venu depuis plusieurs jours ; salue-moi spontanément et indique-moi les nouvelles fonctionnalités récentes.
• Notification événementielle : Ma commande {{event.variables.order_no}} a été expédiée, avec une livraison prévue le {{event.variables.eta}} ; communique-moi les informations de suivi et rappelle-moi de bien réceptionner le colis.

Conseil : le message de déclenchement est une question « du point de vue de l'utilisateur » destinée à l'Agent, et non un texte affiché directement à l'utilisateur. Si vous souhaitez que l'Agent le retransmette aussi fidèlement que possible, précisez-le explicitement dans le message, par exemple « Transmets tel quel à l'utilisateur : … ».

Après vérification, cliquez sur Create.

Attention : chaque Agent peut avoir au maximum 10 tâches simultanément à l'état WAITING / RUNNING ; au-delà, vous devez d'abord arrêter des tâches ou attendre que les tâches existantes se terminent.

Statut de la tâche

Consulter une tâche et l'historique d'exécution

Cliquez sur View dans la liste pour accéder au détail de la tâche, qui comporte deux onglets :

• Configuration : vue en lecture seule de la configuration de la tâche. Pour les tâches à déclenchement événementiel, vous pouvez y consulter l'URL du Webhook et les informations d'authentification.
• Execution History : enregistrement de chaque exécution, avec l'heure d'exécution, le nombre de cibles, le nombre de succès / échecs et le taux de réussite.

Cliquez sur une exécution pour afficher le détail d'exécution : statistiques de succès / échecs par canal, ainsi que chaque enregistrement d'envoi. Description des motifs d'échec :

Arrêter et supprimer

• Stop : les tâches à l'état WAITING / RUNNING / ERROR peuvent être arrêtées à tout moment ; elles passent alors à TERMINATED, de manière irréversible.
• Delete : seules les tâches à l'état COMPLETED / TERMINATED peuvent être supprimées ; la suppression efface également l'historique et le détail d'exécution.

Questions fréquentes

Q : Pourquoi la tâche s'exécute-t-elle avec succès alors que le contenu vu par l'utilisateur n'est pas le message de déclenchement que j'ai renseigné ?
Le message de déclenchement est une « question envoyée à l'Agent au nom de l'utilisateur » ; ce que l'utilisateur voit est la réponse générée par l'Agent à cette question. Si vous devez contrôler précisément le texte, demandez explicitement à l'Agent, dans le message de déclenchement, de le restituer tel quel.

Q : Les nouveaux utilisateurs reçoivent-ils les messages de tâche ?
Non. Les tâches ne sont envoyées qu'aux utilisateurs disposant déjà d'un historique de conversation, et la date de création de la conversation doit se situer dans la « plage des conversations cibles ».

Q : Pourquoi la tâche planifiée n'a-t-elle pas été envoyée exactement à l'heure prévue ?
Le planificateur effectue une analyse chaque minute, et les envois en grand volume sont répartis par lots selon la limite de débit au niveau du projet ; l'heure de réception réelle peut donc être légèrement décalée.

Q : Le Webhook renvoie une erreur de permission (Permission deny) ?
Vérifiez successivement : que l'URL du Webhook est correcte, que les identifiants d'authentification correspondent, que la tâche n'a pas été arrêtée, et que le target.channel de la requête fait bien partie des canaux cibles configurés pour la tâche.