مرجع واجهة برمجة التطبيقات والويب هوكس

{ "data": { "status": "ok", "timestamp": "2026-04-22T12:00:00Z" } }

curl -X POST https://zagely.com/api/v1/messages/send \
            -H "X-Public-Key: pk_your_public_key" \
            -H "X-Secret-Key: sk_your_secret_key" \
            -H "Content-Type: application/json" \
            -d '{
            "channel": "whatsapp",
            "session_id": "11111111-2222-3333-4444-555555555555",
            "to": "+15551234567",
            "message": "Hello from Zagely! 👋"
            }'

// 200 Response
            {
            "current_page": 1,
            "data": [
            {
            "id": "11111111-2222-3333-4444-555555555555",
            "name": "Customer Support",
            "phone_number": "+15551234567",
            "status": "connected",
            "daily_limit": 500,
            "warmup_enabled": true,
            "created_at": "2026-01-10T08:00:00Z"
            }
            ],
            "total": 3
            }

// 201 Response
            {
            "id": "11111111-2222-3333-4444-555555555555",
            "name": "Customer Support",
            "status": "connecting",
            "qr_code": "data:image/png;base64,iVBOR..."
            }

// 200 Response
            {
            "current_page": 1,
            "data": [
            {
            "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
            "name": "Jane Doe",
            "phone_number": "+15551234567",
            "email": "jane@example.com",
            "tags": ["vip", "active"],
            "is_blocked": false,
            "opted_out_at": null,
            "custom_fields": { "city": "New York" },
            "groups": [{ "id": "...", "name": "VIP Customers" }],
            "created_at": "2026-01-15T09:00:00Z"
            }
            ],
            "total": 842,
            "per_page": 50
            }

curl -X POST https://zagely.com/api/v1/contacts \
            -H "X-Public-Key: pk_your_public_key" \
            -H "X-Secret-Key: sk_your_secret_key" \
            -H "Content-Type: application/json" \
            -d '{
            "phone_number": "+15551234567",
            "name": "Jane Doe",
            "email": "jane@example.com",
            "tags": ["vip", "newsletter"],
            "custom_fields": { "city": "New York", "plan": "gold" }
            }'

// Static group
            { "name": "VIP Customers", "type": "static" }

            // Dynamic group
            {
            "name": "New VIPs",
            "type": "dynamic",
            "filters": { "tags": ["vip"], "created_from": "2026-01-01" }
            }

curl -X POST https://zagely.com/api/v1/contact-groups \
            -H "X-Public-Key: pk_your_public_key" \
            -H "X-Secret-Key: sk_your_secret_key" \
            -H "Content-Type: application/json" \
            -d '{ "name": "VIP Customers", "type": "static" }'

# Add contacts to a static group — by UUID or phone number
            curl -X POST https://zagely.com/api/v1/contact-groups/{group_id}/contacts \
            -H "X-Public-Key: pk_your_public_key" \
            -H "X-Secret-Key: sk_your_secret_key" \
            -H "Content-Type: application/json" \
            -d '{ "phone_numbers": ["+201140220996", "+201001234567"] }'

{
            "name": "Order Confirmation",
            "channel": "whatsapp",
            "content": "Hi {{ name }}! Your order #{{ order_id }} is confirmed.
            We ship by {{ ship_date }}. 🎉"
            }

// By contact
            { "contact_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" }

            // By values
            { "variables": { "name": "Jane", "order_id": "ORD-001", "ship_date": "April 25" } }

curl -X POST https://zagely.com/api/v1/campaigns \
            -H "X-Public-Key: pk_your_public_key" \
            -H "X-Secret-Key: sk_your_secret_key" \
            -H "Content-Type: application/json" \
            -d '{
            "name": "April Flash Sale",
            "channel": "whatsapp",
            "session_id": "11111111-2222-3333-4444-555555555555",
            "message_content": "Hi {{ name }}! Flash sale — 30% off today only. Shop
            now 👉 https://example.com/sale",
            "target_type": "group",
            "target_filters": { "group_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" },
            "scheduled_at": "2026-04-25T09:00:00Z"
            }'

{
            "total_recipients": 1500,
            "sent_count": 1450,
            "delivered_count": 1380,
            "read_count": 920,
            "failed_count": 50,
            "pending_count": 0,
            "delivery_rate": 95.17,
            "read_rate": 66.67
            }

{
            "session_id": "11111111-2222-3333-4444-555555555555",
            "name": "Price Enquiry Reply",
            "channel": "whatsapp",
            "trigger_type": "keyword",
            "trigger_value": "price",
            "response_content": "Hi {{ name }}! Our plans start at $29/month. Visit
            https://example.com/pricing for details.",
            "priority": 10
            }

$timestamp = $_SERVER['HTTP_X_ZAGELY_TIMESTAMP'] ?? '';
            $signature = $_SERVER['HTTP_X_ZAGELY_SIGNATURE'] ?? '';
            $body = file_get_contents('php://input');

            $expected = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $body,
            'your_webhook_secret');

            if (! hash_equals($expected, $signature)) {
            http_response_code(401); exit;
            }

            $event = json_decode($body, true);

{
            "event": "message.received",
            "tenant_id": "uuid-of-tenant",
            "delivery_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
            "occurred_at": "2026-04-21T10:30:00Z",
            "data": {
            "contact": { "id": "...", "name": "Jane Doe", "phone_number": "+15551234567", "email":
            null },
            "channel": "whatsapp",
            "content": "Hello, I need help with my order."
            }
            }