Sign inGet started

Eine Apple-Messages-Customer-Journey integrieren

Verbinden Sie Geschäftsidentität, native Inhalte, Kundenantworten und Geschäftsergebnisse über die aktuelle Bird-Schnittstellenbeschreibung.

Voraussetzungen

Bereiten Sie einen Bird-Workspace, ein genehmigtes Apple-Geschäftskonto, eingeschränkte Anmeldedaten und eine autorisierte Testkonversation vor. Kontaktieren Sie einen Apple-Messages-Spezialisten, um den Workspace-Zugriff zu bestätigen und die unterstützte Schnittstellenbeschreibung für Ihre Integration zu erhalten. Verbinden Sie Ihren Coding-Agent mit dem MCP-Server von Bird oder verwenden Sie den API-Client Ihrer Anwendung, mit denselben Workspace- und Geschäftsberechtigungen.

1. Die zwei Adressierungspfade abbilden

Gewöhnliche Antworten verwenden die Apple-Identität der offenen Konversation. Einladungen verwenden eine separate genehmigte, rufnummernadressierte Operation und ein explizites Opt-in. Lesen Sie die tatsächlichen Felder und die Zielgruppe der Operation, bevor Sie einen der Pfade implementieren.

2. Den nativen Austausch vorbereiten

Wählen Sie einen unterstützten Inhaltstyp und eine bestimmte erwartete Antwort. Bewahren Sie die Geschäfts-, Konversations-, Anfrage- und Nachrichtenreferenzen in Ihrer Anwendung auf. Halten Sie Anmeldedaten und private Nachrichteninhalte aus öffentlichen Beispielen heraus.

3. Gerät und Antwort verifizieren

Senden Sie über den genehmigten Testpfad, prüfen Sie die native Darstellung und geben Sie eine Antwort zurück. Korrelieren Sie diese Eingabe mit der ursprünglichen Anfrage und validieren Sie sie, bevor Sie eine Geschäftsaktion ausführen.

4. Asynchrone Ergebnisse verarbeiten

Ein von Apples Gateway akzeptierter Versand wird als gesendet erfasst; er ist keine Gerätezustellung oder Lesebestätigung. Halten Sie die Nachrichtenverarbeitung getrennt vom Bestell-, Buchungs- oder Identitätsergebnis. Berücksichtigen Sie wiederholte oder umsortierte Beobachtungen, ohne eine universelle Zustellreihenfolge oder anbieterseitige Deduplizierung vorauszusetzen. Folgen Sie der Statuserklärung, um zu entscheiden, welches Ereignis die Aufgabe des Kunden vorantreiben kann.

5. Mit einem Coding-Agent erstellen und prüfen

Verbinden Sie den Agent über den Bird-MCP-Server. Bitten Sie ihn, den Workspace, das Geschäftskonto und vorhandene Inhalte zu inspizieren, bevor er Änderungen vorschlägt. Stellen Sie die Apple-Messages-Schnittstellenbeschreibung, diese Anleitung und ein bereinigtes Anwendungsmodell bereit.
Lassen Sie den Agent native Nachrichten und Journey-Verzweigungen vorbereiten und testen Sie dann einen erfolgreichen Austausch sowie einen wesentlich abweichenden Fall mit abgelehnter oder unklarer Antwort. Prüfen Sie die genauen Inhalte, verknüpften Aktionen und Berechtigungen vor der Veröffentlichung. Verlangen Sie eine Bestätigung für Kundenkontakt und folgenreiche Geschäftsaktionen. Inspizieren Sie die ursprüngliche Operation, bevor Sie es erneut versuchen.

Die Integration an ihren Grenzen verifizieren

Verwenden Sie eine native Terminauswahl als Testaustausch. Verfolgen Sie das genehmigte Geschäftskonto und die Konversation, die ausgehende Anfrage, die vom Kunden gewählte Antwort und die bestätigte Buchung. Dies sind konzeptionelle Datensätze, die Sie in Ihrer Anwendung korrelieren; verwenden Sie die tatsächlichen Feldnamen und Operationsstrukturen aus der Schnittstellenbeschreibung, die Ihrem Workspace zur Verfügung steht.
TestfallAktionErwartetes Ergebnis
Dieselbe Kundenantwort wird erneut beobachtetGleichen Sie die Antwort mit der bereits erfassten Anfrage und dem zugehörigen Anwendungsvorgang ab.Eine wiederholte Beobachtung erzeugt keine weitere Buchung.
Die Anwendung verweigert die GeschäftsaktionGeben Sie eine hilfreiche Ablehnung oder Alternative zurück, ohne das Ergebnis der Aktion zu ändern.Dem Kunden wird kein Erfolg für die abgelehnte Buchung oder den abgelehnten Kauf gemeldet.
Ein Agent bereitet eine Journey-Überarbeitung vorPrüfen Sie Inhalte, verknüpfte Aktionen und wirksame Berechtigungen vor der Veröffentlichung.Das veröffentlichte Erlebnis entspricht der Überarbeitung, die Ihr Team geprüft hat.

Fehlerbehebung

Wenn eine Operation abgelehnt wird, überprüfen Sie den Workspace, die Geschäftsgenehmigung und die Kontoberechtigungen. Wenn eine Nachricht akzeptiert wird, die Kundenaufgabe aber fehlschlägt, prüfen Sie die Gerätedarstellung und das verbundene Geschäftssystem separat. Verwenden Sie exakt veröffentlichte API-Operationen, statt den Methodennamen eines anderen Anbieters durch Raten anzupassen.

Nächste Schritte

Verwandte Ressourcen

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.

Implementierungs-Briefing erhalten