Сообщения

curl -X POST "https://api.aisar.app/v1/messages/send" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": 3,
    "recipient": "+77001234567",
    "message_content": "Здравствуйте! Ваш заказ №1045 передан в доставку."
  }'

{
  "success": true
}

curl -X POST "https://api.aisar.app/v1/messages/send" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": 3,
    "recipient": "+77001234567",
    "attachments": [
      { "sticker_id": 87 }
    ]
  }'

{
  "success": true
}

curl -X POST "https://api.aisar.app/v1/messages" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": 15,
    "thread_id": 33,
    "direction": "outbound",
    "message_type": "text",
    "message_content": "Да, доставим сегодня до 18:00.",
    "quoted_message_id": 998
  }'

{
  "data": {
    "message": "Message created.",
    "item": {
      "id": 1005,
      "conversation_id": 15,
      "thread_id": 33,
      "direction": "outbound",
      "message_type": "text",
      "message_content": { "text": "Да, доставим сегодня до 18:00." },
      "quoted_message_id": 998,
      "is_deleted": false,
      "created_at": "2026-02-09T18:10:00Z"
    }
  }
}

curl -X GET "https://api.aisar.app/v1/messages?conversation_id=15&perPage=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "data": {
    "items": [
      {
        "id": 1001,
        "conversation_id": 15,
        "thread_id": 33,
        "channel_id": 3,
        "direction": "outbound",
        "message_type": "text",
        "message_content": { "text": "Здравствуйте! Ваш заказ №1045 передан в доставку." },
        "display_content": { "text": "Здравствуйте! Ваш заказ №1045 передан в доставку." },
        "is_deleted": false,
        "timestamp": "2026-02-09T18:00:00Z",
        "created_at": "2026-02-09T18:00:00Z",
        "updated_at": "2026-02-09T18:00:00Z",
        "can_revoke_until": "2026-02-09T18:15:00Z",
        "can_edit_until": "2026-02-09T18:15:00Z"
      }
    ],
    "pagination": { "page": 1, "perPage": 20, "total": 1, "lastPage": 1 }
  }
}

curl -X GET "https://api.aisar.app/v1/messages?conversation_id=15&before_message_id=998&perPage=20&sortDir=desc" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "data": {
    "items": [
      { "id": 997, "direction": "inbound", "message_type": "text", "message_content": { "text": "Здравствуйте, подскажите статус заказа?" } },
      { "id": 996, "direction": "outbound", "message_type": "text", "message_content": { "text": "Добрый день! Секунду, проверяю." } }
    ],
    "pagination": { "page": 1, "perPage": 20, "total": null, "lastPage": null }
  }
}

curl -X GET "https://api.aisar.app/v1/messages/search?conversation_id=15&q=заказ" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "data": {
    "items": [
      {
        "message_id": 1001,
        "conversation_id": 15,
        "thread_id": 33,
        "created_at": "2026-02-09T18:00:00Z",
        "snippet": "...Ваш заказ №1045 передан в доставку...",
        "query": "заказ",
        "contact_name": "Aigerim K.",
        "channel_id": 3,
        "channel_type": "whatsapp"
      }
    ],
    "pagination": { "page": 1, "perPage": 20, "total": 1, "lastPage": 1 },
    "total_matches": 1
  }
}

curl -X GET "https://api.aisar.app/v1/messages/search?q=заказ" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "data": {
    "items": [
      {
        "message_id": 1001,
        "conversation_id": 15,
        "thread_id": 33,
        "created_at": "2026-02-09T18:00:00Z",
        "snippet": "...Ваш заказ №1045 передан в доставку...",
        "query": "заказ",
        "contact_name": "Aigerim K.",
        "channel_id": 3,
        "channel_type": "whatsapp"
      },
      {
        "message_id": 2044,
        "conversation_id": 27,
        "thread_id": 61,
        "created_at": "2026-02-08T11:20:00Z",
        "snippet": "...уточните, пожалуйста, номер заказа...",
        "query": "заказ",
        "contact_name": "Jane Roe",
        "channel_id": 9,
        "channel_type": "telegram"
      }
    ],
    "pagination": { "page": 1, "perPage": 20, "total": 2, "lastPage": 1 },
    "total_matches": 2
  }
}

curl -X GET "https://api.aisar.app/v1/messages/1001/around?before=20&after=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "data": {
    "items": [
      { "id": 998, "direction": "inbound", "message_type": "text", "message_content": { "text": "Добрый день! Где мой заказ №1045?" } },
      { "id": 1001, "direction": "outbound", "message_type": "text", "message_content": { "text": "Здравствуйте! Ваш заказ №1045 передан в доставку." } }
    ],
    "anchor_message_id": 1001,
    "has_older": true,
    "has_newer": false
  }
}

curl -X POST "https://api.aisar.app/v1/uploads" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@invoice-1045.pdf"

{
  "media_id": "med_9f3a2b7c",
  "type": "document",
  "storage_disk": "local",
  "storage_path": "10/attachments/8b1e2c4f-0a3d-4e57-9c21-1f2a3b4c5d6e.pdf",
  "filename": "invoice-1045.pdf",
  "mime_type": "application/pdf",
  "size": 245113,
  "width": null,
  "height": null,
  "duration": null,
  "expires_at": "2026-03-11T18:00:00Z"
}

curl -X POST "https://api.aisar.app/v1/messages/1001/attachments" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "document",
    "media_id": "med_9f3a2b7c",
    "filename": "invoice-1045.pdf",
    "mime_type": "application/pdf",
    "size": 245113
  }'

