GMS API Համատեղելիություն

SMSBAT-ն աջակցում է GMS API-ի հետ համատեղելիության շերտ: Սա թույլ է տալիս տեղափոխել ձեր գոյություն ունեցող ինտեգրումները, որոնք նախատեսված են GMS-ի համար անմիջապես SMSBAT՝ առանց փոփոխելու ձեր հաղորդագրությունների երթուղային սխեմաները, օգտակար բեռի կառուցվածքները կամ հետադարձ զանգի ունկնդիրները:

Կապի կարգավորումներ

SMSBAT-ի միջոցով հարցումները ուղղորդելու համար թարմացրեք բազային URL-ը և նույնականացման հավատարմագրերը ձեր ինտեգրման մեջ.

• Հիմնական URL: «https://restapi.smsbat.com»:
• Վերջնական կետ. «POST /api/GMSMessage/send_message»
• Հարցման ձևաչափ. «հավելված/json»:
• ** Նույնականացում. ** HTTP հիմնական նույնականացում (օգտագործում է ձեր SMSBAT API հավատարմագրերը)

Հարցման պարամետրեր

GMS-ի համատեղելիության API-ն ընդունում է JSON օբյեկտ հետևյալ վերին մակարդակի պարամետրերով.

Ալիքի ընտրանքների կարգավորումներ

«channel_options» օբյեկտը պարունակում է ալիքին հատուկ կոնֆիգուրացիաներ:

=== «Viber հաղորդագրություն»

Օգտագործվում է, երբ «viber»-ը նշված է «ալիքների» զանգվածում:

| Պարամետր | Տեսակ | Պահանջվում է | Նկարագրություն |
| :--- | :--- | :--- | :--- |
| «տեքստ» | լարային | **Այո** | Հաղորդագրության հիմնական տեքստը: |
| «ttl» | ամբողջ թիվ | **Այո** | Time-To-Live վայրկյաններով: |
| «img» | լարային | Ոչ | Ցուցադրվող պատկերի հանրային HTTPS URL: |
| «վերնագիր» | լարային | Ոչ | Կոճակի տեքստային պիտակ: |
| «գործողություն» | լարային | Ոչ | Նպատակակետի URL, երբ սեղմվում է կոճակը: |
| «հարցման_ընտրանքներ» | զանգված | Ոչ | Տողերի զանգված (2-ից 5 տարր)՝ որպես հարցման ընտրանքներ ցուցադրելու համար: |
| «կարուսելի_իրեր» | զանգված | Ոչ | Սլայդ օբյեկտների զանգված՝ որպես Viber կարուսել ցուցադրելու համար (տես կառուցվածքը ներդիրում): |

**Viber Request Օրինակ՝**
```json
{
  "phone_number": "380501234567",
  "tag": "MySender",
  "channels": ["viber"],
  "channel_options": {
    "viber": {
      "text": "Hello from SMSBAT!",
      "ttl": 60,
      "img": "https://www.example.com/image.png",
      "caption": "Open",
      "action": "https://www.example.com"
    }
  }
}
```

=== «Viber SMS-ի հետադարձ կապով»

Միացնում է Viber հաղորդագրությունների փոխանակումը ավտոմատ հետադարձ SMS-ով, եթե Viber-ի առաքումը ձախողվում է TTL-ի շրջանակներում:

**Հետադարձ խնդրանքի օրինակ.**
```json
{
  "phone_number": "380501234567",
  "tag": "MySender",
  "channels": ["viber", "sms"],
  "channel_options": {
    "viber": {
      "text": "Your order is ready!",
      "ttl": 60,
      "caption": "Details",
      "action": "https://www.example.com/order"
    },
    "sms": {
      "text": "Your order is ready: https://www.example.com/order",
      "alpha_name": "MySender",
      "ttl": 60,
      "ctr": false
    }
  }
}
```

=== «SMS հաղորդագրություն»

Օգտագործվում է, երբ «sms»-ը նշված է «ալիքների» զանգվածում:

| Պարամետր | Տեսակ | Պահանջվում է | Նկարագրություն |
| :--- | :--- | :--- | :--- |
| «տեքստ» | լարային | **Այո** | Հաղորդագրության հիմնական տեքստը: |
| «ալֆա_անուն» | լարային | **Այո** | Ուղարկողի ալֆա անունը. |
| «ttl» | ամբողջ թիվ | **Այո** | Time-To-Live վայրկյաններով: |
| «ctr» | բուլյան | Ոչ | Միացնել CTR սեղմումների հետագծումը տեքստի հղումների վրա («true»/«false»): |

**SMS հարցման օրինակ.**
```json
{
  "phone_number": "380501234567",
  "tag": "MySender",
  "channels": ["sms"],
  "channel_options": {
    "sms": {
      "text": "Your verification code is 1234",
      "alpha_name": "MySender",
      "ttl": 60,
      "ctr": false
    }
  }
}
```

=== «Viber Survey»

Օգտագործվում է Viber-ի հարցումներ և հարցումներ ստեղծելու համար:

Viber-ի հարցումների կազմաձևումը պետք է ունենա **2-ից 5 տարբերակ** «survey_options»-ի ներսում:

