Een provider kan een nummer te koop aanbieden terwijl WhatsApp het niet accepteert. Door die kandidaat vooraf te controleren voorkom je dat je betaalt voor een nummer dat je niet kunt verbinden via de beoogde instellingsprocedure.
Hoe voer ik de nummerprecheck van Bird uit?
Gebruik bird whatsapp numbers precheck met het kandidaatnummer voordat je het koopt.
bird whatsapp numbers precheck +31612345678Geef het nummer op in internationaal formaat met een voorloopteken + en landcode. Het API-verzoek bevat het in phone_number. Je hoeft het nummer nog niet in bezit te hebben.
Het endpoint is POST /v1/whatsapp/numbers/precheck. Gebruik een ingelogde CLI of MCP-grant met whatsapp_management:write, zoals vereist door de commandoreferentie.
| Vlag | Wat je ermee kunt inspecteren |
|---|---|
--example | De request-body zonder credentials |
--dry-run | Het opgebouwde verzoek zonder het te versturen |
--response-schema | De antwoordvelden |
Een MCP-client roept dezelfde operatie aan via whatsapp_numbers_precheck.
Wat betekenen available en unavailable?
available betekent dat de controle op dat moment geen belemmering vond om het nummer te verbinden. unavailable betekent dat WhatsApp het geweigerd heeft.
| Resultaat | Wat te doen met een aankoopkandidaat |
|---|---|
available | Ga verder met de aankoopcontroles, wetende dat het resultaat het nummer niet reserveert |
unavailable | Sla die kandidaat over; onderzoek de registratie als je het nummer al bezit |
Een unavailable nummer is mogelijk al geregistreerd bij WhatsApp of is een nummer dat WhatsApp niet kan bedienen. Het resultaat maakt geen onderscheid tussen die redenen, dus leid er niet zelf één af uit het resultaat alleen.
Een mislukt verzoek is iets anders dan een unavailable-resultaat. Verwerk de geretourneerde API-fout voordat je de kandidaat als ongeschikt beschouwt.
Verandert de controle iets?
Ja. De controle stuurt de kandidaat naar WhatsApp. Meta kan een tijdelijke vermelding aanmaken onder het zakelijke account van Bird.
Het nummer wordt niet verbonden met je werkruimte en niet gereserveerd voor aankoop. Controleer alleen de kandidaat die je wilt kopen, want het doorlopen van een hele lijst kan tijdelijke vermeldingen achterlaten voor ongebruikte nummers.
Hergebruik een Idempotency-Key wanneer je dezelfde controle opnieuw uitvoert. Gedurende het antwoordvenster van drie uur van Bird retourneert dezelfde sleutel het opgeslagen antwoord in plaats van WhatsApp opnieuw te bevragen.
De Idempotency-Replay-antwoordheader identificeert die replay. Zodra het antwoordvenster is verlopen, kan dezelfde sleutel een nieuwe controle starten.
Waar past de controle in het aankoopproces van een nummer?
Controleer de beschikbaarheid bij de provider en de acceptatie door WhatsApp voordat je de nummerbestelling plaatst.
- Zoek met
bird numbers available list --country-code US. - Controleer de geselecteerde kandidaat opnieuw met
bird numbers available get. - Voer de WhatsApp-precheck uit op die kandidaat.
- Bestel pas na
available, metbird numbers orders create.
Een 404 bij de hercontrole op providerbeschikbaarheid betekent dat je een andere kandidaat nodig hebt. Rond eventuele vereiste organisatieverificatie in het dashboard af voordat je bestelt.
Een pending-bestelling vereist nog steeds dat de provider de provisioning voltooit. Wacht tot de bestelling is afgerond voordat je op het nummer vertrouwt.
Wat als ik het nummer al bezit?
Gebruik het resultaat om de verbindingsgereedheid te onderzoeken in plaats van om een aankoopbeslissing te nemen.
De eigen-nummer-setup van Bird kan een nummer niet verbinden zolang de registratie bij de consumenten- of WhatsApp Business-app actief is. Los die registratie op met de accounteigenaar voordat je de verbinding probeert.
Een nummer dat slaagt, moet nog steeds het verbindingsproces doorlopen. Bevestig dat de status Connected bereikt voordat je het als je merkafzender gebruikt.
Door Bird beheerde afzenders zijn een aparte optie voor de beheerde authenticatie- en utilitytemplates. Ze versturen niet je vrije content en ontvangen geen klantreacties in je werkruimte.
Kort gezegd
Controleer voordat je koopt.
Een nummerzoekopdracht stelt geen WhatsApp-compatibiliteit vast. Voer de precheck uit op de kandidaat die je wilt kopen.
Interpreteer unavailable zonder zelf een reden te verzinnen.
Het nummer is mogelijk al geregistreerd of wordt niet ondersteund. Het resultaat maakt geen onderscheid tussen die gevallen.
Behandel de precheck als een schrijfactie.
De precheck stuurt het nummer naar WhatsApp en kan een tijdelijke vermelding aanmaken. Het nummer wordt niet gereserveerd of verbonden.
Hergebruik retry-sleutels voor dezelfde controle.
Een idempotency-replay retourneert het opgeslagen antwoord. Dat antwoord beschrijft de eerdere controle, niet een nieuwe beschikbaarheidsgarantie.