Documentation

Getting started

In vijf stappen van nul naar je eerste verstuurde WhatsApp-bericht via API.

1. Account aanmaken

Ga naar /signup en kies een plan. Voor het uitproberen kies je Free — 50 berichten/maand, lifetime, geen creditcard.

2. Inloggen op de admin

Na het aanmaken kom je meteen in je portal op textmeflow.eu/admin/portal. Daar zie je je API-key, je verbruik en de knop om je WhatsApp te koppelen. Later terugkomen? Via /login mailen we je een inloglink — je hebt geen wachtwoord nodig.

3. Telefoon koppelen

Open op je telefoon WhatsApp → Instellingen → Gekoppelde apparaten → Apparaat koppelen. Scan de QR-code in de admin. Je sessie blijft ingelogd zolang je telefoon af en toe online komt.

4. Eerste bericht versturen

# Vervang $TMF_API_KEY door de key uit je admin
curl -X POST https://api.textmeflow.eu/v1/messages \
  -H "Authorization: Bearer $TMF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+32479123456",
    "text": "Hallo van TextMeFlow"
  }'

5. Webhook voor antwoorden

Wil je inkomende berichten ontvangen? Configureer een webhook URL onder /admin/webhook. TextMeFlow POST't elk inkomend bericht als JSON, gesigneerd met HMAC-SHA256 in de X-TextMeFlow-Signature header. Payload is 1-op-1 compatibel met TextMeBot — bestaande integraties werken zonder aanpassingen.

# Voorbeeld payload (TextMeBot-compatibel)
{
  "type": "text",
  "from": "32479123456",
  "from_name": "Jan Janssens",
  "to": "32499123456",
  "file": "null",
  "message": "Bedankt!"
}

Volledige documentatie + verify-snippets in PHP/Node/Python: /docs/webhooks.