Wie man ein Tool des Capitão zum Abrufen von Frachtangeboten erstellt

Um ein Tool des Capitão zu erstellen, das Frachtangebote abruft, verwenden Sie ein benutzerdefiniertes HTTP-Tool auf der Plattform Papo (https://papo.global/). Es verbindet den Assistenten mit der API Ihres Spediteurs oder Ihrer Logistikplattform und ermöglicht der KI, Daten wie Ziel-Postleitzahl, Gewicht und Abmessungen, die der Kunde sendet, zu interpretieren, das externe System abzufragen und den Frachtpreis während der Unterhaltung auf WhatsApp automatisch zurückzugeben.

Mit dieser Konfiguration ist der Capitão nicht mehr nur ein Assistent, der Fragen beantwortet, sondern führt praktische Logistikaufgaben aus. Der Kunde kann fragen: „Wie viel kostet der Versand für die Postleitzahl 02030‑040?" und erhält sofort eine Antwort wie „Der Versand für diese Postleitzahl kostet R$ 18,90 mit einer Lieferzeit von 3 Werktagen", ohne menschliches Eingreifen. Das reduziert die Hürden beim Kauf, beschleunigt den Kundenservice und entlastet das Team für komplexere Verhandlungen.

Überblick über die Konfiguration

Wie die Frachtabfrage mit dem Capitão funktioniert

Der Ablauf verbindet eine gewöhnliche Kundenfrage mit einer Berechnung in Echtzeit:

1. Der Kunde fragt ein Angebot an: Er sendet eine Nachricht wie „Wie hoch ist der Versand für die Postleitzahl 04123‑000?".
2. Der Capitão erkennt die Absicht: Anhand der Anweisungen und Beschreibungen der Tools erkennt er, dass er das Angebots-Tool verwenden soll.
3. Das Tool wird ausgelöst: Der Assistent sendet die aus dem Gespräch extrahierten Werte (Postleitzahl, Produktgewicht usw.) an den Endpoint des Spediteurs.
4. Die API gibt Preis und Frist zurück: Das externe System liefert ein JSON mit den verfügbaren Frachtoptionen zurück.
5. Der Capitão antwortet dem Kunden: Die KI übersetzt diese Daten in eine natürliche Antwort wie „Wir haben PAC für R$ 22,90 (7 Tage) und Sedex für R$ 39,50 (2 Tage)".

Der gesamte Prozess läuft ab, ohne dass ein menschlicher Mitarbeiter die Postleitzahl kopieren und ein anderes System öffnen muss.

Voraussetzungen für die Konfiguration des Angebots-Tools

Bevor Sie das Tool erstellen, benötigen Sie:

• Einen bereits erstellten Capitão-Assistenten auf der Plattform Papo mit festgelegtem Namen und Beschreibung.
• Eine verfügbare Speditions-API, sei es von Correios, einer Logistikplattform (Intelipost, Frenet, SuperFrete) oder einem eigenen System zur Lieferverwaltung.
• Die URL des Endpoints, der zur Berechnung der Fracht aufgerufen wird.
• Authentifizierungsdaten (API-Schlüssel, Token oder spezifischer Header), damit die Anfrage sicher ist.
• Kenntnisse über APIs und HTTP-Anfragen, da die Konfiguration benutzerdefinierter Tools fortgeschritten ist.

Falls Ihr Spediteur keine öffentliche API anbietet, müssen Sie einen Vermittler entwickeln oder eine Angebotslösung nutzen, die bereits einen Endpoint bereitstellt. Die technischen Spezifikationen sollten mit dem Entwicklungsteam oder anhand der Dokumentation des Anbieters geprüft werden.

Native vs. benutzerdefinierte Tools für die Logistik

Papo bietet zwei Arten von Tools für den Capitão:

Für den Abruf von Frachtangeboten ist das benutzerdefinierte HTTP-Tool der empfohlene Weg, da die Berechnung von jedem Spediteur oder Logistikdienstleister abhängt. Es gibt keine allgemeine native Integration für beliebige Spediteure; Sie benötigen den spezifischen Endpoint des von Ihnen genutzten Angebotsdienstes.

Das benutzerdefinierte Tool für Frachtangebote konfigurieren

Der konzeptionelle Ablauf zur Aktivierung dieser Automatisierung folgt einer klaren Logik, ohne dass Sie Namen von Bildschirmen oder Schaltflächen auswendig lernen müssen:

1. Rufen Sie die Einstellungen des Assistenten auf: Gehen Sie im Papo-Panel zum Konfigurationsbereich des Capitão, in dem die Tools verwaltet werden.
2. Erstellen Sie ein Tool vom Typ benutzerdefiniert HTTP: Wählen Sie die Option, die eine Verbindung zu einem externen System über eine API ermöglicht.
3. Geben Sie die Anfragedaten an: Füllen Sie die URL des Endpoints des Spediteurs aus, die HTTP-Methode (in der Regel POST, da Sie die Postleitzahl senden und die Berechnung erhalten) und die Authentifizierungs-Header wie Authorization: Bearer sua_chave.
4. Legen Sie die dynamischen Parameter fest: Der große Vorteil ist, dass der Capitão Informationen nutzen kann, die der Kunde selbst im Gespräch angibt. Sie können das Tool so konfigurieren, dass es die in der Nachricht genannte Postleitzahl, das Standardgewicht des Produkts oder das Format des Pakets sendet. Das Tool interpretiert diese Werte automatisch.
5. Weisen Sie den Capitão an, wie er antworten soll: In der Beschreibung des Tools oder in den Richtlinien des Assistenten können Sie die KI anweisen, den Preis und die Frist freundlich zu präsentieren, etwa „Ihr Versand für die Postleitzahl … kostet R$ … und kommt in … an".
6. Verknüpfen Sie den Assistenten mit dem Posteingang: Stellen Sie sicher, dass der Capitão für WhatsApp (oder einen anderen Kanal) aktiviert ist, über den die Kunden ihre Frage stellen.

Nach der Konfiguration löst jede Nachricht, die „Fracht", „Angebot" oder „Versand" erwähnt, den Ablauf aus – sofern der Capitão die Absicht erkennt. Die endgültige Antwort stammt aus den realen Daten des Spediteurs, ohne dass ein Mitarbeiter eingreifen muss.

Häufige Fragen

Brauche ich eine API meines Spediteurs, um dieses Tool zu nutzen?

Ja. Das benutzerdefinierte HTTP-Tool funktioniert, indem es einen Endpoint aufruft, der den Frachtpreis zurückgibt. Falls Ihr Spediteur keine API anbietet, können Sie einen Angebotsdienst (wie Intelipost, Frenet oder SuperFrete) nutzen, der mehrere Spediteure bündelt und einen einzigen Endpoint bereitstellt.

Woher weiß der Capitão, welche Postleitzahl oder welches Gewicht verwendet werden soll?

Während der Konfiguration können Sie festlegen, dass der Wert für die Postleitzahl direkt aus der Nachricht des Kunden extrahiert wird. Das Tool verwendet dynamische Variablen, um diese Daten zu erfassen. Je nach Ihren Anweisungen kann der Assistent die Information auch beim Kunden nachfragen, falls sie unvollständig ist.

Ist für die Konfiguration ein Entwickler erforderlich?

Ja. Die Erstellung eines benutzerdefinierten HTTP-Tools erfordert Kenntnisse über APIs, HTTP-Methoden und Authentifizierung. In der Regel übernimmt ein Entwickler oder eine Person mit Integrationserfahrung diesen Schritt. Papo stellt nicht den Endpoint des Spediteurs bereit, sondern nur die Infrastruktur, um ihn anzubinden.

Wird das Frachtangebot im CRM von Papo gespeichert?

Der Gesprächsverlauf und die generierte Antwort werden im Posteingang gespeichert. Papo erstellt nicht automatisch einen Angebotsdatensatz in einem bestimmten Modul (wie etwa einem Deal im Kanban), aber Sie können den Ablauf mit weiteren Automatisierungen wie Webhooks ergänzen, um aus dieser Interaktion einen Lead oder eine Aufgabe zu erstellen.

Kann ich dasselbe Tool verwenden, um Lieferzeiten abzufragen?

Ja. In der Regel enthält die Antwort der Fracht-API bereits die geschätzte Lieferzeit. Das Tool kann so konfiguriert werden, dass sowohl der Preis als auch die Lieferzeit in der Antwort des Capitão angezeigt werden.

Fallen zusätzliche Kosten für die Nutzung benutzerdefinierter Tools an?

Benutzerdefinierte Tools sind Teil der Capitão-Funktionen für Konten, die Zugriff auf diese Ressource haben. Details zur Verfügbarkeit je nach Plan finden Sie auf der Website von Papo.

Lesen Sie auch

• Wie man den Capitão konfiguriert, um den Bestellstatus in Echtzeit abzufragen
• Wie man einen öffentlichen und einen geheimen Schlüssel der Papo-API generiert

Starten Sie kostenlos und erstellen Sie Ihren Assistenten mit intelligenten Tools →

Zentralisieren Sie Kundenservice und Automatisierungen auf WhatsApp mit KI, ohne die Anzahl der Tools zu vervielfachen.