Справочник API

Начало работы

Отправить изображения и файлы

Проверьте возможности канала, подготовьте доступный URL медиа и выберите поддерживаемый тип.

Начало работы

  1. 1

    Перед вызовом

    Проверьте возможности канала, подготовьте доступный URL медиа и выберите поддерживаемый тип.

    Поддержка единого отправления сообщений
  2. 2

    Откуда взять параметры

    Для ответа скопируйте data.conversation.id и data.conversation.type из message.received в to.id и to.type. Для нового адресата следуйте правилам идентификаторов канала.

    Отправить текстовое сообщение
  3. 3

    Отправить медиасообщение

    Проверьте возможности канала, подготовьте доступный URL медиа и выберите поддерживаемый тип.

    curl -X POST "https://api.unifyport.ai/v1/messages" \
      -H "X-Api-Key: <YOUR_API_KEY>" \
      -H "Content-Type: application/json" \
      -d '{
      "account_id": "acc_example",
      "to": {
        "id": "user_example",
        "type": "user"
      },
      "message": {
        "type": "video",
        "url": "https://cdn.example.com/video/demo.mp4",
        "caption": "hello video"
      },
      "provider_data": {
        "seconds": 12
      }
    }'
    Отправить медиасообщение
  4. 4

    Как понять результат

    Сохраните message_id и provider_ref для сопоставления событий и диагностики. accepted не подтверждает доставку. Проверяйте её по событиям квитанций только при поддержке каналом; форматы идентификаторов различаются.

    Webhook delivery & signature verification