Coexistence-referentie

Wat het is

Meta's officiële modus om de WhatsApp Business-app en de Cloud API tegelijk op één telefoonnummer te gebruiken. Geen aparte API: dezelfde Cloud API, zo ingesteld dat de app daarna op het nummer blijft werken.

Waarom teams het gebruiken

Vier redenen verklaren vrijwel elke verbinding.

• Behoud het nummer dat al op voertuigen, kassabonnen en een website staat.
• Voeg API-verzending, webhooks en templates toe zonder iemand naar een nieuw hulpmiddel te verplaatsen.
• Houd gesprekken buiten de gedeelde inbox van een aanbieder.
• Laat een bureau veel klantnummers beheren, elk in het eigen portfolio van de klant.

Hoe communicatie werkt

Beide oppervlakken zien dezelfde thread. Wat de API verzendt, verschijnt in de app. Wat het team in de app typt, bereikt software als een smb_message_echoes-event. Daardoor antwoordt automatisering niet over een mens heen.

Prijsstelling

Meta rekent gesprekken af in plaats van berichten en brengt ze in rekening via de betaalmethode van je eigen WhatsApp Business Account. Antwoorden binnen het klantenservicevenster van 24 uur zijn gratis. Buiten dat venster moet je een template gebruiken en betaal je ervoor.

Gekoppelde apparaten

Coexistence is geen gekoppeld apparaat en gebruikt er geen. Een gekoppeld apparaat is de consumentenclient waarmee je elders bent aangemeld. Niet-officiële hulpmiddelen automatiseren die client, wat de voorwaarden van WhatsApp verbieden. Niets hier gebruikt dat mechanisme.

Functionele beperkingen

Door Meta bepaald en bij elke aanbieder hetzelfde.

• Groepschats zijn niet beschikbaar via de API.
• Templates kunnen niet vanuit de telefoonapp worden verzonden, alleen via de API.
• De verzendsnelheid ligt vast en schaalt niet mee met kwaliteit en niveau.
• Het delen van chatgeschiedenis wordt tijdens het onboarden één keer bepaald.

Voorwaarden

Het nummer moet aan al deze voorwaarden voldoen voordat het kan verbinden.

• Al actief in de WhatsApp Business-app, niet in de consumentenapp.
• In een Business Portfolio waartoe je toegang hebt.
• Nog niet verbonden met de app van een andere aanbieder.

Operationele opmerkingen

Dit zijn zaken die na het verbinden waar zijn en die je makkelijk over het hoofd ziet.

• De app moet regelmatig worden geopend, anders verbreekt Meta de API-kant.
• Bij een verbreking wordt de webhook-override samen met de app verwijderd.
• De kwaliteitsbeoordeling wordt opgevraagd, niet gepusht, dus een daling wordt niet aangekondigd.
• Een ingetrokken token ziet er zonder tweede legitimatie hetzelfde uit als een verwijderd nummer.

Aandachtspunt bij accountkeuze

Tijdens Embedded Signup kies je het Business Portfolio en het WhatsApp Business Account in afzonderlijke stappen. Het verkeerde account kiezen koppelt het nummer ergens waar je het niet bedoeld had. Verplaatsen betekent daarna de verbinding verbreken en de hele flow opnieuw uitvoeren.

Beslissingen voor één keer

Het delen van bestaande chatgeschiedenis wordt één keer gevraagd en kan niet opnieuw worden bekeken. De synchronisatie moet ook binnen 24 uur na het onboarden starten en kan maar één keer worden uitgevoerd. Als je dit mist, krijg je onbekende fouten in plaats van waarschuwingen.

Verbinding verbreken of terugdraaien

Je kunt een nummer op elk moment loskoppelen, via het dashboard of de connector. De WhatsApp Business-app gaat precies verder zoals daarvoor, met gesprekken en geschiedenis intact. Het nummer zelf verandert niet permanent doordat het verbonden is geweest.

Veelgemaakte fouten

• Coexistence behandelen als een andere API. Het is de Cloud API met een ander onboardingproces.
• Bouwen rond groepschats. Die zijn bij elke aanbieder uitgesloten.
• Aannemen dat opnieuw verbinden de webhook-bestemming herstelt. Dat gebeurt niet.

Veelgestelde vragen

Lees verder