Перейти до змісту

Повідомлення RCS

RCS (Rich Communication Services) — це нове покоління обміну повідомленнями для пристроїв Android, яке пропонує мультимедійні можливості, інтерактивність і розширені функції, крім традиційних SMS.

Огляд

RCS надає розширені можливості обміну повідомленнями:

  • Мультимедіа (зображення, відео, GIF-файли)
  • Інтерактивні кнопки та каруселі
  • Прочитайте квитанції та індикатори набору тексту
  • Вищі обмеження символів (до 3072 символів)
  • Краще відстеження доставки
  • Фірмова ідентифікація відправника

Наявність

  • Платформа: лише пристрої Android
  • Мережа: потрібна підтримка оператора RCS
  • Резервний режим: автоматично повертається до SMS, якщо RCS недоступний

Основне повідомлення RCS

Приклад RCS

Запит

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

Параметри

Параметр Тип Необхідно Опис
від рядок Так Буквено-цифровий ідентифікатор відправника
до рядок Так Номер телефону отримувача (E.164)
тип рядок Так Установіть значення "rcs"
текст рядок Так Вміст повідомлення (до 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"
        }
      }
    ]
  }
}

Карусель RCS

Відображення кількох елементів у прокручуваній каруселі:

{
  "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"
              }
            }
          ]
        }
      ]
    }
  }
}

Дії кнопок

Відкрити URL

{
  "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"
  }
}

Характеристики носія

Зображення

  • Формати: JPEG, PNG, GIF
  • Максимальний розмір: 2 МБ
  • Рекомендована роздільна здатність: 800x600 або 1200x800
  • Співвідношення сторін: 16:9 або 4:3

Відео

  • Формати: MP4, 3GP
  • Максимальний розмір: 10 МБ
  • Максимальна тривалість: 2 хвилини
  • Рекомендована роздільна здатність: 1280x720

Аудіо

  • Формати: MP3, AAC
  • Максимальний розмір: 5 Мб
  • Максимальна тривалість: 5 хвилин

Повернення до SMS

RCS автоматично повертається до SMS, коли:

  • Одержувач не має RCS
  • RCS вимкнено на пристрої одержувача
  • Мережа не підтримує RCS
{
  "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"
        }
      }
    ]
  }
}

Найкращі практики

Вміст

  • ✅ Використовуйте високоякісні зображення (мінімум 800x600)
  • ✅ Тримайте текст кнопки коротким (2-3 слова)
  • ✅ Забезпечте резервний SMS для насиченого вмісту
  • ✅ Тестуйте на різних пристроях Android
  • ❌ Не перевищуйте 4-5 кнопок на повідомлення
  • ❌ Уникайте великих відеофайлів (>5 МБ)

ЗМІ

  • Використовуйте URL-адреси HTTPS для всіх медіа
  • Оптимізація зображень для мобільних пристроїв
  • Додайте альтернативний текст для доступності
  • Перевірте URL-адреси медіа перед надсиланням

Кнопки

  • Максимум 4 кнопки на одне повідомлення
  • Чіткий текст заклику до дії
  • Перевірте всі дії кнопок
  • Розгляньте резервний варіант для недоступних дій

Брендінг

  • Використовуйте постійний ідентифікатор відправника
  • Додайте логотип бренду, де це необхідно
  • Підтримуйте голос і тон бренду
  • Забезпечте візуальну послідовність

Статус доставки

RCS забезпечує розширене відстеження доставки:

  • Надіслано: повідомлення надіслано оператору
  • Доставлено: повідомлення доставлено на пристрій
  • Прочитати: повідомлення відкрито одержувачем
  • Помилка: не вдалося доставити, активовано резервний варіант

Перевірте статус за допомогою кінцевої точки стану.

Наступні кроки