اربط نظامك بـ MessageHub في دقائق

curl https://derha.net/api/v1/businesses \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

{
  "success": true,
  "message": "...",
  "data": {
    "businesses": [
      {
        "id": "9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
        "name": "Al Amal Store",
        "numbers": [
          {
            "number_id": "7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b",
            "name": "Sales",
            "phone": "9665xxxxxxxx",
            "channel": "whatsapp",
            "status": "connected",
            "connected": true
          }
        ]
      }
    ]
  }
}

curl https://derha.net/api/v1/businesses/9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

curl https://derha.net/api/v1/numbers \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

{
  "success": true,
  "data": {
    "numbers": [
      {
        "id": "7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b",
        "business_id": "9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
        "name": "Sales",
        "phone": "201014642581",
        "channel": "whatsapp",
        "handle": null,
        "can_initiate": "any",
        "status": "connected",
        "connected": true,
        "official": true,
        "mode": "conversations",
        "created_at": "2026-09-01T10:00:00+00:00"
      }
    ]
  }
}

curl -X POST https://derha.net/api/v1/messages/send \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4821" \
  -d '{
  "number_id": "7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b",
  "to": "201014642581",
  "type": "text",
  "text": "Hello, your order #4821 has shipped."
}'

curl -X POST https://derha.net/api/v1/messages/send \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret" \
  -H "Content-Type: application/json" \
  -d '{
  "conversation_id": "9c0d1e2f-3a4b-5c6d-7e8f-9a0b1c2d3e4f",
  "text": "We received your message."
}'

const res = await fetch("https://derha.net/api/v1/messages/send", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.MESSAGEHUB_TOKEN,
    "Content-Type": "application/json",
    "Idempotency-Key": "order-4821",
  },
  body: JSON.stringify({
    number_id: "7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b",
    to: "201014642581",
    type: "text",
    text: "Hello, your order #4821 has shipped.",
  }),
})
const data = await res.json()
if (!data.success) throw new Error(data.code)

import os, requests

res = requests.post(
    "https://derha.net/api/v1/messages/send",
    headers={
        "Authorization": "Bearer " + os.environ["MESSAGEHUB_TOKEN"],
        "Idempotency-Key": "order-4821",
    },
    json={
        "number_id": "7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b",
        "to": "201014642581",
        "type": "text",
        "text": "Hello, your order #4821 has shipped.",
    },
    timeout=10,
)
data = res.json()
if not data["success"]:
    raise RuntimeError(data["code"])

$response = Http::withToken(env('MESSAGEHUB_TOKEN'))
    ->withHeaders(['Idempotency-Key' => 'order-4821'])
    ->post('https://derha.net/api/v1/messages/send', [
        'number_id' => '7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b',
        'to'        => '201014642581',
        'type'      => 'text',
        'text'      => 'Hello, your order #4821 has shipped.',
    ]);

{
  "success": true,
  "message": "...",
  "data": {
    "message": {
      "id": "3c9d8e7f-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
      "number_id": "7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b",
      "to": "201014642581",
      "type": "text",
      "status": "queued",
      "created_at": "2026-07-11T10:00:00+00:00"
    }
  }
}

curl https://derha.net/api/v1/custom-messages \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

curl -X POST https://derha.net/api/v1/messages/send-custom \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: otp-2026-09-03-1" \
  -d '{
  "number_id": "7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b",
  "to": "201014642581",
  "custom_message_id": "lib:otp",
  "values": { "2": "482913", "3": "10 minutes" }
}'

curl https://derha.net/api/v1/messages/show/3c9d8e7f-1a2b-3c4d-5e6f-7a8b9c0d1e2f \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

{
  "success": true,
  "message": "...",
  "data": {
    "message": {
      "id": "3c9d8e7f-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
      "send_type": "single",
      "number_id": "7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b",
      "to": "201014642581",
      "type": "text",
      "text": "Hello, your order #4821 has shipped.",
      "status": "delivered",
      "failure_reason": null,
      "failure_category": null,
      "failure_message": null,
      "created_at": "2026-07-11T10:00:00+00:00",
      "sent_at": "2026-07-11T10:00:01+00:00",
      "delivered_at": "2026-07-11T10:00:04+00:00",
      "read_at": null,
      "failed_at": null,
      "history": [
        { "at": "2026-07-11T10:00:00+00:00", "event": "queued" },
        { "at": "2026-07-11T10:00:01+00:00", "event": "attempt", "attempt": 1 },
        { "at": "2026-07-11T10:00:01+00:00", "event": "sent" },
        { "at": "2026-07-11T10:00:04+00:00", "event": "delivered" }
      ]
    }
  }
}

curl "https://derha.net/api/v1/messages/list?number_id=7f2a1c9e-3b4d-5e6f-7a8b-9c0d1e2f3a4b&status=delivered&per_page=25" \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

curl "https://derha.net/api/v1/messages/inbound?since=2026-10-03T00:00:00Z&per_page=50" \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

curl -o photo.jpg "https://derha.net/api/v1/media/01a0ff03-16e0-7350-a174-d09c254ee041" \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

curl https://derha.net/api/v1/balance \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

{
  "success": true,
  "data": {
    "api_enabled": true,
    "messages": { "granted": 10000, "used": 2310, "remaining": 7690, "unlimited": false },
    "ai_points": { "granted": 500, "used": 120, "remaining": 380, "unlimited": false }
  }
}

curl https://derha.net/api/v1/webhooks/events \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

curl https://derha.net/api/v1/webhooks \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

curl -X POST https://derha.net/api/v1/webhooks/WEBHOOK_ID/test \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

curl "https://derha.net/api/v1/webhooks/deliveries?status=failed" \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"

curl -X POST https://derha.net/api/v1/webhooks/deliveries/DELIVERY_ID/redeliver \
  -H "Authorization: Bearer mh_live_xxxxxxxxxxxxxxxx_your_secret"