> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Outils intégrés

> Donner aux assistants des actions sûres pour les appels, les messages, la prise de rendez-vous et la collecte de données

Les outils intégrés permettent à un assistant d'effectuer des actions approuvées pendant une conversation. Configurez-les sous **Assistant → Tools** et décrivez clairement dans quelles situations chaque outil peut être utilisé.

Si un outil est indisponible ou mal configuré, l'assistant reçoit un résultat d'échec sûr et peut poursuivre la conversation.

## Outils disponibles

| Outil                     | Fonction                                                                                      |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| **End call**              | Termine l'appel une fois que l'assistant a traité la demande et pris congé                    |
| **Call transfer**         | Transfère l'appelant vers un numéro de téléphone configuré                                    |
| **Warm call transfer**    | Informe un collègue avant de mettre l'appelant en relation                                    |
| **Transfer to assistant** | Confie l'appel en cours à un autre assistant du même espace de travail                        |
| **Send SMS**              | Envoie un SMS à l'appelant ou à un numéro configuré                                           |
| **Send email**            | Envoie un e-mail fixe, basé sur un modèle, ou rédigé par l'assistant                          |
| **Business hours**        | Vérifie un planning hebdomadaire d'horaires d'ouverture dans le fuseau horaire de l'assistant |
| **Schedule callback**     | Confirme un rappel futur et l'ajoute sous **Audience → Scheduled Callbacks**                  |
| **Collect payment card**  | Capture de façon sécurisée un moyen de paiement dans votre compte de paiement connecté        |
| **Set call variable**     | Enregistre une valeur pour les conditions de flux, outils, e-mails et webhooks ultérieurs     |

La disponibilité et la prise de rendez-vous de calendrier se configurent via [Calendrier et prise de rendez-vous](/fr/assistants/calendar-booking). La saisie au clavier se configure avec un nœud **Collect** dans le [Flow Builder](/fr/flow-builder/overview).

## Transferts

### Transfert téléphonique

Choisissez une destination, le type de transfert (à froid ou à chaud), et la condition dans laquelle l'assistant doit transférer — décrivez-la de façon aussi détaillée que possible, car une formulation précise rend le déclencheur plus fiable. Vous pouvez aussi laisser l'assistant déterminer dynamiquement le numéro de destination plutôt que de le fixer.

**Cold transfer** met l'appelant directement en relation avec la destination. Définissez un délai de sonnerie (15 à 80 secondes, 30 par défaut) avant que la tentative soit considérée comme sans réponse.

**Warm transfer** informe un collègue avant de mettre l'appelant en relation — utilisez-le chaque fois que le destinataire a besoin de contexte au préalable. Il nécessite quelques réglages supplémentaires :

| Réglage                  | Utilité                                                                                     |
| ------------------------ | ------------------------------------------------------------------------------------------- |
| Outbound number          | Un numéro de l'espace de travail avec un trunk sortant, utilisé pour appeler le superviseur |
| Hold music               | Diffusée à l'appelant pendant que le superviseur est briefé                                 |
| Hold message             | Prononcée à l'appelant juste avant sa mise en attente                                       |
| Briefing initial message | La première chose que dit l'assistant dès que le superviseur décroche                       |
| Summary instructions     | Ce que l'assistant doit indiquer au superviseur à propos de l'appel                         |
| Connected message        | Prononcée à l'appelant une fois le superviseur mis en relation                              |
| Ringing timeout          | 5 à 120 secondes (30 par défaut) avant que la tentative expire                              |

**Fallback on failure** détermine ce qui se passe si le collègue ne décroche pas : l'assistant poursuit la conversation lui-même et propose des alternatives, prend congé et met fin à l'appel, ou met l'appelant directement en relation avec un numéro de repli sans briefing.

### Transfert vers un autre assistant

Confiez un appel en cours à un autre assistant du même espace de travail — utile pour le routage par langue (détecter la langue de l'appelant, transférer vers un assistant spécialisé dans cette langue), un parcours de conformité ou de consentement différent (basculer vers un assistant configuré avec un autre réglage d'enregistrement), ou pour enchaîner des assistants spécialisés (ventes → intégration, tri → expert) sans provisionner un numéro distinct pour chaque étape.

