Support Tickets

Get list of your support tickets.

Query Parameters

Parameter	Type	Description
page	number	Page number
pageSize	number	Items per page (max 100)
status	string	Filter: open, in_progress, closed

Example

curl -G "https://www.HomaCRM.com/api/v1/external/support/tickets" \
  -H "Authorization: a1B2c3D4e5F6g7H8-i9J0k1L2m3N4o5P6-q7R8s9T0u1V2w3X4" \
  -H "Accept: application/json" \
  --data-urlencode "page=1" \
  --data-urlencode "pageSize=15" \
  --data-urlencode "status=open"

Create a new support ticket.

Request Body

Field	Type	Required	Description
title	string	Yes	Ticket title (max 200)
description	string	Yes	Detailed description
priority	number	No	Integer 1–4 only (1=normal, 2=important, 3=urgent, 4=critical); other values are rejected

Example

curl -X POST "https://www.HomaCRM.com/api/v1/external/support/tickets" \
  -H "Authorization: a1B2c3D4e5F6g7H8-i9J0k1L2m3N4o5P6-q7R8s9T0u1V2w3X4" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "خطا در وب‌هوک ارسال پیامک",
    "description": "هر شب ساعت ۲۳:۱۰ درخواست POST به آدرس https://api.customer.example/hooks/sms با کد ۵۲۴ برمی‌گردد. شناسه درخواست نمونه: req_7f3a9c. لطفاً لاگ سمت سرور را بررسی کنید.",
    "priority": 3
  }'

Get ticket details including comments.

Example

curl -X GET "https://www.HomaCRM.com/api/v1/external/support/tickets/12840" \
  -H "Authorization: a1B2c3D4e5F6g7H8-i9J0k1L2m3N4o5P6-q7R8s9T0u1V2w3X4" \
  -H "Accept: application/json"

Add a reply to an existing ticket.

Request Body

Field	Type	Required	Description
content	string	Yes	Reply content (max 5000)

Example

curl -X POST "https://www.HomaCRM.com/api/v1/external/support/tickets/12840/reply" \
  -H "Authorization: a1B2c3D4e5F6g7H8-i9J0k1L2m3N4o5P6-q7R8s9T0u1V2w3X4" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "با سلام، فایروال سرور ما فقط IP های 185.143.x.x را مجاز کرده بود؛ رنج جدید شما را اضافه کردیم. لطفاً دوباره تست کنید و در صورت تکرار خطا، زمان دقیق (با timezone) را ارسال کنید."
  }'

Record an action on a ticket: request a follow-up (optionally urgent — raises the ticket priority) or request a phone callback. Closed tickets do not accept actions.

Request Body — followup

Field	Type	Required	Description
action	string	Yes	"followup"
note	string	No	Optional note (max 2000)
urgent	boolean	No	When true, the ticket priority is raised

Request Body — request_call

Field	Type	Required	Description
action	string	Yes	"request_call"
phone	string	Yes	Iranian mobile in 09xxxxxxxxx format
preferredTime	string	No	Preferred time window (free text)
note	string	No	Optional note (max 2000)

Example

curl -X POST "https://www.HomaCRM.com/api/v1/external/support/tickets/12840/actions" \
  -H "Authorization: a1B2c3D4e5F6g7H8-i9J0k1L2m3N4o5P6-q7R8s9T0u1V2w3X4" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "followup",
    "note": "این مشکل جلوی راه‌اندازی ما را گرفته، لطفاً در اولویت بررسی شود.",
    "urgent": true
  }'