De history-webhook
history bevat de eenmalige overdracht van de bestaande gesprekken van een Coexistence-nummer naar de API. Het veld verschijnt na onboarding wanneer het delen van history is geaccepteerd. Het is het enige signaal dat een integratie krijgt dat de overdracht überhaupt heeft plaatsgevonden.
De periode na onboarding waarin de synchronisatie moet starten.
De fout die wordt teruggegeven wanneer de synchronisatie al is gebruikt.
De fout die wordt teruggegeven wanneer de synchronisatie buiten die periode wordt geprobeerd.
Wat het levert
De één-op-één-berichtgeschiedenis die al in de WhatsApp Business-app stond, zodat software niet blind begint op een nummer dat een bedrijf al jaren gebruikt.
Groepsgesprekken worden niet meegeleverd. Die zijn op een Coexistence-nummer volledig uitgesloten van de API. Ook de eigen functies van de app komen niet mee: labels, snelle antwoorden, begroetingen en afwezigheidsberichten hebben geen API-equivalent en blijven op het apparaat.
Dit veld bestaat alleen voor Coexistence-nummers. Een nummer dat op de gewone manier is onboarded, heeft geen eerdere appgeschiedenis om over te dragen, dus er valt niets te leveren.
Waarom het één keer wordt verzonden
Omdat de overdracht onderdeel is van onboarding en geen doorlopende functie.
Tijdens Embedded Signup wordt de bedrijfseigenaar gevraagd of bestaande gesprekken mogen worden gedeeld. Ja antwoorden maakt de synchronisatie mogelijk. Daarna is er geen instelling om dit opnieuw in te schakelen en geen endpoint om het te herhalen. Een tweede poging geeft 2593107 terug, geen tijdelijke limiet die vanzelf verdwijnt.
Er geldt ook een deadline. De synchronisatie moet binnen 24 uur na onboarding starten. Een latere poging geeft 2593108 terug. Als een van beide voorwaarden niet wordt gehaald, moet je het nummer loskoppelen en de volledige flow opnieuw uitvoeren.
Wat een handler ermee moet doen
Behandel het als een eenmalige batch die groot kan zijn, niet als extra verkeer op het berichtenpad.
- Bevestig de ontvangst snel en verwerk de batch asynchroon, zoals elke andere levering.
- Voorkom duplicaten op bericht-id: history en live berichten kunnen rond het moment van onboarding overlappen.
- Verwacht dat het veld ontbreekt. Een nummer waarvan de eigenaar history heeft geweigerd, verzendt hier niets. De integratie moet in beide gevallen werken.
- Blokkeer onboarding niet. De verbinding kan al worden gebruikt voordat de overdracht klaar is.
Veelgemaakte fouten
- Een integratie bouwen die vereist dat history aanwezig is. Veel nummers worden zonder history verbonden.
- De synchronisatie na 2593107 opnieuw proberen. Het is een eenmalige gebeurtenis, dus de poging geeft dezelfde fout terug.
- De keuze voor history uitstellen tot het integratiewerk begint. Meestal is de periode van 24 uur dan al verstreken.
EasyCoexistence legt onboarding en de keuze voor history vast in de tijdlijn van de verbinding. Zo is het duidelijk of een nummer is gesynchroniseerd en op welke dag, zonder dit later te reconstrueren.
Veelgestelde vragen
Hoeveel history wordt overgedragen?
Een venster met recente één-op-één-gesprekken, bepaald door Meta en niet door een provider.
Komen groepsgesprekken mee?
Nee. Groepen zijn op een Coexistence-nummer volledig uitgesloten van de API.
Kan ik dit later opnieuw aanvragen?
Nee. Het proces loopt één keer per onboarding. Opnieuw uitvoeren betekent het nummer loskoppelen en opnieuw verbinden.
Wat als de eigenaar history heeft geweigerd?
Er verschijnt niets op dit veld. De API ziet alleen berichten vanaf het moment waarop het nummer werd verbonden.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op