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

1

Download de desktop-app

Download en installeer All-in-One Messenger Hub op je Windows-computer.

2

Verbind je WhatsApp

Voeg je WhatsApp-account toe aan de app door de QR-code te scannen.

3

Maak een Session API

Ga naar het WhatsApp-tabblad en maak een nieuwe Session API. Koppel deze aan je WhatsApp-kanaal.

4

Kopieer je API-sleutel

Kopieer de gegenereerde API-sleutel. Bewaar hem veilig - het is je authenticatie.

5

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
POST

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"
  }
}
POST

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"
  }
}
POST

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.

Binnenkort beschikbaar

Chatbot-API

Activeer chatbotantwoorden en beheer gesprekken programmatisch.

Binnenkort beschikbaar

Contacten-API

Krijg toegang tot en beheer je messengercontacten op alle platforms.

Binnenkort beschikbaar

Webhooks

Ontvang realtime meldingen wanneer berichten worden ontvangen of verzonden.