Your AI Connector Docs

iMessage (Bèta)

Breng iMessage naar je centrale inbox. Verbind een Mac waarop BlueBubbles draait en je iMessages stromen het platform binnen, naast WhatsApp, sms, Instagram en Messenger — met dezelfde AI-agent, uitzendingen en contactgeschiedenis die je al overal elders gebruikt.

Bèta-kanaal. iMessage-ondersteuning is momenteel alleen op uitnodiging beschikbaar terwijl we de ervaring verfijnen. Neem contact op met support om dit voor je account in te schakelen. Functionaliteit, limieten en gedrag kunnen veranderen naarmate het kanaal volwassener wordt.


Overzicht

Apple biedt geen officiële iMessage-API aan — een set regels waarmee andere apps direct verbinding kunnen maken met iMessage. In plaats daarvan maakt deze integratie verbinding via een open-source bridge-app genaamd BlueBubbles, die je draait op een Mac die is ingelogd op je iMessage-account. Zodra de verbinding tot stand is gebracht, doet het platform het volgende:

  • Ontvangt inkomende iMessages als nieuwe gesprekken in Chats.
  • Verstuurt uitgaande antwoorden via je Mac, zodat ze voor ontvangers verschijnen als een normale blauwe iMessage van je Apple ID.
  • Zorgt ervoor dat je AI-agent, tags en contactgegevens precies zo werken als op elk ander kanaal.

De installatie duurt ongeveer 10 minuten zodra je BlueBubbles hebt geïnstalleerd.


Wat je nodig hebt

Om iMessage te verbinden, heb je het volgende nodig:

  • Een Mac (laptop of desktop) ingelogd op je Apple ID met iMessage ingeschakeld in de Berichten-app.
  • De Mac moet online en wakker blijven. Als je Mac in de sluimerstand gaat, opnieuw opstart of de internetverbinding verliest, stoppen iMessages met binnenkomen totdat deze weer online is.
  • BlueBubbles Server geïnstalleerd op die Mac — een gratis, open-source app beschikbaar op bluebubbles.app.
  • Een manier om je Mac bloot te stellen aan het internet — meestal een tunnel zoals Cloudflare Tunnel, ngrok of Tailscale. De installatiewizard van BlueBubbles leidt je hier doorheen.
  • Een betaald abonnement — iMessage is inbegrepen als onderdeel van je kanaaltoewijzing in alle huidige abonnementen.

BlueBubbles instellen

BlueBubbles is een afzonderlijke applicatie van derden die je op je eigen Mac installeert. Wij hosten deze niet — de app draait lokaal op jouw machine.

  1. Download en installeer BlueBubbles Server vanaf bluebubbles.app.
  2. Verleen de machtigingen waar het installatieprogramma om vraagt (Toegankelijkheid, Volledige schijftoegang, Automatisering). Hiermee kan BlueBubbles inkomende berichten lezen en de Berichten-app activeren om uitgaande berichten te versturen.
  3. Open BlueBubbles → Settings → API & Webhooks.
  4. Stel een serverwachtwoord in.
  5. Kopieer je server-URL (een openbaar adres dat naar je Mac wijst).
  6. Controleer in BlueBubbles of inkomende en uitgaande testberichten lokaal werken voordat je verdergaat.

Volledige installatie-instructies, probleemoplossing en platformspecifieke handleidingen vind je in de officiële BlueBubbles-documentatie. Als je vastloopt met BlueBubbles zelf, zijn hun documentatie en community de snelste weg naar hulp.


BlueBubbles verbinden met het platform

