Docs
Documentation
Everything you need to send WhatsApp messages with Darkel — from your first test message to a production integration. Start with the basics, or jump straight to the API reference.
Built for you and your AI
Every page and section has a Copy as prompt button. It copies a clean, AI-ready version of these docs — paste it into ChatGPT, Claude or your coding assistant and ask it to wire up the integration for you.
- Getting startedCreate your account, set up a workspace, and send your first WhatsApp message in a few minutes.
- Core conceptsThe handful of ideas that everything else builds on: workspaces, sandbox vs live, the prepaid balance, templates, and how billing works.
- Authentication & API keysHow your backend authenticates with Darkel: create an API key, send it with every request, and keep it safe.
- WhatsApp messagingConnect a number, create approved templates, send messages, and track delivery — by hand or from your code.
- Delivery & errorsHow a message moves from sent to delivered, what happens when it fails, automatic refunds, and how to read Meta error codes.
- Billing & pricingHow the prepaid balance works, topping up, live pricing, enrolment, low-balance alerts, and refunds.
- API referenceThe programmatic surface: base URL, authentication, the send endpoint, public pricing, the response envelope, and errors.
- Getting helpHow to reach the Darkel team, what to include so we can help fast, and where to send each kind of question.
The 30-second version
Create an API key in the dashboard, then send an approved template message from your backend:
Send a message
curl -X POST https://api.darkel.ng/v1/whatsapp/messages \
-H "X-Api-Key: dk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+2348012345678",
"template": { "name": "hello_world", "languageCode": "en_US" }
}'