Help Center РЦС поруке

РЦС поруке

РЦС (Рицх Цоммуницатион Сервицес) је следећа генерација порука за Андроид уређаје, која нуди богате медије, интерактивност и напредне функције изван традиционалних СМС-ова.

Преглед

РЦС пружа побољшане могућности за размену порука:

– Богати медији (слике, видео снимци, ГИФ-ови)

  • Интерактивна дугмад и вртешке
  • Прочитајте признанице и индикаторе куцања
  • Већа ограничења броја знакова (до 3072 знака)
  • Боље праћење испоруке
  • Брендирана идентификација пошиљаоца

Доступност

  • Платформа: само Андроид уређаји
  • Мрежа: Захтева РЦС подршку оператера
  • Замена: Аутоматски се враћа на СМС ако РЦС није доступан

Основна РЦС порука

РЦС пример

Захтев

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your RCS message text with rich formatting"
}

Параметерс

ПараметарТипОбавезноОпис
одстрингДаАлфанумерички ИД пошиљаоца
тострингДаБрој телефона примаоца (Е.164)
типстрингДаПоставите на "рцс"
текстстрингДаСадржај поруке (до 3072 карактера)
мессагеДатаобјекатНеБогати медији и дугмад

Типови порука

Само текст

Једноставна текстуална порука са продуженим ограничењем знакова:

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Welcome to our service! RCS allows us to send much longer messages with rich formatting and interactive elements."
}

Текст + слика

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Check out our new product!",
  "messageData": {
    "media": {
      "url": "https://example.com/product.jpg",
      "type": "image/jpeg",
      "height": 600,
      "width": 800
    }
  }
}

Текст + Слика + Дугме

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Summer Sale - Up to 50% off!",
  "messageData": {
    "media": {
      "url": "https://example.com/sale-banner.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Shop Now",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/sale"
        }
      }
    ]
  }
}

Текст + видео

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Watch our product demo",
  "messageData": {
    "media": {
      "url": "https://example.com/demo.mp4",
      "type": "video/mp4",
      "thumbnail": "https://example.com/thumbnail.jpg"
    }
  }
}

Текст + више дугмади

{
  "from": "YourService",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your order #12345 is ready for pickup",
  "messageData": {
    "buttons": [
      {
        "text": "Track Order",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/track/12345"
        }
      },
      {
        "text": "Contact Support",
        "action": {
          "type": "dial",
          "phoneNumber": "+380XXXXXXXXX"
        }
      },
      {
        "text": "Cancel Order",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/cancel/12345"
        }
      }
    ]
  }
}

РЦС вртешка

Прикажи више ставки у вртешци која се може померати:

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Featured Products",
  "messageData": {
    "carousel": {
      "cards": [
        {
          "title": "Product A",
          "description": "Premium quality product",
          "media": {
            "url": "https://example.com/product-a.jpg",
            "type": "image/jpeg"
          },
          "buttons": [
            {
              "text": "Buy Now",
              "action": {
                "type": "openUrl",
                "url": "https://example.com/product-a"
              }
            },
            {
              "text": "Details",
              "action": {
                "type": "openUrl",
                "url": "https://example.com/product-a/details"
              }
            }
          ]
        },
        {
          "title": "Product B",
          "description": "Best seller",
          "media": {
            "url": "https://example.com/product-b.jpg",
            "type": "image/jpeg"
          },
          "buttons": [
            {
              "text": "Buy Now",
              "action": {
                "type": "openUrl",
                "url": "https://example.com/product-b"
              }
            }
          ]
        }
      ]
    }
  }
}

Акције дугмета

Отвори УРЛ

{
  "text": "Visit Website",
  "action": {
    "type": "openUrl",
    "url": "https://example.com"
  }
}

Бирајте број телефона

{
  "text": "Call Us",
  "action": {
    "type": "dial",
    "phoneNumber": "+380XXXXXXXXX"
  }
}

Пошаљи локацију

{
  "text": "Share Location",
  "action": {
    "type": "shareLocation"
  }
}

