API-integratiehandleiding
Verbind je CRM, boekingssysteem of elke applicatie om WhatsApp-berichten te versturen via onze eenvoudige API.
Aan de slag in 5 eenvoudige stappen
Download de desktop-app
Download en installeer All-in-One Messenger Hub op je Windows-computer.
Verbind je WhatsApp
Voeg je WhatsApp-account toe aan de app door de QR-code te scannen.
Maak een Session API
Ga naar het WhatsApp-tabblad en maak een nieuwe Session API. Koppel deze aan je WhatsApp-kanaal.
Kopieer je API-sleutel
Kopieer de gegenereerde API-sleutel. Bewaar hem veilig - het is je authenticatie.
Begin met berichten versturen
Gebruik de API vanuit je applicatie. Houd de desktop-app actief om berichten te bezorgen.
Authenticatie
Alle API-endpoints vereisen authenticatie via je API-sleutel. Je kunt de sleutel op een van deze manieren doorgeven:
| Methode | Voorbeeld |
|---|---|
| X-API-Key-header (aanbevolen) | X-API-Key: your-api-key |
| Query-/body-parameter | key=your-api-key |
| Alternatieve parameter | api_key=your-api-key |
Bericht versturen
Verstuur een WhatsApp-bericht naar een telefoonnummer of groep. Berichten worden in de wachtrij gezet en bezorgd wanneer de desktop-app actief is.
POST https://onemessengerhub.com/api/whatsapp-session/send
Parameters
| Parameter | Type | Vereist | Beschrijving |
|---|---|---|---|
key |
string | Ja | Je API-sleutel uit de desktop-app |
mobile |
string | Voorwaardelijk | Telefoonnummer met landcode (vereist zonder group_id) |
group_id |
string | Voorwaardelijk | WhatsApp-groeps-ID (vereist zonder mobile). Het achtervoegsel @g.us wordt automatisch toegevoegd. |
message |
string | Ja | Berichttekst (max. 4096 tekens) |
Voorbeeldverzoek
curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mobile": "1234567890", "message": "Hello!"}'
Eenvoudig GET-verzoek (browser of link)
https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!
Geslaagde respons (201)
{
"success": true,
"message": "Message queued successfully",
"data": {
"message_id": 123,
"recipient": "1234567890",
"status": "pending"
}
}
Contact opslaan
Sla een contact op of hernoem het in je WhatsApp. De bewerking wordt in de wachtrij gezet en verwerkt door de desktop-app.
POST https://onemessengerhub.com/api/whatsapp-session/save-contact
Parameters
| Parameter | Type | Vereist | Beschrijving |
|---|---|---|---|
key |
string | Ja | Je API-sleutel uit de desktop-app |
contact_id |
string | Ja | Telefoonnummer of WhatsApp-ID van het contact (max. 50 tekens). Het achtervoegsel @c.us wordt automatisch toegevoegd. |
name |
string | Ja | Weergavenaam voor het contact (max. 255 tekens) |
Voorbeeldverzoek
curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_id": "1234567890", "name": "John Doe"}'
Geslaagde respons (201)
{
"success": true,
"message": "Contact save operation queued",
"data": {
"operation_id": 456,
"contact_id": "[email protected]",
"status": "pending"
}
}
Contact verwijderen
Verwijder een contact uit je WhatsApp. De bewerking wordt in de wachtrij gezet en verwerkt door de desktop-app.
POST https://onemessengerhub.com/api/whatsapp-session/remove-contact
Parameters
| Parameter | Type | Vereist | Beschrijving |
|---|---|---|---|
key |
string | Ja | Je API-sleutel uit de desktop-app |
contact_id |
string | Ja | Telefoonnummer of WhatsApp-ID van het contact (max. 50 tekens). Het achtervoegsel @c.us wordt automatisch toegevoegd. |
Voorbeeldverzoek
curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_id": "1234567890"}'
Geslaagde respons (201)
{
"success": true,
"message": "Contact remove operation queued",
"data": {
"operation_id": 789,
"contact_id": "[email protected]",
"status": "pending"
}
}
Foutafhandeling
De API gebruikt standaard HTTP-statuscodes. Hier zijn de veelvoorkomende foutresponsen:
Authenticatiefout (401)
{
"success": false,
"message": "Invalid or inactive API key"
}
Validatiefout (422)
{
"success": false,
"message": "Validation failed",
"errors": {
"mobile": ["The mobile field is required when group id is not present."],
"message": ["The message field is required."]
}
}
Wat je kunt bouwen
CRM-integratie
Stuur opvolgberichten, herinneringen en updates rechtstreeks vanuit je CRM-systeem.
Boekingsbevestigingen
Stuur automatisch afspraakbevestigingen en herinneringen naar klanten.
Bestelmeldingen
Informeer klanten over de bestelstatus, verzendupdates en bezorginformatie.
Waarschuwingssystemen
Stuur belangrijke waarschuwingen en meldingen naar je team of klanten.
Marketingcampagnes
Stuur promotieberichten en updates naar je contactenlijst.
Aangepaste workflows
Integreer met Zapier, Make, n8n of elk automatiseringsplatform.
Meer API's binnenkort beschikbaar
We breiden ons API-aanbod uit om meer platforms en gebruikssituaties te dekken.
Chatbot-API
Activeer chatbotantwoorden en beheer gesprekken programmatisch.
Contacten-API
Krijg toegang tot en beheer je messengercontacten op alle platforms.
Webhooks
Ontvang realtime meldingen wanneer berichten worden ontvangen of verzonden.
All-in-One Messenger Hub