# Integracja ścieżki klienta w Apple Messages

Połącz tożsamość firmy, natywną treść, odpowiedzi klientów i wyniki biznesowe za pomocą aktualnego kontraktu Bird.

## Wymagania wstępne

Przygotuj obszar roboczy Bird, firmę zatwierdzoną przez Apple, poświadczenia o odpowiednim zakresie oraz autoryzowaną konwersację testową. [Skontaktuj się ze specjalistą Apple Messages](/demo?product=apple-messages), aby potwierdzić dostęp do obszaru roboczego i uzyskać kontrakt obsługiwanych operacji dla swojej integracji. Połącz agenta kodującego z serwerem MCP Bird lub użyj klienta API swojej aplikacji, z tymi samymi uprawnieniami obszaru roboczego i firmy.

## 1. Zmapuj dwie ścieżki adresowania

Zwykłe odpowiedzi korzystają z tożsamości Apple otwartej konwersacji. Zaproszenia używają oddzielnej zatwierdzonej operacji adresowanej numerem telefonu i wyraźnej zgody. Zapoznaj się z rzeczywistymi polami i odbiorcami operacji przed implementacją którejkolwiek ścieżki.

## 2. Przygotuj natywną wymianę

Wybierz jeden obsługiwany typ treści i konkretną oczekiwaną odpowiedź. Zachowaj referencje firmy, konwersacji, żądania i wiadomości w swojej aplikacji. Nie umieszczaj poświadczeń ani prywatnej treści wiadomości w publicznych przykładach.

## 3. Zweryfikuj urządzenie i odpowiedź

Wyślij wiadomość zatwierdzoną ścieżką testową, sprawdź natywne renderowanie i zwróć odpowiedź. Powiąż dane wejściowe z oryginalnym żądaniem i zwaliduj je przed wykonaniem akcji biznesowej.

## 4. Obsłuż wyniki asynchroniczne

Wysyłka zaakceptowana przez bramkę Apple jest rejestrowana jako wysłana; nie jest to potwierdzenie dostarczenia na urządzenie ani potwierdzenie odczytu. Oddziel przetwarzanie wiadomości od wyniku zamówienia, rezerwacji lub weryfikacji tożsamości. Uwzględnij powtórzone lub nieuporządkowane obserwacje, nie zakładając uniwersalnej kolejności dostarczania ani deduplikacji po stronie dostawcy. Kieruj się [objaśnieniem statusów](/explained/apple-messages/does-sent-mean-delivered-or-read), decydując, które zdarzenie może posunąć zadanie klienta dalej.

## 5. Buduj i przeglądaj z agentem kodującym

Połącz agenta przez [serwer Bird MCP](/docs/ai/mcp-server). Poproś go o sprawdzenie obszaru roboczego, firmy i istniejącej treści przed zaproponowaniem zmian. Dostarcz kontrakt operacji Apple Messages, ten przewodnik oraz model aplikacji z usuniętymi danymi poufnymi.

Zlecaj agentowi przygotowanie natywnych wiadomości i gałęzi ścieżki, a następnie przetestuj pomyślną wymianę oraz istotnie odmienny przypadek odmowy lub niepewnej odpowiedzi. Sprawdź dokładną treść, powiązane akcje i uprawnienia przed publikacją. Wymagaj potwierdzenia przy kontakcie z klientem i przy działaniach biznesowych o istotnych konsekwencjach. Sprawdź oryginalną operację przed ponowną próbą.

## Zweryfikuj integrację na jej granicach

Użyj natywnego wyboru wizyty jako wymiany testowej. Prześledź zatwierdzoną firmę i konwersację, żądanie wychodzące, wybraną odpowiedź klienta i potwierdzoną rezerwację. To rekordy koncepcyjne do powiązania w Twojej aplikacji; używaj rzeczywistych nazw pól i kształtów operacji z kontraktu dostępnego w Twoim obszarze roboczym.

| Przypadek testowy                                     | Akcja                                                                       | Oczekiwany wynik                                                           |
| ----------------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Ta sama odpowiedź klienta jest zaobserwowana ponownie | Rozwiąż ją względem już zarejestrowanego żądania i operacji aplikacji.      | Powtórzona obserwacja nie tworzy kolejnej rezerwacji.                      |
| Aplikacja odmawia akcji biznesowej                    | Zwróć przydatną odmowę lub alternatywę, nie zmieniając wyniku akcji.        | Klient nie otrzymuje informacji, że rezerwacja lub zakup się powiódł.      |
| Agent przygotowuje nową wersję ścieżki                | Sprawdź treść, powiązane akcje i obowiązujące uprawnienia przed publikacją. | Opublikowane doświadczenie odpowiada wersji sprawdzonej przez Twój zespół. |

## Rozwiązywanie problemów

Jeśli operacja zostanie odrzucona, zweryfikuj obszar roboczy, zatwierdzenie firmy i uprawnienia konta. Jeśli wiadomość została zaakceptowana, ale zadanie klienta nie powiodło się, sprawdź renderowanie na urządzeniu i połączony system biznesowy osobno. Używaj dokładnie opublikowanych operacji API, zamiast adaptować nazwę metody innego dostawcy na podstawie domysłów.

## Następne kroki

- [Poznaj powiązane możliwości Apple Messages](/products/apple-messages/api).
- [Znajdź przewodniki i odpowiedzi dotyczące Apple Messages](/products/apple-messages/resources).
- [Przygotuj swoją pierwszą pełną konwersację](/products/apple-messages/getting-started).

## Related resources

- [What is Apple Messages for Business?](/explained/apple-messages/what-is-apple-messages-for-business) (answer)
- [Apple Messages for Business](/products/apple-messages) (product)

[Get an implementation brief](/learn/workspace?topic=apple-messages)