التوثيق

الرابط الأساسي

https://talyapp.net/api

المصادقة

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json
Content-Type: application/json

جهات الاتصال

GET/api/contacts

جلب قائمة جهات الاتصال

curl -X GET "https://talyapp.net/api/contacts?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

POST/api/contacts

إضافة جهة اتصال

curl -X POST "https://talyapp.net/api/contacts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com",
  "phone": "+966500000001",
  "group": ["00000000-0000-4000-8000-000000000000"]
}'

PUT/api/contacts/{uuid}

تعديل جهة الاتصال

curl -X PUT "https://talyapp.net/api/contacts/00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.updated@example.com",
  "phone": "+966500000001"
}'

DELETE/api/contacts/{uuid}

حذف جهة اتصال

مجموعات جهات الاتصال

GET/api/contact-groups

جلب قائمة مجموعات جهات الاتصال

curl -X GET "https://talyapp.net/api/contact-groups?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

POST/api/contact-groups

إضافة مجموعة جهات اتصال

curl -X POST "https://talyapp.net/api/contact-groups" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "VIP leads"
}'

PUT/api/contact-groups/{uuid}

تعديل مجموعة جهات اتصال

curl -X PUT "https://talyapp.net/api/contact-groups/00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Qualified buyers"
}'

DELETE/api/contact-groups/{uuid}

حذف مجموعة جهات اتصال

curl -X DELETE "https://talyapp.net/api/contact-groups/00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

الردود الآلية

GET/api/canned-replies

جلب الردود الآلية

curl -X GET "https://talyapp.net/api/canned-replies?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

POST/api/canned-replies

إضافة رد آلي

curl -X POST "https://talyapp.net/api/canned-replies" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Business hours",
  "trigger": "hours",
  "match_criteria": "contains",
  "response_type": "text",
  "response": "Our team is available Sunday to Thursday from 9 AM to 6 PM."
}'

PUT/api/canned-replies/{uuid}

تعديل رد آلي

curl -X PUT "https://talyapp.net/api/canned-replies/00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Business hours",
  "trigger": "working hours",
  "match_criteria": "contains",
  "response_type": "text",
  "response": "Our team is available during official working hours."
}'

DELETE/api/canned-replies/{uuid}

حذف رد آلي

curl -X DELETE "https://talyapp.net/api/canned-replies/00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

الرسائل

POST/api/send

إرسال رسالة

curl -X POST "https://talyapp.net/api/send" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "+966500000001",
  "message": "Hello John, how can we help you today?",
  "header": "Customer support",
  "footer": "Reply with one of the options below",
  "buttons": [
    { "id": "sales", "title": "Sales" },
    { "id": "support", "title": "Support" }
  ]
}'

POST/api/send/media

إرسال وسائط

curl -X POST "https://talyapp.net/api/send/media" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "+966500000001",
  "media_type": "image",
  "media_url": "https://example.com/property.jpg",
  "caption": "Attached property image",
  "file_name": "property.jpg"
}'

POST/api/send/template

إرسال قالب

curl -X POST "https://talyapp.net/api/send/template" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "+966500000001",
  "template": {
    "name": "appointment_reminder",
    "language": { "code": "ar" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Ahmed" },
          { "type": "text", "text": "Thursday 4 PM" }
        ]
      }
    ]
  }
}'

الحملات

POST/api/campaigns

إنشاء حملة

curl -X POST "https://talyapp.net/api/campaigns" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "April property follow-up",
  "template": "00000000-0000-4000-8000-000000000000",
  "contacts": "all",
  "skip_schedule": true,
  "body": {
    "parameters": [
      { "type": "text", "text": "Ahmed" }
    ]
  }
}'

التجارة

GET/api/commerce/products

جلب المنتجات

curl -X GET "https://talyapp.net/api/commerce/products?page=1&per_page=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

POST/api/commerce/products

إضافة منتج

curl -X POST "https://talyapp.net/api/commerce/products" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Signature consultation",
  "sku": "CONSULT-001",
  "product_type": "service",
  "status": "active",
  "price": 250,
  "currency": "EGP",
  "category_name": "Consultations",
  "image_url": "https://example.com/catalog/consultation.jpg"
}'

PUT/api/commerce/products/{uuid}

تعديل منتج

curl -X PUT "https://talyapp.net/api/commerce/products/00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Signature consultation",
  "status": "active",
  "price": 275
}'

GET/api/commerce/orders

جلب الطلبات

curl -X GET "https://talyapp.net/api/commerce/orders?page=1&per_page=20&status=pending_payment" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

GET/api/commerce/orders/{uuid}

تفاصيل طلب

curl -X GET "https://talyapp.net/api/commerce/orders/00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

PATCH/api/commerce/orders/{uuid}/status

تغيير حالة طلب

curl -X PATCH "https://talyapp.net/api/commerce/orders/00000000-0000-4000-8000-000000000000/status" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "confirmed",
  "note": "Confirmed by operations team."
}'

GET/api/commerce/appointments

جلب الحجوزات

curl -X GET "https://talyapp.net/api/commerce/appointments?page=1&per_page=20&status=pending" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

GET/api/commerce/appointments/{uuid}

تفاصيل حجز

curl -X GET "https://talyapp.net/api/commerce/appointments/00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

PATCH/api/commerce/appointments/{uuid}

تعديل حجز

curl -X PATCH "https://talyapp.net/api/commerce/appointments/00000000-0000-4000-8000-000000000000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "confirmed",
  "notes": "Customer confirmed on WhatsApp."
}'

القوالب

GET/api/templates

جلب القوالب

curl -X GET "https://talyapp.net/api/templates?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

التحقق

GET/api/verify

التحقق من المفتاح

curl -X GET "https://talyapp.net/api/verify" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Error responses

Standard error

{
  "statusCode": 403,
  "code": "message_limit_reached",
  "message": "You have reached your message limit.",
  "request_id": "req_01hxexample"
}

Validation error

{
  "statusCode": 400,
  "code": "validation_error",
  "errors": {
    "phone": ["The phone number is not valid."]
  }
}

API المطور المرجع