Календарски догађај

{
  "text": "Add to Calendar",
  "action": {
    "type": "createCalendarEvent",
    "title": "Appointment",
    "startTime": "2025-01-25T14:00:00Z",
    "endTime": "2025-01-25T15:00:00Z"
  }
}

Спецификације медија

Слике

  • Формати: ЈПЕГ, ПНГ, ГИФ
  • Максимална величина: 2МБ
  • Препоручена резолуција: 800к600 или 1200к800
  • Однос слике: 16
    или 4

Видеос

  • Формати: МП4, 3ГП
  • Максимална величина: 10МБ
  • Максимално трајање: 2 минута
  • Препоручена резолуција: 1280к720

Аудио

  • Формати: МП3, ААЦ
  • Максимална величина: 5МБ
  • Максимално трајање: 5 минута

Повратак на СМС

РЦС се аутоматски враћа на СМС када:

  • Прималац нема РЦС
  • РЦС је онемогућен на уређају примаоца
  • Мрежа не подржава РЦС
{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Check out our new product!",
  "messageData": {
    "media": {
      "url": "https://example.com/product.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Shop Now",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/shop"
        }
      }
    ]
  },
  "fallback": {
    "type": "sms",
    "text": "Check out our new product! Visit: https://example.com/shop"
  }
}

Случајеви употребе

Е-трговина

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your order has been shipped!",
  "messageData": {
    "media": {
      "url": "https://example.com/package.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Track Package",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/track/ABC123"
        }
      },
      {
        "text": "Contact Support",
        "action": {
          "type": "dial",
          "phoneNumber": "+380XXXXXXXXX"
        }
      }
    ]
  }
}

Банкарство

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Low balance alert: Your account balance is $50",
  "messageData": {
    "buttons": [
      {
        "text": "View Balance",
        "action": {
          "type": "openUrl",
          "url": "https://bank.example.com/balance"
        }
      },
      {
        "text": "Transfer Money",
        "action": {
          "type": "openUrl",
          "url": "https://bank.example.com/transfer"
        }
      }
    ]
  }
}

Травел

{
  "from": "YourAirline",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your flight is departing in 3 hours",
  "messageData": {
    "media": {
      "url": "https://example.com/boarding-pass.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Check-in",
        "action": {
          "type": "openUrl",
          "url": "https://airline.example.com/checkin"
        }
      },
      {
        "text": "Add to Calendar",
        "action": {
          "type": "createCalendarEvent",
          "title": "Flight Departure",
          "startTime": "2025-01-25T10:00:00Z"
        }
      }
    ]
  }
}

Најбоље праксе

Садржај

  • ✅ Користите слике високог квалитета (минимално 800к600)
  • ✅ Нека текст дугмета буде кратак (2-3 речи)
  • ✅ Обезбедите резервни СМС за богат садржај
  • ✅ Тестирајте на различитим Андроид уређајима
  • ❌ Немојте прекорачити 4-5 дугмади по поруци
  • ❌ Избегавајте велике видео датотеке (>5МБ)

Медији

– Користите ХТТПС УРЛ-ове за све медије

  • Оптимизујте слике за мобилне уређаје
  • Укључите алтернативни текст за приступачност
  • Тестирајте УРЛ-ове медија пре слања

Дугмад

  • Највише 4 дугмета по поруци – Обришите текст позива на акцију
  • Тестирајте све радње дугмади
  • Размотрите резервни део за недоступне радње

Брендирање

  • Користите конзистентан ИД пошиљаоца
  • Укључите лого бренда где је то прикладно
  • Одржавајте глас и тон бренда
  • Обезбедите визуелну доследност

Статус испоруке

РЦС обезбеђује побољшано праћење испоруке:

  • Послато: Порука је послата оператеру
  • Достављено: Порука је испоручена на уређај
  • Прочитано: Поруку је отворио прималац
  • Неуспешно: Испорука није успела, резервни је покренут

Проверите статус помоћу статус ендпоинт.

Следећи кораци