Zodra BlueBubbles op je Mac draait:

  1. Klik in de linkerzijbalk onderaan op Settings.
  2. Klik in de linkerzijbalk van Settings onder Channels op Channels.
  3. Zoek de iMessage-kaart en klik op Connect. (De Connect-knop wordt pas klikbaar zodra iMessage voor uw account is ingeschakeld — tot die tijd is deze grijs en toont de kaart de opmerking “iMessage is in private beta and isn’t enabled on your account yet.”)
  1. Plak uw BlueBubbles Server URL (bijv. https://your-tunnel.example.com).
  2. Plak uw BlueBubbles server password.
  3. Klik op Connect.

We verifiëren de verbinding door contact op te nemen met je BlueBubbles-server en de webhook automatisch te koppelen (een webhook is een webadres waarmee BlueBubbles het platform automatisch kan laten weten zodra er een nieuw bericht binnenkomt). Als alles in orde is, verandert de status in Connected.

  1. Open in BlueBubbles Settings → API & Webhooks → Webhooks en bevestig (of plak) de webhook-URL die op de iMessage-instellingenpagina wordt getoond.
  2. Sla op.

Dat is alles — inkomende iMessages komen nu in realtime in uw inbox aan.

De verbinding testen

Vanaf de iMessage-instellingenpagina kun je een test-iMessage naar elk telefoonnummer sturen om te bevestigen dat alles correct is ingesteld. Voer het telefoonnummer van de ontvanger in E.164-formaat in (bijv. +14155551234) samen met een kort bericht en verstuur de test.

De eerste testverzending kan tot een minuut duren, omdat de Berichten-app op uw Mac mogelijk een nieuwe gespreksreeks moet starten. Latere verzendingen zijn vrijwel direct.


Hoe berichten stromen

Inkomend

  1. Iemand stuurt een iMessage naar je Apple ID.
  2. De Berichten-app op je Mac ontvangt deze (net als normaal).
  3. BlueBubbles detecteert het nieuwe bericht en POST dit naar de webhook-URL.
  4. Het platform maakt een contact aan (indien nieuw), plaatst het bericht in Chats en — als je AI-agent voor dit kanaal actief is — antwoordt deze.

Uitgaand

  1. Jij of de AI stuurt een antwoord vanuit het platform.
  2. Wij sturen het bericht naar je BlueBubbles-server.
  3. BlueBubbles geeft de Berichten-app op je Mac de opdracht om de iMessage te versturen.
  4. De ontvanger ziet een normale blauwe iMessage van je Apple ID.

Ondersteunde berichttypen

  • Tekstberichten — volledig ondersteund in beide richtingen.
  • Bijlagen en media — inkomende bijlagen zijn zichtbaar in BlueBubbles, maar worden tijdens de Bèta nog niet in het platform opgenomen. Uitgaande berichten moeten tekst bevatten — het verzenden van afbeeldingen of bestanden via iMessage is nog niet beschikbaar.

Verzendlimieten, opwarmen & follow-up controles

iMessage heeft dezelfde soort beschermende verzendlimieten, automatische opwarming en follow-up kill-switch als WhatsApp Web en Telegram, met één verschil dat het weten waard is: op iMessage staan geautomatiseerde follow-ups standaard ingeschakeld op een nieuw verbonden account, dus schakel ze zelf uit als je wilt dat het account rustig blijft terwijl het opwarmt. Apple markeert agressief accounts die zich gedragen als bulkverzenders, dus deze vangrails bestaan om je Apple ID veilig te houden. Je vindt een kaart Verzendlimieten & Opwarming en een schakelaar Geautomatiseerde follow-ups op de iMessage-instellingenpagina zodra je verbonden bent.

Automatische opwarming (ramp-up)

Een nieuw verbonden iMessage-account wordt opzettelijk beperkt en ontgrendelt na verloop van tijd meer capaciteit. Het verdient alleen een “kwalificerende dag” op dagen dat het daadwerkelijk ten minste 75% van zijn huidige limiet verstuurt — inactieve dagen tellen niet mee.

  • Dagelijkse berichtlimiet = 50 + 8 × (day − 1), begrensd op 500/dag (bereikt op dag 58).
  • Dagelijkse limiet voor nieuwe contacten = floor((day − 1) × 5 / 6), begrensd op 50/dag (bereikt op dag 61).

De instellingenpagina toont de huidige opwarmdag, het verbruik van vandaag ten opzichte van de limiet en hoeveel er nog moet gebeuren. Als je Apple ID al een lange, authentieke iMessage-geschiedenis heeft, kun je de schuifregelaar voor de opwarmdag vooruit schuiven — maar doe dit alleen eerlijk, voor een account dat die geschiedenis ook echt heeft.

Handmatige overschrijving na opwarming

Na de volledige opwarmperiode van 58 dagen kun je met een optionele overschrijving de dagelijkse berichtlimiet verhogen tot boven de 500 (750 tot 5.000, in stappen van 250 berichten). Wees voorzichtig — Apple publiceert geen veilig getal en te veel verzenden brengt je Apple ID in gevaar. De overschrijving is pas beschikbaar zodra het account volledig is opgewarmd.

Verzendlimieten aan/uit & follow-up-noodschakelaar

Een hoofdschakelaar schakelt de verzendlimieten in of uit, en met een dagelijks plafond voor nieuwe contacten kun je het aantal eerste berichten lager begrenzen dan het opwarmtraject zou toestaan. De schakelaar Geautomatiseerde follow-ups stopt alle geautomatiseerde follow-ups voor het account, ongeacht de instellingen voor Broadcast/campagnes. Op iMessage staat deze schakelaar standaard aan, dus een vers verbonden account zal geautomatiseerde follow-ups versturen totdat je dit uitschakelt — en het uitschakelen ervan wordt aanbevolen zolang het account nieuw is (minder dan ~30 opwarmdagen). Wanneer het dagelijkse plafond is bereikt, worden geplande follow-ups naar de volgende dag verplaatst in plaats van dat ze mislukken.


Beperkingen van de iMessage-bèta

Omdat iMessage geen officiële API heeft, kent dit kanaal beperkingen die je niet zult tegenkomen bij WhatsApp, sms of Instagram. Lees deze zorgvuldig door voordat je voor bedrijfskritische berichten op iMessage vertrouwt.

  • Je Mac moet online en wakker blijven. Geen Mac, geen iMessages. We raden aan om de slaapstand uit te schakelen op de Mac waarop BlueBubbles draait, of hiervoor een toegewezen Mac mini te gebruiken.
  • Alleen één-op-één gesprekken via telefoonnummer. Groepschats en Apple ID-adressen (e-mail) worden tijdens de bèta niet officieel ondersteund en kunnen onverwacht gedrag vertonen als ze het platform bereiken — gebruik alleen één-op-één iMessage-gesprekken via telefoonnummers.
  • Alleen tekst. Berichten met alleen bijlagen (foto, video, bestand) worden bij inkomende berichten overgeslagen en uitgaande berichten moeten tekst bevatten. Het versturen van media wordt later in de bèta toegevoegd.
  • Geen sjablonen of vooraf goedgekeurde berichten. Alle berichten zijn vrije tekst.
  • Geen aflever- of leesbevestigingen in de platform-UI. Je ziet ze nog steeds in de Berichten-app op je Mac.
  • Een “Verzonden”-status betekent overgedragen, niet afgeleverd. Een “Verzonden”-status betekent dat het platform het bericht aan je Mac heeft overgedragen, niet dat de ontvanger het heeft ontvangen. Omdat iMessage geen betrouwbare afleverbevestiging heeft, worden sommige verzendingen optimistisch gemarkeerd als “Verzonden”, zelfs als je Mac de aflevering niet kon bevestigen (bijvoorbeeld als de ontvanger geen iMessage gebruikt). Controleer de Berichten-app op je Mac om er zeker van te zijn dat een bericht is aangekomen.
  • Typ-indicatoren vereisen de BlueBubbles Private API. Wanneer de AI een antwoord opstelt, ziet je contact een “aan het typen…”-bubbel — maar alleen als je de Private API-functies in BlueBubbles hebt ingeschakeld (Settings → Private API). Zonder deze functie worden antwoorden nog steeds normaal verzonden; het contact ziet alleen de typ-bubbel niet.
  • Eerste uitgaande bericht naar een nieuw contact kan traag zijn. Het starten van een gloednieuw gesprek kan 30–60 seconden duren terwijl macOS de thread opent; volgende berichten gaan snel.
  • Geen bulk- / uitzendberichten. Tijdens de bèta is iMessage het meest geschikt voor inkomende gesprekken en één-op-één antwoorden, niet voor grootschalige uitgaande uitzendingen. Apple beperkt en markeert agressief geautomatiseerd iMessage-verkeer.
  • Accountrisico. Apple keurt automatisering van iMessage door derden niet officieel goed. Overmatig of spamachtig gebruik van iMessage-automatisering kan ertoe leiden dat je Apple ID door Apple wordt gemarkeerd of beperkt. Gebruik het kanaal verantwoord.

Probleemoplossing

“Kan de BlueBubbles-server niet bereiken”

  • Bevestig dat BlueBubbles op je Mac draait en dat de groene indicator Server running zichtbaar is.
  • Bevestig dat je tunnel (Cloudflare / ngrok / Tailscale) actief is en dat de URL die je hebt geplakt bereikbaar is vanaf het openbare internet — open deze in een browser, je zou een welkomstpagina van BlueBubbles moeten zien.
  • Controleer dubbel of het serverwachtwoord overeenkomt met het wachtwoord dat is ingesteld in BlueBubbles → Settings → API.

Inkomende berichten verschijnen niet in de inbox

  • Open BlueBubbles → Settings → API & Webhooks → Webhooks en bevestig dat de webhook-URL die we je toonden exact zo is opgeslagen als weergegeven.
  • Gebruik op de iMessage-instellingenpagina Refresh status om te verifiëren of de verbinding nog gezond is.
  • Zorg ervoor dat het nummer van de afzender een telefoonnummer is en geen e-mailadres (e-mailadressen worden niet ondersteund in de bèta).
  • Bevestig dat je Mac een internetverbinding heeft en wakker is.

Uitgaande berichten worden niet verzonden

  • Test dezelfde ontvanger rechtstreeks vanuit de Berichten-app op je Mac. Als Berichten.app het ook niet kan verzenden (bijv. de ontvanger gebruikt geen iMessage), dan kan het platform dat ook niet.
  • Zorg ervoor dat je Mac niet in de sluimerstand staat, vergrendeld is met FileVault of een dialoogvenster voor systeemupdates toont — deze blokkeren AppleScript-automatisering, waar BlueBubbles van afhankelijk is.
  • Bevestig dat je voldoende tegoed op je account hebt.

Status toont “Connected” maar niets werkt

  • Gebruik Status vernieuwen op de iMessage-instellingenpagina om de verbinding opnieuw te verifiëren.
  • Als het nog steeds niet lukt, verbreek dan de verbinding en maak opnieuw verbinding met een nieuwe server-URL en wachtwoord.

Mijn Mac is opnieuw opgestart / heeft geen internet

Wanneer je Mac weer online komt en BlueBubbles opnieuw opstart, wordt de verbinding automatisch hervat. Alle berichten die naar je zijn verzonden terwijl de Mac offline was, verschijnen in de Berichten-app zodra deze weer verbinding maakt, maar ze worden mogelijk niet allemaal opnieuw in het platform geladen — iMessage biedt geen betrouwbare API voor het ophalen van oude berichten.


Hulp nodig?

iMessage bevindt zich momenteel in de bètafase. Als je problemen tegenkomt die we hierboven niet hebben behandeld, neem dan contact op met hi@youraiconnector.com met:

  • De server-URL waarmee je verbinding hebt gemaakt (zonder het wachtwoord).
  • Een beschrijving van het probleem en eventuele foutmeldingen van de iMessage-instellingenpagina.
  • Het tijdstip waarop het probleem zich voordeed.

We zullen er zo snel mogelijk naar kijken.