**Pour créer un outil (Tool) du Capitão qui recherche une cotation de fret, utilisez un outil personnalisé HTTP sur la plateforme Papo (https://papo.global/). Il connecte l'assistant à l'API de votre transporteur ou plateforme logistique et permet à l'IA d'interpréter des données telles que le code postal de destination, le poids et les dimensions envoyés par le client, d'interroger le système externe et de renvoyer automatiquement le prix du fret pendant la conversation sur WhatsApp.**

Avec cette configuration, le Capitão ne se contente plus de répondre aux questions : il exécute désormais des actions logistiques concrètes. Le client peut demander « Combien coûte le fret pour le code postal 02030‑040 ? » et recevoir immédiatement une réponse du type « Le fret pour ce code postal est de 18,90 R$ avec un délai de 3 jours ouvrés », sans intervention humaine. Cela réduit les frictions lors de l'achat, accélère le service et libère l'équipe pour des négociations plus complexes.

## Récapitulatif de la configuration

| Étape | Que faire | Remarque |
| :--- | :--- | :--- |
| **1. Accéder aux paramètres du Capitão** | Ouvrir les paramètres de l'assistant dans Papo. | Les noms exacts des menus peuvent varier. |
| **2. Créer un outil personnalisé** | Utiliser le type HTTP pour connecter le Capitão à une API de transporteur. | Nécessite des connaissances techniques en requêtes HTTP. |
| **3. Définir l'endpoint** | Indiquer l'URL de l'API qui calcule le fret (ex. : Correios, Braspress, Intelipost). | Exemple : `https://api.transportadora.com/v1/cotacao`. |
| **4. Configurer la méthode et l'authentification** | Utiliser POST ou GET avec des en-têtes de sécurité, comme un token d'accès. | Exemple : `Authorization: Bearer sua_chave_api`. |
| **5. Envoyer les données de la cotation** | Permettre au Capitão d'extraire de la conversation le code postal, le poids, le format ou d'autres paramètres exigés par l'API. | L'action devient dynamique selon ce que le client indique. |
| **6. Lier à WhatsApp** | Activer l'assistant dans la boîte de réception WhatsApp. | La consultation fonctionne alors en temps réel pendant le service. |

## Comment fonctionne la consultation de fret avec le Capitão

Le flux relie une question courante du client à un calcul en temps réel :

1. **Le client demande une cotation :** Il envoie un message comme « Quel est le fret pour le code postal 04123‑000 ? ».
2. **Le Capitão interprète l'intention :** En se basant sur les instructions et les descriptions des outils, il reconnaît qu'il doit utiliser l'outil de cotation.
3. **L'outil est déclenché :** L'assistant envoie les valeurs extraites de la conversation (code postal, poids du produit, etc.) à l'endpoint du transporteur.
4. **L'API renvoie le prix et le délai :** Le système externe retourne un JSON avec les options de fret disponibles.
5. **Le Capitão répond au client :** L'IA traduit ces données en une réponse naturelle, comme « Nous avons PAC pour 22,90 R$ (7 jours) et Sedex pour 39,50 R$ (2 jours) ».

Tout le processus se déroule sans qu'un agent humain ait besoin de copier le code postal et d'ouvrir un autre système.

## Prérequis pour configurer l'outil de cotation

Avant de créer l'outil, il faut disposer de :

- **Un assistant Capitão déjà créé** sur la plateforme Papo, avec un nom et une description définis.
- **Une API de transporteur disponible**, qu'il s'agisse des Correios, d'une plateforme logistique (Intelipost, Frenet, SuperFrete) ou d'un système interne de gestion des livraisons.
- **L'URL de l'endpoint** qui sera appelé pour calculer le fret.
- **Des identifiants d'authentification** (clé d'API, token ou en-tête spécifique) pour que la requête soit sécurisée.
- **Des connaissances en API et en requêtes HTTP**, car la configuration d'outils personnalisés est avancée.

Si votre transporteur ne propose pas d'API publique, il faudra développer un intermédiaire ou utiliser une solution de cotation qui expose déjà un endpoint. Les spécifications techniques doivent être validées avec l'équipe de développement ou avec la documentation du fournisseur.

## Outils natifs vs personnalisés pour la logistique

Papo propose deux types d'outils pour le Capitão :

| Type | Description | Exemple d'utilisation | Connaissances techniques |
| :--- | :--- | :--- | :--- |
| **Natif** | Intégrations préconfigurées et prêtes à l'emploi sur la plateforme. | Planifier une démonstration dans Google Agenda. | Faible, il suffit d'activer et de connecter le compte. |
| **Personnalisé (HTTP)** | Actions personnalisées qui se connectent à des systèmes externes via API. | Consulter une cotation de fret en temps réel sur WhatsApp. | Avancé, nécessite des API et des requêtes HTTP. |

