# iMessage (Beta) Wprowadź iMessage do swojej ujednoliconej skrzynki odbiorczej. Podłącz komputer Mac z uruchomioną aplikacją [BlueBubbles](https://bluebubbles.app), a Twoje wiadomości iMessage będą napływać do platformy obok WhatsAppa, SMS-ów, Instagrama i Messengera — przy użyciu tego samego Agenta AI, transmisji i historii kontaktów, z których korzystasz już wszędzie indziej. > **Kanał beta.** Obsługa iMessage jest obecnie dostępna tylko na zaproszenie, podczas gdy dopracowujemy to rozwiązanie. Skontaktuj się z działem wsparcia, aby włączyć ją na swoim koncie. Funkcjonalność, limity i działanie mogą ulec zmianie w miarę rozwoju kanału. --- ## Omówienie Apple nie oferuje oficjalnego API iMessage — zestawu reguł, które pozwalałyby innym aplikacjom łączyć się bezpośrednio z iMessage. Zamiast tego, ta integracja łączy się za pośrednictwem otwartoźródłowej aplikacji pomostowej o nazwie **BlueBubbles**, którą uruchamiasz na komputerze Mac zalogowanym na Twoje konto iMessage. Po połączeniu platforma: - Odbiera przychodzące wiadomości iMessage jako nowe konwersacje w Czatach. - Wysyła odpowiedzi wychodzące przez Twój komputer Mac, dzięki czemu pojawiają się one u odbiorców jako zwykłe niebieskie wiadomości iMessage z Twojego Apple ID. - Pozwala Twojemu Agentowi AI, tagom i rekordom kontaktów działać dokładnie tak samo, jak na każdym innym kanale. Konfiguracja zajmuje około 10 minut, gdy masz już zainstalowane BlueBubbles. --- ## Czego potrzebujesz Aby połączyć iMessage, będziesz potrzebować wszystkich poniższych elementów: - **Komputer Mac** (laptop lub stacjonarny) zalogowany do Twojego Apple ID z włączoną usługą iMessage w aplikacji Wiadomości. - **Komputer Mac musi pozostać włączony i aktywny.** Jeśli Twój Mac przejdzie w tryb uśpienia, zrestartuje się lub straci połączenie z internetem, wiadomości iMessage przestaną napływać, dopóki nie wróci do trybu online. - **BlueBubbles Server** zainstalowany na tym komputerze Mac — bezpłatna, otwartoźródłowa aplikacja dostępna na stronie [bluebubbles.app](https://bluebubbles.app). - **Sposób na udostępnienie komputera Mac w internecie** — zazwyczaj tunel, taki jak Cloudflare Tunnel, ngrok lub Tailscale. Kreator konfiguracji BlueBubbles przeprowadzi Cię przez ten proces. - **Płatny plan** — iMessage jest uwzględniony w ramach limitu kanałów we wszystkich aktualnych planach. --- ## Konfiguracja BlueBubbles BlueBubbles to oddzielna aplikacja zewnętrzna, którą instalujesz na własnym komputerze Mac. Nie hostujemy jej — działa ona lokalnie na Twoim urządzeniu. 1. Pobierz i zainstaluj **BlueBubbles Server** ze strony [bluebubbles.app](https://bluebubbles.app). 2. Przyznaj uprawnienia, o które prosi instalator (Dostępność, Pełny dostęp do dysku, Automatyzacja). Pozwalają one BlueBubbles odczytywać przychodzące wiadomości i wyzwalać aplikację Wiadomości do wysyłania wiadomości wychodzących. 3. Otwórz BlueBubbles → **Settings → API & Webhooks**. 4. Ustaw **hasło serwera**. 5. Skopiuj swój **adres URL serwera** (publiczny adres wskazujący na Twój komputer Mac). 6. Sprawdź w BlueBubbles, czy przychodzące i wychodzące wiadomości testowe działają lokalnie, zanim przejdziesz dalej. > Pełne instrukcje konfiguracji, rozwiązywania problemów i przewodniki dla konkretnych platform znajdują się w [oficjalnej dokumentacji BlueBubbles](https://docs.bluebubbles.app). Jeśli utkniesz na samym BlueBubbles, ich dokumentacja i społeczność są najszybszą drogą do rozwiązania problemu. --- ## Łączenie BlueBubbles z platformą Gdy BlueBubbles działa na Twoim komputerze Mac: 1. Na lewym pasku bocznym kliknij **Ustawienia** (Settings) w dolnej części. 2. W menu ustawień po lewej stronie, w sekcji **Kanały** (Channels), kliknij **Kanały** (Channels). 3. Znajdź kartę **iMessage** i kliknij **Połącz** (Connect). (Przycisk **Połącz** staje się aktywny dopiero po włączeniu obsługi iMessage dla Twojego konta — do tego momentu jest wyszarzony, a na karcie widnieje informacja: „iMessage is in private beta and isn't enabled on your account yet.”) 4. Wklej **adres URL serwera** (Server URL) BlueBubbles (np. `https://your-tunnel.example.com`). 5. Wklej **hasło serwera** (server password) BlueBubbles. 6. Kliknij **Połącz** (Connect). Weryfikujemy połączenie, łącząc się z Twoim serwerem BlueBubbles i automatycznie konfigurując webhook (webhook to adres internetowy, który pozwala BlueBubbles automatycznie powiadomić platformę w momencie nadejścia nowej wiadomości). Jeśli wszystko jest w porządku, status zmieni się na **Połączono** (Connected). 7. W BlueBubbles otwórz **Ustawienia → API i Webhooki → Webhooki** (Settings → API & Webhooks → Webhooks) i potwierdź (lub wklej) adres URL webhooka wyświetlony na stronie ustawień iMessage. 8. Zapisz. To wszystko — przychodzące wiadomości iMessage będą teraz trafiać do Twojej skrzynki odbiorczej w czasie rzeczywistym. ### Testowanie połączenia Na stronie ustawień iMessage możesz wysłać testową wiadomość iMessage na dowolny numer telefonu, aby potwierdzić, że wszystko jest poprawnie skonfigurowane. Wprowadź numer telefonu odbiorcy w formacie E.164 (np. `+14155551234`) wraz z krótką wiadomością i wyślij test. Pierwsze wysłanie testowe może zająć do minuty, ponieważ aplikacja Wiadomości (Messages) na komputerze Mac może potrzebować czasu na rozpoczęcie nowego wątku rozmowy. Kolejne wysyłane wiadomości docierają niemal natychmiast. --- ## Jak przepływają wiadomości ### Przychodzące 1. Ktoś wysyła wiadomość iMessage na Twój Apple ID. 2. Aplikacja Wiadomości na komputerze Mac odbiera ją (tak jak zwykle). 3. BlueBubbles wykrywa nową wiadomość i wysyła ją metodą POST na adres URL webhooka. 4. Platforma tworzy kontakt (jeśli jest nowy), umieszcza wiadomość w czatach i — jeśli Twój agent AI dla tego kanału jest aktywny — odpowiada na nią. ### Wychodzące 1. Ty lub agent AI wysyłacie odpowiedź z platformy. 2. Wysyłamy wiadomość do Twojego serwera BlueBubbles. 3. BlueBubbles instruuje aplikację Wiadomości na komputerze Mac, aby wysłała wiadomość iMessage. 4. Odbiorca widzi zwykłą niebieską wiadomość iMessage wysłaną z Twojego Apple ID. ### Obsługiwane typy wiadomości - **Wiadomości tekstowe** — w pełni obsługiwane w obu kierunkach. - **Załączniki i multimedia** — przychodzące załączniki są widoczne w BlueBubbles, ale **jeszcze nie** są pobierane do platformy w trakcie trwania wersji Beta. Wiadomości wychodzące muszą zawierać tekst — wysyłanie obrazów lub plików przez iMessage nie jest jeszcze dostępne. --- ## Limity wysyłania, rozgrzewka i kontrola działań następczych iMessage posiada takie same limity wysyłki ochronnej, automatyczną rozgrzewkę i wyłącznik bezpieczeństwa dla wiadomości uzupełniających, jak WhatsApp Web i Telegram, z jedną różnicą, o której warto wiedzieć: **w iMessage automatyczne wiadomości uzupełniające są domyślnie włączone** na nowo podłączonym koncie, więc wyłącz je samodzielnie, jeśli chcesz, aby konto pozostało nieaktywne podczas rozgrzewki. Apple agresywnie oznacza konta, które zachowują się jak masowi nadawcy, dlatego te zabezpieczenia istnieją, aby chronić Twój Apple ID. Po podłączeniu konta na stronie ustawień iMessage znajdziesz kartę **Limity wysyłki i rozgrzewka** oraz przełącznik **Automatyczne wiadomości uzupełniające**. ### Automatyczna rozgrzewka (ramp) Nowo podłączone konto iMessage jest celowo ograniczane i z czasem odblokowuje większą przepustowość. Zyskuje „dzień kwalifikujący” tylko w dniach, w których faktycznie wysyła co najmniej 75% swojego aktualnego limitu — dni bezczynności nie są liczone. - **Dzienny limit wiadomości** = `50 + 8 × (day − 1)`, ograniczony do **500/dzień** (osiągany w 58. dniu). - **Dzienny limit nowych kontaktów** = `floor((day − 1) × 5 / 6)`, ograniczony do **50/dzień** (osiągany w 61. dniu). Strona ustawień pokazuje aktualny dzień rozgrzewki, dzisiejsze wykorzystanie limitu oraz pozostały czas. Jeśli Twój Apple ID ma już długą, autentyczną historię iMessage, możesz przesunąć suwak dnia rozgrzewki do przodu — ale rób to uczciwie, tylko dla konta, które rzeczywiście posiada taką historię. ### Ręczne obejście po zakończeniu rozgrzewki Po pełnym 58-dniowym okresie rozgrzewki, opcjonalne obejście pozwala zwiększyć dzienny limit wiadomości powyżej 500 (od 750 do 5000, w krokach co 250 wiadomości). Zachowaj ostrożność — Apple nie publikuje bezpiecznej liczby, a nadmierne wysyłanie naraża Twój Apple ID. Obejście jest dostępne tylko wtedy, gdy konto jest w pełni rozgrzane. ### Włączanie/wyłączanie limitów wysyłania i wyłącznik działań następczych Główny przełącznik włącza lub wyłącza limity wysyłki, a dzienny limit nowych kontaktów pozwala ograniczyć liczbę pierwszych wiadomości do poziomu niższego niż ten, na który pozwalałby proces rozgrzewki. Przełącznik **Automatyczne wiadomości uzupełniające** zatrzymuje wszystkie automatyczne wiadomości uzupełniające dla konta, niezależnie od ustawień transmisji/kampanii. **W iMessage ten przełącznik jest domyślnie włączony**, więc świeżo podłączone konto będzie wysyłać automatyczne wiadomości uzupełniające, dopóki go nie wyłączysz — a wyłączenie go jest zalecane, gdy konto jest nowe (poniżej ok. 30 dni rozgrzewki). Po osiągnięciu dziennego limitu zaplanowane wiadomości uzupełniające są przenoszone na następny dzień, zamiast kończyć się niepowodzeniem. --- ## Ograniczenia wersji Beta iMessage Ponieważ iMessage nie posiada oficjalnego API, ten kanał wiąże się z ograniczeniami, których nie spotkasz w WhatsApp, SMS czy Instagramie. Prosimy o dokładne zapoznanie się z nimi przed poleganiem na iMessage w komunikacji o krytycznym znaczeniu dla biznesu. - **Twój Mac musi być włączony i aktywny.** Brak Maca oznacza brak iMessage. Zalecamy wyłączenie trybu uśpienia na Macu z uruchomionym BlueBubbles lub użycie dedykowanego Maca mini do tego celu. - **Tylko rozmowy jeden na jeden, przy użyciu numeru telefonu.** Czaty grupowe i identyfikatory Apple ID (e-mail) nie są oficjalnie obsługiwane w wersji Beta i mogą zachowywać się nieprzewidywalnie, jeśli trafią do platformy — używaj tylko rozmów iMessage jeden na jeden, opartych na numerach telefonów. - **Tylko tekst.** Wiadomości zawierające wyłącznie załączniki (zdjęcie, wideo, plik) są pomijane przychodząco, a wiadomości wychodzące muszą zawierać tekst. Wysyłanie multimediów zostanie dodane później w wersji Beta. - **Brak szablonów lub wstępnie zatwierdzonych wiadomości.** Wszystkie wiadomości to tekst dowolny. - **Brak potwierdzeń dostarczenia lub odczytania** w interfejsie platformy. Nadal będziesz je widzieć w aplikacji Wiadomości na swoim Macu. - **Status „Wysłano” oznacza przekazanie, a nie dostarczenie.** Status „Wysłano” oznacza, że platforma przekazała wiadomość do Twojego Maca, a nie że odbiorca ją otrzymał. Ponieważ iMessage nie ma niezawodnego potwierdzenia dostarczenia, niektóre wysyłki są optymistycznie oznaczane jako „Wysłano”, nawet jeśli Twój Mac nie mógł potwierdzić dostarczenia (na przykład, jeśli odbiorca nie korzysta z iMessage). Aby mieć pewność, że wiadomość dotarła, sprawdź aplikację Wiadomości na swoim Macu. - **Wskaźniki pisania wymagają prywatnego API BlueBubbles.** Gdy AI tworzy odpowiedź, Twój kontakt widzi dymek „pisze…” — ale tylko wtedy, gdy włączyłeś funkcje **Prywatnego API** w BlueBubbles (Ustawienia → Prywatne API). Bez tego odpowiedzi nadal wysyłają się normalnie; kontakt po prostu nie zobaczy najpierw dymka pisania. - **Pierwsza wiadomość wychodząca do nowego kontaktu może być powolna.** Rozpoczęcie zupełnie nowej rozmowy może zająć od 30 do 60 sekund, podczas gdy system macOS otwiera wątek; kolejne wiadomości są szybkie. - **Brak masowego wysyłania / transmisji.** W trakcie wersji Beta iMessage najlepiej sprawdza się w rozmowach przychodzących i odpowiedziach jeden na jeden, a nie w masowych transmisjach wychodzących. Apple agresywnie ogranicza szybkość i oznacza zautomatyzowany ruch w iMessage. - **Ryzyko dla konta.** Apple oficjalnie nie zezwala na automatyzację iMessage przez strony trzecie. Nadmierne lub spamerskie korzystanie z automatyzacji iMessage może skutkować oznaczeniem lub ograniczeniem Twojego Apple ID przez Apple. Korzystaj z kanału odpowiedzialnie. --- ## Rozwiązywanie problemów ### „Nie można połączyć się z serwerem BlueBubbles” - Upewnij się, że BlueBubbles działa na Twoim Macu i widoczny jest zielony wskaźnik **Server running**. - Upewnij się, że Twój tunel (Cloudflare / ngrok / Tailscale) jest aktywny, a wklejony adres URL jest dostępny z publicznego internetu — otwórz go w przeglądarce, powinieneś zobaczyć stronę powitalną BlueBubbles. - Sprawdź dokładnie, czy hasło serwera zgadza się z tym ustawionym w **BlueBubbles → Settings → API**. ### Przychodzące wiadomości nie pojawiają się w skrzynce odbiorczej - Otwórz **BlueBubbles → Settings → API & Webhooks → Webhooks** i upewnij się, że pokazany przez nas adres URL webhooka jest zapisany dokładnie tak, jak został wyświetlony. - Na stronie ustawień iMessage użyj **Refresh status**, aby sprawdzić, czy połączenie jest nadal poprawne. - Upewnij się, że numer nadawcy to numer telefonu, a nie adres e-mail (adresy e-mail nie są obsługiwane w wersji Beta). - Upewnij się, że Twój Mac ma połączenie z internetem i nie jest w trybie uśpienia. ### Wiadomości wychodzące nie są wysyłane - Przetestuj wysyłanie do tego samego odbiorcy bezpośrednio z aplikacji Wiadomości na Macu. Jeśli aplikacja Wiadomości również nie może wysłać wiadomości (np. odbiorca nie korzysta z iMessage), platforma również tego nie zrobi. - Upewnij się, że Twój Mac nie jest w trybie uśpienia, zablokowany przez FileVault lub nie wyświetla okna dialogowego aktualizacji systemu — blokują one automatyzację AppleScript, na której polega BlueBubbles. - Upewnij się, że masz wystarczającą liczbę kredytów na swoim koncie. ### Status pokazuje „Connected”, ale nic nie działa - Użyj **Refresh status** na stronie ustawień iMessage, aby ponownie zweryfikować połączenie. - Jeśli to nadal nie pomaga, rozłącz się, a następnie połącz ponownie, używając nowego adresu URL serwera i hasła. ### Mój Mac został zrestartowany / stracił połączenie z internetem Gdy Twój Mac wróci do trybu online, a BlueBubbles uruchomi się ponownie, połączenie zostanie wznowione automatycznie. Wszystkie wiadomości wysłane do Ciebie, gdy Mac był offline, pojawią się w aplikacji Wiadomości po ponownym połączeniu, ale mogą **nie** zostać w pełni zsynchronizowane z platformą — iMessage nie udostępnia niezawodnego API do uzupełniania historii wiadomości. --- ## Potrzebujesz pomocy? iMessage jest obecnie w fazie **Beta**. Jeśli napotkasz problemy, których nie opisaliśmy powyżej, skontaktuj się z hi@youraiconnector.com, podając: - Adres URL serwera, z którym się połączyłeś (bez hasła). - Opis problemu oraz wszelkie komunikaty o błędach ze strony ustawień iMessage. - Czas wystąpienia problemu. Przyjrzymy się sprawie tak szybko, jak to możliwe.