Dieser Leitfaden hilft Ihnen, Fin Voice, Intercoms AI-Agent für Telefonsupport, mit Ihrem Amazon-Konto zu verbinden. Folgen Sie diesen Schritten, um Kundenanrufe sofort mit Ihrem Help Center-Inhalt zu beantworten und komplexe Probleme nahtlos an Ihr menschliches Team mit vollständiger KI-generierter Zusammenfassung und Transkript weiterzuleiten.
Profi-Tipp: Diese Integration verwendet die Intercom API. Wir empfehlen, einen technischen Kollegen oder Entwickler bei der Skriptkonfiguration im Amazon Connect Flow Designer hinzuzuziehen.
So funktioniert die Integration
Diese Integration verwendet Public Switched Telephone Network (PSTN)-Weiterleitung, um Anrufe zwischen Amazon und Intercom zu routen:
Amazon → Fin Voice: Amazon leitet eingehende Anrufe an eine dedizierte Fin Voice-Nummer weiter, die in Intercom erworben wurde.
Fin Voice-Auflösung: Fin antwortet sofort und nutzt Ihr Help Center, um das Problem zu lösen.
Fin Voice → Amazon: Wenn Fin den Anruf nicht lösen kann, leitet es den Anrufer zurück an eine dedizierte Amazon-Eskalationsnummer.
Kontextübertragung: Amazon Connect verwendet die Fin Voice API, um die Anrufzusammenfassung und das Transkript für Ihre Teammitglieder abzurufen.
Wichtig: Diese Integration funktioniert nur, wenn Amazon Connect, Lambda und Fin Voice in einer bestimmten Reihenfolge verbunden sind. Abweichungen davon verursachen stille Verbindungsabbrüche.
Lambda muss vor der Weiterleitung ausgeführt werden: Sie müssen die Absicht über Lambda vor dem Weiterleitungsblock registrieren.
Verzögerung ist erforderlich: Eine kurze Verzögerung (Play prompt) muss unmittelbar vor dem Transfer-Block vorhanden sein.
Nur ein Pfad: Es darf genau ein Erfolgsweg in den Transfer-Block führen.
Caller ID: Muss eine gültige E.164-Telefonnummer sein. Mischen Sie niemals manuelle und dynamische Caller-ID-Einstellungen.
Bevor Sie beginnen
Stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:
Anforderung | Beschreibung |
Fin Voice | Fin Voice ist in den Regionen US, EU oder AU aktiviert und gehostet. |
Admin-Zugang | Erforderlich für Intercom und Amazon, um Routing und API-Tokens zu verwalten. |
Knowledge Base | Aktuelle Help Center-Inhalte, auf die Fin zugreifen kann. |
Intercom Access Token | Ein gültiges Zugriffstoken (API-Schlüssel) ist erforderlich, um das Lambda-Funktionsskript zu authentifizieren. |
AWS-Umgebung | Eine aktive Amazon Connect-Instanz mit Berechtigungen zum Erstellen von Lambda-Funktionen und Kontaktflüssen. |
1. Testen Sie Fin Voice
Bevor Sie live gehen, verwenden Sie den Tab Voice Testing, um Anrufe in Ihrem Browser zu simulieren.
Navigieren Sie zu Fin AI Agent > Deploy > Phone > Voice testing.
Klicken Sie auf Play und beginnen Sie zu sprechen, um Fin's Antworten zu hören.
Verwenden Sie Settings (oben rechts), um Stimmen zu wechseln oder Begrüßungen und Eskalationsregeln vorzuhören.
2. Erstellen Sie eine Fin Voice-Leitung
Um von der Test- zur Live-Leitung zu wechseln, müssen Sie innerhalb von Intercom eine dedizierte Nummer kaufen.
Navigieren Sie zu Fin AI Agent > Deploy > Phone > Set Fin live.
Klicken Sie auf + Neue Leitung.
Wählen Sie Externer Anbieter und klicken Sie auf Weiter.
Benennen Sie Ihre Leitung, wählen Sie Von einer Telefonnummer (PSTN) und klicken Sie auf Weiter.
Klicken Sie auf Kaufen, um eine lokale US-Nummer zu erwerben.
3. Konfigurieren Sie Aufnahmen und Verhalten
Aktivieren Sie Kontext-Tools
Um Teammitgliedern zu ermöglichen, zu sehen, was während des KI-Teils des Anrufs passiert ist, aktivieren Sie globale Einstellungen:
Gehen Sie zu Einstellungen > Kanäle > Telefon.
Schalten Sie Aufnahmen aktivieren, Transkripte und Zusammenfassungen der Anruftranskripte ein.
Gehen Sie zurück zum Abschnitt Fin AI Agent > Deploy > Phone > Set Fin live, hier können Sie das Verhalten von Fin anpassen:
Öffnungszeiten: Legen Sie fest, wann Fin antworten soll (Standard ist 24/7).
Stimme und Sprache: Wählen Sie eine Stimme, die zu Ihrer Marke passt.
Support-Inhalte: Wählen Sie aus, auf welche Help Center-Artikel Fin zugreifen soll.
CSAT: Aktivieren Sie Tastaturbewertungen (1–5) für abgeschlossene Anrufe.
4. Erstellen Sie die Lambda-Funktion
Sie müssen eine Lambda-Funktion in AWS erstellen, um den Anruf bei Fin Voice zu registrieren. Diese Funktion gibt eine fin_intent_id zurück, die für die Weiterleitung erforderlich ist.
Navigieren Sie in Ihrer AWS-Konsole zu Lambda und klicken Sie auf Funktion erstellen.
Wählen Sie Autor von Grund auf.
Geben Sie einen Funktionsnamen ein (z. B.
intent_to_use_fin).Wählen Sie für Runtime Node.js 18.x (oder höher).
Fügen Sie unter Konfiguration > Umgebungsvariablen eine neue Variable hinzu:
Schlüssel:
INTERCOM_TOKENWert: Ihr tatsächlicher Intercom Access Token.
Fügen Sie unter Code folgendes Skript ein. Dieses sendet Anrufdetails an die API von Intercom und gibt eine
fin_intent_idzurück, die für die Weiterleitung erforderlich ist.
export const handler = async (event) => {
const contactId = event?.Details?.ContactData?.ContactId;
const phoneNumber = event?.Details?.ContactData?.CustomerEndpoint?.Address;
if (!contactId || !phoneNumber) {
throw new Error("Missing contactId or phoneNumber");
}
const token = process.env.INTERCOM_TOKEN;
if (!token) throw new Error("Missing INTERCOM_TOKEN");
const response = await fetch("https://api.intercom.io/fin_voice/register", {
method: "POST",
headers: {
Authorization: `Bearer ${token}`,
"Intercom-Version": "Unstable",
"Content-Type": "application/json",
},
body: JSON.stringify({
call_id: contactId,
phone_number: phoneNumber,
}),
});
const text = await response.text();
if (!response.ok) {
throw new Error(`Intercom ${response.status}: ${text}`);
}
const data = JSON.parse(text);
return {
fin_intent_id: String(data.id),
customer_phone: phoneNumber,
};
};
Tipp: Wenn Ihr Lambda-Aufruf im nächsten Schritt stillschweigend fehlschlägt, stellen Sie sicher, dass Sie die Lambda-Funktion über die AWS-Konsole zu Ihrer Amazon Connect-Instanz hinzugefügt haben (Amazon Connect > Instanzen > [Ihre Instanz] > Kontaktflüsse > AWS Lambda).
5. Konfigurieren Sie den Amazon Connect Flow
Sobald Ihre Lambda-Funktion bereit ist, müssen Sie sie zu Ihrem Amazon Connect Flow hinzufügen, um die Übergabe zu steuern. Sie müssen Ihren Kontaktfluss in einer bestimmten Reihenfolge verdrahten, um Anrufausfälle zu vermeiden.
Der kanonische Flow
Ihr Flow muss dieser genauen Reihenfolge folgen:
Einstieg
Begrüßung abspielen
AWS Lambda-Funktion aufrufen (Synchron)
Ansage abspielen (Kurze Verzögerung)
Weiterleitung an Telefonnummer
Flow beenden
Schritt-für-Schritt-Konfiguration
Block "AWS Lambda-Funktion aufrufen" hinzufügen
Funktions-ARN: Wählen Sie die in Schritt 4 erstellte Lambda-Funktion aus.
Timeout: Auf 8 Sekunden einstellen.
Antwortvalidierung: Wählen Sie String Map.
Block "Ansage abspielen" hinzufügen (erforderliche Verzögerung) Fin Voice ignoriert DTMF-Signale, die zu früh gesendet werden. Sie müssen unmittelbar vor der Weiterleitung eine Verzögerung hinzufügen.
Fügen Sie einen Block "Ansage abspielen" hinzu.
Wählen Sie Text-zu-Sprache und geben Sie eine kurze Phrase wie „Bitte halten Sie einen Moment.“ ein.
Block "Weiterleitung an Telefonnummer" hinzufügen Dieser Block übergibt den Anruf an Fin.
Weiterleitung an: Wählen Sie Manuell festlegen.
Ländervorwahl: Wählen Sie Ihr Land (z. B. Vereinigte Staaten +1).
Telefonnummer: Geben Sie die in Schritt 2 gekaufte dedizierte Fin Voice-Nummer ein.
Flow nach Trennung fortsetzen: Auf Nein einstellen.
DTMF senden: Aktivieren Sie dieses Kontrollkästchen.
Wählen Sie Dynamisch festlegen.
Namespace:
ExternalSchlüssel:
fin_intent_id
Rufnummernanzeige: Wählen Sie Manuell festlegen und wählen Sie eine verifizierte Nummer aus Ihrer Connect-Instanz.
Wichtig: Verwenden Sie für die Rufnummernanzeige nicht „Dynamisch festlegen“, wenn Sie eine manuelle Nummer ausgewählt haben. Die Mischung dieser Methoden führt zum Scheitern der Weiterleitung.
6. Nach-Fin-Routing verwalten
Wenn Fin den Anruf zurück zu Amazon Connect überträgt (z. B. für einen menschlichen Agenten), können Sie eine zweite Lambda-Funktion verwenden, um Gesprächsdaten abzurufen.
Erstellen Sie eine neue Lambda-Funktion mit dem untenstehenden Code.
Fügen Sie sie nach dem Block Weiterleitung an Telefonnummer zu Ihrem Flow hinzu (genau im „Erfolgs“-Zweig, wenn Sie „Flow fortsetzen“ aktiviert haben).
export const handler = async (event) => {
const phoneNumber = event?.Details?.ContactData?.CustomerEndpoint?.Address;
const response = await fetch(
`https://api.intercom.io/fin_voice/phone_number/${phoneNumber}`,
{
method: "GET",
headers: {
Authorization: `Bearer ${process.env.INTERCOM_TOKEN}`,
"Intercom-Version": "Unstable",
Accept: "application/json",
},
}
);
if (!response.ok) {
throw new Error("Failed to retrieve Fin Voice call state");
}
const data = await response.json();
return {
status: data.status,
intercom_conversation_id: data.intercom_conversation_id,
call_summary: data.call_summary,
};
};
7. Gesprächszusammenfassung zur Connect-Benutzeroberfläche hinzufügen
Damit Teammitglieder die von der KI generierte Zusammenfassung sehen, wenn sie einen Anruf annehmen, müssen Sie eine Ansicht in Amazon Connect konfigurieren.
Erstellen Sie die Ansicht
Navigieren Sie zur Ansichten-Schnittstelle in Amazon Connect und klicken Sie auf Ansicht erstellen.
Suchen Sie die Komponente Attributleiste und wählen Sie sie aus.
Konfigurieren Sie die Eigenschaften der Attributleiste:
Bezeichnung: Auf „Conversation Summary“ setzen.
Wert: Auf
$.conversation_summarysetzen.
Erstellen Sie den View-Flow
Erstellen Sie einen neuen Flow, um diese Ansicht dem Kunden oder Teammitglied anzuzeigen.
Fügen Sie dem Flow einen Show View-Block hinzu.
Setzen Sie die View-Eigenschaft auf die Ansicht, die Sie im vorherigen Schritt erstellt haben.
Setzen Sie das Timeout auf Manuell festlegen und geben Sie 5 Minuten (oder Ihre bevorzugte Dauer) ein.
Wählen Sie unter conversation_summary Dynamisch festlegen aus:
Namespace: External
Schlüssel:
conversation_summary
Verbinden Sie den Flow mit dem Agenten
Kehren Sie zu Ihrem ursprünglichen IVR-Flow zurück (wo Sie die Weiterleitung konfiguriert haben).
Fügen Sie vor dem Transfer to queue-Block (wo der Anruf an ein Teammitglied weitergeleitet wird) einen Set event flow-Block hinzu.
Konfigurieren Sie die Blockeinstellungen:
Ereignis auswählen: Standard-Flow für Agent UI.
Flow auswählen: Wählen Sie den gerade erstellten „Show View“-Flow aus.
Verbinden Sie diesen Block mit Ihrem Transfer to queue-Block.
Diese Konfiguration stellt sicher, dass beim Anruftransfer das Teammitglied die „Conversation Summary“-Leiste sieht, die mit Daten von Fin gefüllt ist.