Pour rechercher des cotations de fret, la voie indiquée est l'outil personnalisé HTTP, car le calcul dépend de chaque transporteur ou opérateur logistique. Il n'existe pas d'intégration native générique pour n'importe quel transporteur ; vous aurez besoin de l'endpoint spécifique du service de cotation que vous utilisez.

## Configurer l'outil personnalisé pour la cotation de fret

Le processus conceptuel pour activer cette automatisation suit une logique claire, sans avoir besoin de mémoriser les noms d'écrans ou de boutons :

1. **Accédez aux paramètres de l'assistant :** Dans le panneau Papo, rendez-vous dans la zone de configuration du Capitão où les outils sont gérés.
2. **Créez un outil de type personnalisé HTTP :** Choisissez l'option qui permet de se connecter à un système externe via API.
3. **Renseignez les données de la requête :** Indiquez l'URL de l'endpoint du transporteur, la méthode HTTP (généralement POST, car vous envoyez le code postal et recevez le calcul) et les en-têtes d'authentification, comme `Authorization: Bearer sua_chave`.
4. **Définissez les paramètres dynamiques :** Le grand avantage est que le Capitão peut utiliser les informations que le client fournit lui-même dans la conversation. Vous pouvez configurer l'outil pour envoyer le code postal apparu dans le message, le poids standard du produit ou le format du colis. L'outil interprétera ces valeurs automatiquement.
5. **Indiquez au Capitão comment répondre :** Dans la description de l'outil ou dans les directives de l'assistant, vous pouvez guider l'IA pour qu'elle présente le prix et le délai de manière conviviale, comme « Votre fret pour le code postal … coûte … R$ et arrive en … ».
6. **Liez l'assistant à la boîte de réception :** Assurez-vous que le Capitão est activé pour WhatsApp (ou un autre canal) où les clients poseront la question.

Après la configuration, tout message mentionnant « fret », « cotation » ou « envoi » déclenchera le flux — à condition que le Capitão reconnaisse l'intention. La réponse finale provient des données réelles du transporteur, sans qu'un collaborateur ait besoin d'intervenir.

## Questions fréquentes

### Dois-je disposer d'une API de mon transporteur pour utiliser cet outil ?

Oui. L'outil personnalisé HTTP fonctionne en appelant un endpoint qui renvoie le prix du fret. Si votre transporteur ne propose pas d'API, vous pouvez utiliser un service de cotation (comme Intelipost, Frenet ou SuperFrete) qui regroupe plusieurs transporteurs et fournit un endpoint unique.

### Comment le Capitão sait-il quel code postal ou quel poids utiliser ?

Lors de la configuration, vous pouvez indiquer que la valeur du code postal doit être extraite directement du message du client. L'outil utilise des variables dynamiques pour capturer ces données. L'assistant peut également confirmer avec le client si l'information est incomplète, selon les instructions que vous donnez.

### Un développeur est-il nécessaire pour la configuration ?

Oui. La création d'un outil personnalisé HTTP exige des connaissances en API, en méthodes HTTP et en authentification. Généralement, un développeur ou une personne expérimentée en intégrations réalise cette étape. Papo ne fournit pas l'endpoint du transporteur, seulement l'infrastructure pour le connecter.

### La cotation de fret est-elle enregistrée dans le CRM de Papo ?

L'historique de la conversation et la réponse générée sont enregistrés dans la boîte de réception. Papo ne crée pas automatiquement d'enregistrement de cotation dans un module spécifique (comme une opportunité dans le Kanban), mais vous pouvez compléter le flux en utilisant d'autres automatisations, comme des webhooks, pour créer un lead ou une tâche à partir de cette interaction.

### Puis-je utiliser ce même outil pour consulter les délais de livraison ?

Oui. Généralement, la réponse de l'API de fret inclut déjà le délai estimé. L'outil peut être configuré pour afficher à la fois le prix et le délai dans la réponse du Capitão.

### Y a-t-il un coût supplémentaire pour utiliser des outils personnalisés ?

Les outils personnalisés font partie des fonctionnalités du Capitão pour les comptes qui ont accès à cette ressource. Pour plus de détails sur la disponibilité selon le forfait, consultez le site de Papo.

## À lire aussi

- [Comment configurer le Capitão pour consulter le statut d'une commande en temps réel](/hc/papo/articles/configurer-capitao-statut-commande-temps-reel)
- [Comment générer une clé publique et une clé secrète de l'API Papo](/hc/papo/articles/comment-generer-cle-publique-secrete-api-papo)

---

**[Commencez gratuitement et créez votre assistant avec des outils intelligents →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=creer-outil-capitaine-cotation-fret&utm_content=fr)**

Centralisez le service client et les automatisations sur WhatsApp avec l'IA, sans multiplier les outils.