curl -X POST "https://api.aisar.app/v1/messages/1001/attachments/55/fetch" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "data": {
    "item": {
      "id": 1001,
      "direction": "inbound",
      "message_type": "image",
      "attachments": [
        {
          "id": 55,
          "type": "image",
          "url": "https://api.aisar.app/v1/messages/1001/attachments/55/media?signature=PLACEHOLDER",
          "thumbnail_url": "https://api.aisar.app/v1/messages/1001/attachments/55/media?w=640&signature=PLACEHOLDER",
          "filename": "photo.jpg",
          "mime_type": "image/jpeg"
        }
      ]
    }
  }
}

curl -X PATCH "https://api.aisar.app/v1/messages/1001" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "message_content": "Здравствуйте! Ваш заказ №1045 уже в пути." }'

curl -X POST "https://api.aisar.app/v1/messages/1001/reactions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "reaction": "👍" }'

{
  "data": {
    "message": "Message reaction created.",
    "item": {
      "id": 77,
      "message_id": 1001,
      "author_user_id": 8,
      "author_name": "Азиз Каримов",
      "reaction": "👍",
      "created_at": "2026-02-09T18:12:00Z"
    }
  }
}

curl -X DELETE "https://api.aisar.app/v1/messages/1001/reactions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "data": {
    "message": "Message reaction removed."
  }
}

curl -X DELETE "https://api.aisar.app/v1/messages/1001" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "revoke", "reason": "Отправлено по ошибке" }'

{
  "data": {
    "message": "Message deleted.",
    "item": {
      "id": 1001,
      "direction": "outbound",
      "is_deleted": true,
      "can_revoke_until": null,
      "can_edit_until": null
    }
  }
}

curl -X DELETE "https://api.aisar.app/v1/messages/1001" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "revoke" }'

{
  "message": "This channel does not support revoking a sent message for the recipient. Provider-side revoke (\"delete for everyone\") is not available on API-based channels such as WhatsApp Cloud (whatsapp_business). Omit \"mode\" for a local delete."
}

curl -X POST "https://api.aisar.app/v1/messages/1001/forward" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "target_thread_id": 45 }'

{
  "data": {
    "message": "Message forwarded.",
    "item": {
      "id": 1002,
      "thread_id": 45,
      "direction": "outbound",
      "message_type": "text",
      "message_content": { "text": "Здравствуйте! Ваш заказ №1045 передан в доставку." },
      "is_forwarded": true,
      "created_at": "2026-02-09T18:05:00Z"
    }
  }
}

curl -X POST "https://api.aisar.app/v1/messages/1001/forward" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target_contact_account_id": 42,
    "target_channel_id": 5
  }'

{
  "data": {
    "message": "Message forwarded.",
    "item": {
      "id": 1003,
      "thread_id": 51,
      "channel_id": 5,
      "direction": "outbound",
      "message_type": "text",
      "message_content": { "text": "Здравствуйте! Ваш заказ №1045 передан в доставку." },
      "is_forwarded": true,
      "created_at": "2026-02-09T18:06:00Z"
    }
  }
}

curl -X POST "https://api.aisar.app/v1/messages/1001/forward" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "target_contact_account_id": 42 }'

{
  "message": "Несколько подключённых каналов подходят этому контакту — укажите target_channel_id.",
  "error_code": "channel_required"
}

curl -X POST "https://api.aisar.app/v1/uploads/voice" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@voice-note.webm"

{
  "media_id": "med_01JBQZ8VN2K3M4N5P6Q7R8S9T0",
  "type": "audio",
  "storage_disk": "local",
  "storage_path": "10/attachments/7c1e2a4f-0b3d-4e57-9c21-2f3a4b5c6d7e.ogg",
  "filename": "voice.ogg",
  "mime_type": "audio/ogg",
  "size": 18342,
  "duration": 7,
  "expires_at": "2026-03-11T18:00:00Z"
}

curl -X POST "https://api.aisar.app/v1/messages/1001/like" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "message": "Comment liked."
}

curl -X POST "https://api.aisar.app/v1/messages/send" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f9c2b7e-8b7a-4e2d-9c3f-7a1b2c3d4e5f" \
  -d '{
    "channel_id": 3,
    "recipient": "+77001234567",
    "message_content": "Здравствуйте! Ваш заказ №1045 передан в доставку."
  }'

{
  "success": true
}

curl -X GET "https://api.aisar.app/v1/messages/1006" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "data": {
    "item": {
      "id": 1006,
      "conversation_id": 22,
      "thread_id": 48,
      "channel_id": 9,
      "direction": "inbound",
      "message_type": "text",
      "message_content": { "text": "Здравствуйте, интересует товар из рекламы" },
      "referral": {
        "source_type": "ad",
        "source_id": "120210000000000",
        "headline": "Летняя коллекция — скидка 20%",
        "image_url": "https://scontent.xx.fbcdn.net/example.jpg",
        "post_id": "17900000000000000",
        "ref": "summer_sale"
      },
      "created_at": "2026-02-09T18:00:00Z"
    }
  }
}

curl -X POST "https://api.aisar.app/v1/messages/send" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": 3,
    "recipient": "+77001234567",
    "message_content": "Здравствуйте!"
  }'

{
  "message": "This contact is blocked; the message was not sent.",
  "error_code": "contact_blocked"
}