Choisissez l'assistant cible et un **Context Engineering Plan** — la quantité de conversation qu'il reçoit. Les options vont de l'historique complet des messages jusqu'à un résumé accompagné des derniers messages (recommandé), aux derniers messages seuls, à un simple résumé, ou à aucun contexte préalable pour une passation propre. Vous pouvez éventuellement définir un **message before transfer**, et choisir si l'assistant cible prononce son propre message initial une fois qu'il prend la main.

La vue **Squad** affiche le graphe de routage entre assistants qui en résulte. Les transferts vers le même assistant sont refusés, et une limite de transferts empêche les boucles.

## Mettre fin à l'appel

Rédigez la description de **End call** aussi clairement que si vous l'expliquiez à un nouvel employé — l'outil ne se déclenche que lorsque sa condition correspond réellement :

* **Simple** — mettre fin à l'appel une fois que toutes les questions ont reçu une réponse et que l'appelant n'a plus besoin d'aide.
* **More detailed** — mettre fin également après une réservation réussie, une fois que l'appelant a pris congé, ou une fois que la conversation est clairement terminée.

Couvrez les cas réalistes que vous anticipez (succès, au revoir, « je n'ai besoin de rien d'autre ») afin que l'assistant ne raccroche ni trop tôt, ni ne prolonge inutilement un appel terminé.

## SMS et e-mail

Pour le SMS, choisissez si le destinataire est l'appelant ou un numéro E.164 fixe. L'assistant doit utiliser un numéro de l'espace de travail avec la messagerie sortante activée.

Pour l'e-mail, choisissez un expéditeur vérifié et l'un des trois modes de contenu :

* **Assistant-written** — génère l'objet et le corps du message à partir de la conversation.
* **Fixed** — envoie toujours exactement le contenu configuré.
* **Template** — insère les variables d'appel et s'arrête si une valeur requise est manquante.

Un envoi réussi signifie que le message a été accepté pour livraison ; cela ne garantit pas sa réception dans la boîte de réception ou sur l'appareil final.

## Horaires et rappels

Les horaires d'ouverture peuvent contenir une ou plusieurs plages horaires pour chaque jour de la semaine. La vérification utilise toujours le fuseau horaire configuré de l'assistant.

Pour les rappels, choisissez la destination et le nombre maximal de jours à l'avance que les clients peuvent réserver. L'assistant doit répéter l'heure convenue et obtenir une confirmation. Les dates passées et les dates en dehors de la période autorisée sont refusées.

## Collecte d'une carte de paiement

Connectez votre compte de paiement sous **Tools → [Agent Connectors](/fr/assistants/agent-tools#agent-connectors)**, puis ajoutez **Collect payment card** à l'assistant ou à un nœud Collect d'un flux. L'appelant saisit ses données de carte de façon sécurisée. Famulor n'expose jamais le numéro de carte complet ni le code de sécurité dans l'historique des conversations.

N'utilisez cette fonctionnalité que là où votre base légale, votre parcours de consentement et vos autorisations de compte le permettent.

<Note>
  La collecte d'une carte de paiement consomme des crédits supplémentaires, au tarif **Card collection** de l'espace de travail ; les tarifs actuels figurent sur la [page Usage](https://app.famulor.io/usage).
</Note>

## Variables d'appel et heure actuelle

**[Set call variable](/fr/assistants/variables)** permet à l'assistant d'enregistrer des valeurs approuvées, comme un nom d'entreprise ou une préférence de rendez-vous. Limitez les clés autorisées lorsque l'assistant ne doit mettre à jour que certains champs précis.

Chaque assistant dispose aussi d'un outil d'heure actuelle. Il utilise le fuseau horaire de l'assistant pour résoudre des demandes comme « demain à 15 h » ou « mardi prochain ».

## API et MCP

Les outils intégrés peuvent être gérés via `PATCH /api/v1/assistants/{id}` et les outils d'assistant dans [MCP](/fr/api/mcp). Utilisez `GET /api/v1/email-senders` ou son équivalent MCP pour lister les expéditeurs vérifiés sans exposer les identifiants.