{
  "phone_number": "380501234567",
  "tag": "MySender",
  "channels": ["viber"],
  "channel_options": {
    "viber": {
      "text": "Please rate our service:",
      "ttl": 60,
      "survey_options": [
        "Excellent",
        "Good",
        "Bad"
      ]
    }
  }
}

=== «Viber կարուսել»

Օգտագործվում է swipeable պատկերի սլայդ քարտեր ուղարկելու համար: Յուրաքանչյուր սլայդ աջակցում է պատկերին, վերնագրին և կոճակներին:

**Կարուսելի խնդրանքի օրինակ.**
```json
{
  "phone_number": "380501234567",
  "tag": "MySender",
  "channels": ["viber"],
  "channel_options": {
    "viber": {
      "text": "Choose an offer",
      "ttl": 60,
      "carousel_items": [
        {
          "title": "Offer 1",
          "image_url": "https://www.example.com/offer-1.png",
          "primary_label": "Open",
          "primary_url": "https://www.example.com/offer-1",
          "secondary_label": "More",
          "secondary_url": "https://www.example.com/offers"
        },
        {
          "title": "Offer 2",
          "image_url": "https://www.example.com/offer-2.png",
          "primary_label": "Open",
          "primary_url": "https://www.example.com/offer-2"
        }
      ]
    }
  }
}
```

=== «Հրում հաղորդագրություն»

Օգտագործվում է, երբ «push»-ը նշված է «channels» զանգվածում:

| Պարամետր | Տեսակ | Պահանջվում է | Նկարագրություն |
| :--- | :--- | :--- | :--- |
| «վերնագիր» | լարային | **Այո** | Push ծանուցման վերնագրի տեքստը: |
| «տեքստ» | լարային | **Այո** | Հաղորդագրության հիմնական տեքստը: |
| «ttl» | ամբողջ թիվ | **Այո** | Time-To-Live վայրկյաններով: |
| «img» | լարային | Ոչ | Ցուցադրվող պատկերի հանրային HTTPS URL: |
| «վերնագիր» | լարային | Ոչ | Կոճակի տեքստային պիտակ: |
| «գործողություն» | լարային | Ոչ | Նպատակակետի URL, երբ սեղմվում է կոճակը: |
| «ctr» | բուլյան | Ոչ | Միացնել սեղմումների հետագծումը: |

**Հրում պահանջի օրինակ.**
```json
{
  "phone_number": "380501234567",
  "tag": "MySender",
  "channels": ["push"],
  "channel_options": {
    "push": {
      "title": "Order update",
      "text": "Your order is ready for pickup!",
      "ttl": 60,
      "img": "https://www.example.com/push.png",
      "caption": "Open",
      "action": "https://www.example.com/order",
      "ctr": false
    }
  }
}
```

Պատասխանի ձևաչափ

Վերջնական կետը պատասխաններ է տալիս JSON ձևաչափով՝ «HTTP 200 OK» կարգավիճակի կոդով:

Հաջող արձագանք

{
  "MessageId": "6f0d5e28-7f3a-4df3-91a2-3d58d9e09b9a",
  "ErrorCode": null,
  "ErrorText": null
}

Սխալների պատասխաններ

Եթե վավերացումը կամ մշակումը ձախողվի, սխալի պատասխանը կվերադարձվի ոչ զրոյական «ErrorCode»-ով և մանրամասն «ErrorText»-ով:

=== «Չաջակցվող ալիք/տարբերակ» json { "MessageId": "00000000-0000-0000-0000-000000000000", "ErrorCode": 10221, "ErrorText": "This type of Message is not supported by the system" }

=== «Հարցման անվավեր տարբերակների քանակ» json { "MessageId": "00000000-0000-0000-0000-000000000000", "ErrorCode": 10221, "ErrorText": "There can be from 2 to 5 survey options." }

=== «Չգրանցված ալֆա անուն» json { "MessageId": "00000000-0000-0000-0000-000000000000", "ErrorCode": 400, "ErrorText": "Cannot send to international number: alpha name 'ALPHA' is not registered." }

=== «Ներքին մշակման սխալ» json { "MessageId": "00000000-0000-0000-0000-000000000000", "ErrorCode": 500, "ErrorText": "Internal server error." }

Հետկանչի առաքման ձևաչափ

Եթե հարցումում նշված է «callback_url», SMSBAT-ն ուղարկում է առաքման կարգավիճակի թարմացումները որպես JSON POST ծանրաբեռնվածություն ձեր վերջնակետ:

Հետ կանչի խնդրանքի օրինակ

POST /your-callback-endpoint HTTP/1.1
Host: yoursystem.com
Content-Type: application/json

{
  "number": "380501234567",
  "time": 1719237600000,
  "status": 2,
  "substatus": 23,
  "hyber_status": 23033,
  "message_id": "6f0d5e28-7f3a-4df3-91a2-3d58d9e09b9a",
  "extra_id": "ORDER-12345",
  "sent_via": "viber",
  "matching_template_id": 0
}

Հետ կանչի դաշտերի նկարագրություն

Կարգավիճակի քարտեզագրում

1. Պարզեցված կարգավիճակ («կարգավիճակ»)

2. Մանրամասն կարգավիճակ («ենթակարգ»)

3. Ալիքի տեսակը («ուղարկված_միջոցով»)

4. Մանրամասն SMSBAT կարգավիճակ («hyber_status»)