Gemlead
Docs
Войти
Получить API-ключ

Справочник API

Диалоги

Диалогом называется ваша переписка в DM с одним лидом в X, его ID совпадает с ID лида. Читайте все сообщения переписки, получайте их списком сразу по многим диалогам, отвечайте с вашего аккаунта X и поддерживайте порядок на доске диалогов. Новые ответы также приходят вебхуком reply.received.

Эндпоинты

Объект диалога

Ваша переписка в DM с одним лидом в X. Её ID совпадает с ID лида.

Атрибуты

  • idstring
    Уникальный идентификатор диалога, совпадает с lead_id.
  • objectstring
    Всегда conversation.
  • lead_idstring
    Лид, с которым вы общаетесь.
  • profileobject
    Профиль лида в X, как в объекте лида.
  • unreadboolean
    True, если последнее сообщение лида ещё не прочитано.
  • last_message_atstring
    Время последнего сообщения, ISO 8601.
  • messages_countinteger
    Сообщения в переписке.
  • last_messageobject или null
    Последнее сообщение.
  • personaobject или null
    Персона лида.
  • columnobject или null
    Колонка вашей доски диалогов, в которой находится диалог, например «Заинтересованы». См. Колонки воронки.
  • historystring
    complete, если в messages вся переписка. recent, пока Gemlead хранит только последние сообщения длинной переписки, до того как один раз прочитает остальное из X. Только вместе с messages.
    completerecent
  • messagesмассив objects
    Все сообщения переписки, сначала старые. При получении одного диалога или в списке с include_messages.
Объект диалога
{
  "id": "msgOtJ8dvT",
  "object": "conversation",
  "lead_id": "msgOtJ8dvT",
  "profile": {
    "x_user_id": "1460283925",
    "username": "jane_builds",
    "name": "Jane Doe",
    "bio": "Runs a paid trading community. Daily setups, no hype.",
    "followers_count": 12400,
    "following_count": 380,
    "location": "Austin, TX",
    "website": "https://janedoe.com",
    "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
    "verified": true,
    "url": "https://x.com/jane_builds"
  },
  "unread": true,
  "last_message_at": "2026-11-06T08:12:44.000Z",
  "messages_count": 4,
  "last_message": {
    "id": "1985321409876543210",
    "object": "message",
    "direction": "inbound",
    "text": "Yes, I want to charge for my Discord. How does it work?",
    "created_at": "2026-11-06T08:12:44.000Z",
    "media": [],
    "reactions": [],
    "encrypted": false,
    "reply_to_message_id": null
  },
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters"
  },
  "column": {
    "id": "q7m2xk4p",
    "name": "Interested"
  }
}

Список диалогов

GET/v1/conversationsПраво readMCPlist_conversations

Возвращает ваши диалоги, сначала с самым свежим сообщением.

Параметры запроса

  • unreadboolean
    true только для непрочитанных диалогов.
  • personastring
    Только диалоги с лидами персоны с этим ID.
  • include_messagesboolean
    true, чтобы получить каждый диалог со всеми сообщениями, сначала старые, и history. Страницы тяжелее, поэтому держите limit не больше 25.
  • limitinteger
    Сколько объектов вернуть, от 1 до 100. По умолчанию 25.
  • cursorstring
    next_cursor предыдущей страницы, чтобы получить следующую. См. раздел Пагинация.

Возвращает

Список объектов диалога, с messages только если include_messages равен true.

Ошибки

  • 400parameter_invalid
    API не принимает значение параметра. Название параметра указано в param.
GET/v1/conversations
curl -G https://gemlead.ai/api/v1/conversations \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -d unread=true
Ответ200
{
  "object": "list",
  "data": [
    {
      "id": "msgOtJ8dvT",
      "object": "conversation",
      "lead_id": "msgOtJ8dvT",
      "profile": {
        "x_user_id": "1460283925",
        "username": "jane_builds",
        "name": "Jane Doe",
        "bio": "Runs a paid trading community. Daily setups, no hype.",
        "followers_count": 12400,
        "following_count": 380,
        "location": "Austin, TX",
        "website": "https://janedoe.com",
        "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
        "verified": true,
        "url": "https://x.com/jane_builds"
      },
      "unread": true,
      "last_message_at": "2026-11-06T08:12:44.000Z",
      "messages_count": 4,
      "last_message": {
        "id": "1985321409876543210",
        "object": "message",
        "direction": "inbound",
        "text": "Yes, I want to charge for my Discord. How does it work?",
        "created_at": "2026-11-06T08:12:44.000Z",
        "media": [],
        "reactions": [],
        "encrypted": false,
        "reply_to_message_id": null
      },
      "persona": {
        "id": "lvWBPnytpS",
        "name": "Tipsters"
      },
      "column": {
        "id": "q7m2xk4p",
        "name": "Interested"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzIjoiMjAyNi0xMS0wNVQxNDowMzo0MC4xMTdaIn0"
}

Получение диалога

GET/v1/conversations/:idПраво readMCPget_conversation

Возвращает один диалог со всеми его сообщениями, сначала старые.

Параметры пути

  • idstringОбязательно
    ID диалога.

Возвращает

Объект диалога с messages и history.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
GET/v1/conversations/:id
curl https://gemlead.ai/api/v1/conversations/msgOtJ8dvT \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
Ответ200
{
  "id": "msgOtJ8dvT",
  "object": "conversation",
  "lead_id": "msgOtJ8dvT",
  "profile": {
    "x_user_id": "1460283925",
    "username": "jane_builds",
    "name": "Jane Doe",
    "bio": "Runs a paid trading community. Daily setups, no hype.",
    "followers_count": 12400,
    "following_count": 380,
    "location": "Austin, TX",
    "website": "https://janedoe.com",
    "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
    "verified": true,
    "url": "https://x.com/jane_builds"
  },
  "unread": true,
  "last_message_at": "2026-11-06T08:12:44.000Z",
  "messages_count": 4,
  "last_message": {
    "id": "1985321409876543210",
    "object": "message",
    "direction": "inbound",
    "text": "Yes, I want to charge for my Discord. How does it work?",
    "created_at": "2026-11-06T08:12:44.000Z",
    "media": [],
    "reactions": [],
    "encrypted": false,
    "reply_to_message_id": null
  },
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters"
  },
  "column": {
    "id": "q7m2xk4p",
    "name": "Interested"
  },
  "history": "complete",
  "messages": [
    {
      "id": "1985321409876543210",
      "object": "message",
      "direction": "inbound",
      "text": "Yes, I want to charge for my Discord. How does it work?",
      "created_at": "2026-11-06T08:12:44.000Z",
      "media": [],
      "reactions": [],
      "encrypted": false,
      "reply_to_message_id": null
    },
    {
      "id": "1985329981234567890",
      "object": "message",
      "direction": "outbound",
      "text": "Happy to show you. Do you sell picks monthly or per event?",
      "created_at": "2026-11-06T08:20:03.000Z",
      "media": [],
      "reactions": [
        {
          "emoji": "👍",
          "direction": "inbound",
          "created_at": "2026-11-06T08:24:51.000Z"
        }
      ],
      "encrypted": false,
      "reply_to_message_id": "1985321409876543210"
    }
  ]
}

Отметка о прочтении

POST/v1/conversations/:conversation_id/mark_readПраво writeMCPupdate_conversation

Отмечает диалог прочитанным в Gemlead, а в X отправляет отметку о прочтении.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Возвращает

Объект диалога.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
POST/v1/conversations/:conversation_id/mark_read
curl -X POST \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/mark_read \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
Ответ200
{
  "id": "msgOtJ8dvT",
  "object": "conversation",
  "lead_id": "msgOtJ8dvT",
  "profile": {
    "x_user_id": "1460283925",
    "username": "jane_builds",
    "name": "Jane Doe",
    "bio": "Runs a paid trading community. Daily setups, no hype.",
    "followers_count": 12400,
    "following_count": 380,
    "location": "Austin, TX",
    "website": "https://janedoe.com",
    "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
    "verified": true,
    "url": "https://x.com/jane_builds"
  },
  "unread": false,
  "last_message_at": "2026-11-06T08:12:44.000Z",
  "messages_count": 4,
  "last_message": {
    "id": "1985321409876543210",
    "object": "message",
    "direction": "inbound",
    "text": "Yes, I want to charge for my Discord. How does it work?",
    "created_at": "2026-11-06T08:12:44.000Z",
    "media": [],
    "reactions": [],
    "encrypted": false,
    "reply_to_message_id": null
  },
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters"
  },
  "column": {
    "id": "q7m2xk4p",
    "name": "Interested"
  }
}

Снятие отметки о прочтении

POST/v1/conversations/:conversation_id/mark_unreadПраво writeMCPupdate_conversation

Отмечает диалог непрочитанным в Gemlead.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Возвращает

Объект диалога.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
POST/v1/conversations/:conversation_id/mark_unread
curl -X POST \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/mark_unread \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
Ответ200
{
  "id": "msgOtJ8dvT",
  "object": "conversation",
  "lead_id": "msgOtJ8dvT",
  "profile": {
    "x_user_id": "1460283925",
    "username": "jane_builds",
    "name": "Jane Doe",
    "bio": "Runs a paid trading community. Daily setups, no hype.",
    "followers_count": 12400,
    "following_count": 380,
    "location": "Austin, TX",
    "website": "https://janedoe.com",
    "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
    "verified": true,
    "url": "https://x.com/jane_builds"
  },
  "unread": true,
  "last_message_at": "2026-11-06T08:12:44.000Z",
  "messages_count": 4,
  "last_message": {
    "id": "1985321409876543210",
    "object": "message",
    "direction": "inbound",
    "text": "Yes, I want to charge for my Discord. How does it work?",
    "created_at": "2026-11-06T08:12:44.000Z",
    "media": [],
    "reactions": [],
    "encrypted": false,
    "reply_to_message_id": null
  },
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters"
  },
  "column": {
    "id": "q7m2xk4p",
    "name": "Interested"
  }
}

Перемещение диалога

POST/v1/conversations/:conversation_id/moveПраво writeMCPupdate_conversation

Перемещает диалог в другую колонку доски диалогов.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Параметры тела

Возвращает

Объект диалога.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 404resource_missing
    На доске аккаунта нет колонки с этим ID.
  • 400parameter_missing
    Отсутствует обязательный параметр. Название параметра указано в param.
POST/v1/conversations/:conversation_id/move
curl -X POST \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/move \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "column_id": "z3c6lf8a"
  }'
Ответ200
{
  "id": "msgOtJ8dvT",
  "object": "conversation",
  "lead_id": "msgOtJ8dvT",
  "profile": {
    "x_user_id": "1460283925",
    "username": "jane_builds",
    "name": "Jane Doe",
    "bio": "Runs a paid trading community. Daily setups, no hype.",
    "followers_count": 12400,
    "following_count": 380,
    "location": "Austin, TX",
    "website": "https://janedoe.com",
    "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
    "verified": true,
    "url": "https://x.com/jane_builds"
  },
  "unread": true,
  "last_message_at": "2026-11-06T08:12:44.000Z",
  "messages_count": 4,
  "last_message": {
    "id": "1985321409876543210",
    "object": "message",
    "direction": "inbound",
    "text": "Yes, I want to charge for my Discord. How does it work?",
    "created_at": "2026-11-06T08:12:44.000Z",
    "media": [],
    "reactions": [],
    "encrypted": false,
    "reply_to_message_id": null
  },
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters"
  },
  "column": {
    "id": "z3c6lf8a",
    "name": "Call booked"
  }
}

Закрепление диалога

POST/v1/conversations/:conversation_id/pinПраво writeMCPupdate_conversation

Закрепляет диалог во входящих X.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Возвращает

Объект диалога.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
POST/v1/conversations/:conversation_id/pin
curl -X POST \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/pin \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
Ответ200
{
  "id": "msgOtJ8dvT",
  "object": "conversation",
  "lead_id": "msgOtJ8dvT",
  "profile": {
    "x_user_id": "1460283925",
    "username": "jane_builds",
    "name": "Jane Doe",
    "bio": "Runs a paid trading community. Daily setups, no hype.",
    "followers_count": 12400,
    "following_count": 380,
    "location": "Austin, TX",
    "website": "https://janedoe.com",
    "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
    "verified": true,
    "url": "https://x.com/jane_builds"
  },
  "unread": true,
  "last_message_at": "2026-11-06T08:12:44.000Z",
  "messages_count": 4,
  "last_message": {
    "id": "1985321409876543210",
    "object": "message",
    "direction": "inbound",
    "text": "Yes, I want to charge for my Discord. How does it work?",
    "created_at": "2026-11-06T08:12:44.000Z",
    "media": [],
    "reactions": [],
    "encrypted": false,
    "reply_to_message_id": null
  },
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters"
  },
  "column": {
    "id": "q7m2xk4p",
    "name": "Interested"
  }
}

Открепление диалога

POST/v1/conversations/:conversation_id/unpinПраво writeMCPupdate_conversation

Открепляет диалог во входящих X.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Возвращает

Объект диалога.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
POST/v1/conversations/:conversation_id/unpin
curl -X POST \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/unpin \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
Ответ200
{
  "id": "msgOtJ8dvT",
  "object": "conversation",
  "lead_id": "msgOtJ8dvT",
  "profile": {
    "x_user_id": "1460283925",
    "username": "jane_builds",
    "name": "Jane Doe",
    "bio": "Runs a paid trading community. Daily setups, no hype.",
    "followers_count": 12400,
    "following_count": 380,
    "location": "Austin, TX",
    "website": "https://janedoe.com",
    "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
    "verified": true,
    "url": "https://x.com/jane_builds"
  },
  "unread": true,
  "last_message_at": "2026-11-06T08:12:44.000Z",
  "messages_count": 4,
  "last_message": {
    "id": "1985321409876543210",
    "object": "message",
    "direction": "inbound",
    "text": "Yes, I want to charge for my Discord. How does it work?",
    "created_at": "2026-11-06T08:12:44.000Z",
    "media": [],
    "reactions": [],
    "encrypted": false,
    "reply_to_message_id": null
  },
  "persona": {
    "id": "lvWBPnytpS",
    "name": "Tipsters"
  },
  "column": {
    "id": "q7m2xk4p",
    "name": "Interested"
  }
}

Удаление диалога

DELETE/v1/conversations/:conversation_idПраво writeMCPdelete_conversation

Удаляет диалог в Gemlead и во входящих X. Лид этого диалога останавливается во всех кампаниях. Это действие нельзя отменить.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Возвращает

Объект с id диалога и deleted, равным true.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
DELETE/v1/conversations/:conversation_id
curl -X DELETE \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
Ответ200
{
  "id": "msgOtJ8dvT",
  "object": "conversation",
  "deleted": true
}

Объект сообщения

Одно DM в диалоге, отправленное вами или лидом.

Атрибуты

  • idstring
    ID сообщения в X.
  • objectstring
    Всегда message.
  • directionstring
    inbound, если его написал лид, outbound, если вы.
    inboundoutbound
  • textstring
    Текст сообщения.
  • created_atstring
    Время отправки, ISO 8601.
  • mediaмассив objects
    Вложения сообщения, каждое со своими type и url. Изображения из X приходят через ссылку Gemlead.
  • reactionsмассив objects
    Реакции эмодзи на сообщение, сначала старые, по одной на человека и эмодзи.
  • encryptedboolean
    true для сообщения X Chat, которое Gemlead пока не может прочитать. Его text и media остаются пустыми, пока код X Chat его не разблокирует.
  • reply_to_message_idstring или null
    ID сообщения, на которое это сообщение отвечает, или null, если это не ответ.
Объект сообщения
{
  "id": "1985321409876543210",
  "object": "message",
  "direction": "inbound",
  "text": "Yes, I want to charge for my Discord. How does it work?",
  "created_at": "2026-11-06T08:12:44.000Z",
  "media": [],
  "reactions": [],
  "encrypted": false,
  "reply_to_message_id": null
}

Список сообщений

GET/v1/conversations/:conversation_id/messagesПраво readMCPlist_messages

Возвращает всю историю диалога из X постранично, сначала новые сообщения.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Параметры запроса

  • limitinteger
    Сколько сообщений вернуть, от 1 до 50. По умолчанию 25.
  • cursorstring
    next_cursor предыдущей страницы, чтобы получить более старые сообщения.

Возвращает

Список объектов сообщения.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 400parameter_invalid
    API не принимает значение параметра. Название параметра указано в param.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
GET/v1/conversations/:conversation_id/messages
curl -G \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/messages \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -d limit=50
Ответ200
{
  "object": "list",
  "data": [
    {
      "id": "1985329981234567890",
      "object": "message",
      "direction": "outbound",
      "text": "Happy to show you. Do you sell picks monthly or per event?",
      "created_at": "2026-11-06T08:20:03.000Z",
      "media": [],
      "reactions": [
        {
          "emoji": "👍",
          "direction": "inbound",
          "created_at": "2026-11-06T08:24:51.000Z"
        }
      ],
      "encrypted": false,
      "reply_to_message_id": "1985321409876543210"
    },
    {
      "id": "1985321409876543210",
      "object": "message",
      "direction": "inbound",
      "text": "Yes, I want to charge for my Discord. How does it work?",
      "created_at": "2026-11-06T08:12:44.000Z",
      "media": [],
      "reactions": [],
      "encrypted": false,
      "reply_to_message_id": null
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzIjoiMjAyNi0xMS0wNVQxNDowMzo0MC4xMTdaIn0"
}

Отправка сообщения

POST/v1/conversations/:conversation_id/messagesПраво writeMCPsend_message

Сразу отправляет лиду DM с вашего аккаунта X. Отправляйте текст, файл или и то, и другое. Получатель всегда берётся из диалога.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Параметры тела

  • textstring
    Текст сообщения, до 10 000 символов. Обязателен, если нет media.
  • mediaobject
    Файл, который отправляется с сообщением. Укажите его url или его data вместе с mime_type. Gemlead определяет тип по самому файлу. Изображения до 5 МБ, GIF до 15 МБ. Видео и голосовые сообщения ограничены только лимитами X, а если файл слишком велик для тела запроса, передайте url.
  • reply_to_message_idstring
    Ответить на это сообщение, одно из последних 20 в диалоге. Для ответа с медиафайлом нужен диалог в X Chat.

Возвращает

Отправленное сообщение с conversation_id, reply_to_message_id и transport, равным x_chat или classic.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 400parameter_missing
    Отсутствует обязательный параметр. Название параметра указано в param.
  • 400parameter_invalid
    API не принимает значение параметра. Название параметра указано в param.
  • 400media_kind_unsupported
    Этот диалог не принимает такой тип файла, например голосовое сообщение без X Chat.
  • 429dm_paused
    X временно ограничивает DM аккаунта. Retry-After показывает, когда они снова станут доступны.
  • 429dm_rate_limited
    Больше 10 DM в минуту.
  • 429dm_daily_limit
    Уже отправлено 300 DM за сегодняшние сутки по UTC или исчерпана суточная квота X для аккаунта.
  • 400recipient_not_messageable
    X отклонил отправку, потому что лид закрыл DM или заблокировал аккаунт.
  • 409conversation_unavailable
    В диалоге пока нет пользователя X, которому можно написать.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
POST/v1/conversations/:conversation_id/messages
curl -X POST \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/messages \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Happy to show you. Do you sell picks monthly or per event?"
  }'
Ответ200
{
  "id": "1985329981234567890",
  "object": "message",
  "conversation_id": "msgOtJ8dvT",
  "direction": "outbound",
  "text": "Happy to show you. Do you sell picks monthly or per event?",
  "created_at": "2026-11-06T08:20:03.000Z",
  "media": [],
  "reactions": [],
  "encrypted": false,
  "reply_to_message_id": null,
  "transport": "x_chat"
}

Добавление реакции

POST/v1/conversations/:conversation_id/messages/:message_id/reactionsПраво writeMCPreact_to_message

Ставит реакцию эмодзи на сообщение с вашего аккаунта X.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.
  • message_idstringОбязательно
    ID сообщения, одного из последних 20 в диалоге.

Параметры тела

  • emojistringОбязательно
    Эмодзи, например ❤️ или 👍.

Возвращает

Объект с conversation_id, message_id и emoji.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет сообщения с этим ID.
  • 400parameter_missing
    Отсутствует обязательный параметр. Название параметра указано в param.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
POST/v1/conversations/:conversation_id/messages/:message_id/reactions
curl -X POST \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/messages/1985321409876543210/reactions \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "emoji": "👍"
  }'
Ответ200
{
  "object": "reaction",
  "conversation_id": "msgOtJ8dvT",
  "message_id": "1985321409876543210",
  "emoji": "👍"
}

Удаление реакции

DELETE/v1/conversations/:conversation_id/messages/:message_id/reactionsПраво writeMCPreact_to_message

Убирает вашу реакцию с сообщения.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.
  • message_idstringОбязательно
    ID сообщения, одного из последних 20 в диалоге.

Параметры запроса

  • emojistringОбязательно
    Эмодзи, который нужно убрать.

Возвращает

Реакция с deleted, равным true.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет сообщения с этим ID.
  • 400parameter_missing
    Отсутствует обязательный параметр. Название параметра указано в param.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
DELETE/v1/conversations/:conversation_id/messages/:message_id/reactions
curl -X DELETE \
  "https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/messages/1985321409876543210/reactions?emoji=%F0%9F%91%8D" \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
Ответ200
{
  "object": "reaction",
  "conversation_id": "msgOtJ8dvT",
  "message_id": "1985321409876543210",
  "emoji": "👍",
  "deleted": true
}

Удаление сообщения

DELETE/v1/conversations/:conversation_id/messages/:message_idПраво writeMCPdelete_message

Удаляет сообщение у вас или у обеих сторон, если оно ваше и диалог идёт в X Chat.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.
  • message_idstringОбязательно
    ID сообщения, одного из последних 20 в диалоге.

Параметры запроса

  • for_everyoneboolean
    true удаляет его у обеих сторон, только для ваших сообщений в X Chat. По умолчанию false.

Возвращает

Объект с id сообщения, его conversation_id, deleted, равным true, и for_everyone.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет сообщения с этим ID.
  • 400parameter_invalid
    API не принимает значение параметра. Название параметра указано в param.
  • 409x_session_expired
    Сессия аккаунта X истекла. Переподключите его в приложении и повторите попытку.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
DELETE/v1/conversations/:conversation_id/messages/:message_id
curl -X DELETE \
  "https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/messages/1985329981234567890?for_everyone=true" \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
Ответ200
{
  "id": "1985329981234567890",
  "object": "message",
  "conversation_id": "msgOtJ8dvT",
  "deleted": true,
  "for_everyone": true
}

Объект перевода диалога

Переводятся ли сообщения диалога и на какой язык.

Атрибуты

  • objectstring
    Всегда conversation_translation.
  • conversation_idstring
    ID диалога.
  • enabledboolean
    Переводятся ли его сообщения по мере поступления.
  • decidedboolean
    Включили или выключили ли перевод вручную, а не по настройке Gemlead по умолчанию.
  • source_languagestring или null
    Язык лида, после того как он определён.
  • languagestring или null
    Язык, на который переводятся сообщения.
  • shownboolean
    Показывает ли приложение сообщения в переводе.
Объект перевода диалога
{
  "object": "conversation_translation",
  "conversation_id": "msgOtJ8dvT",
  "enabled": true,
  "decided": true,
  "source_language": "es",
  "language": "en",
  "shown": true
}

Получение настроек перевода

GET/v1/conversations/:conversation_id/translationПраво readMCPupdate_conversation_translation

Возвращает, переводится ли диалог и на какой язык.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Возвращает

Объект перевода диалога.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
GET/v1/conversations/:conversation_id/translation
curl \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/translation \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
Ответ200
{
  "object": "conversation_translation",
  "conversation_id": "msgOtJ8dvT",
  "enabled": true,
  "decided": true,
  "source_language": "es",
  "language": "en",
  "shown": true
}

Изменение настроек перевода

PATCH/v1/conversations/:conversation_id/translationПраво writeMCPupdate_conversation_translation

Включает или выключает перевод диалога и задаёт, показывает ли приложение сообщения в переводе.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Параметры тела

  • enabledboolean
    Переводить сообщения по мере поступления, ваши и лида.
  • shownboolean
    Показывать сообщения в переводе в приложении. Работает только с enabled.
  • languagestring
    Язык перевода. По умолчанию ваш язык в Gemlead, иначе английский.
    enfresitderuptnljazhkoartrhiidplukvithsv

Возвращает

Обновлённый объект перевода диалога.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 400parameter_invalid
    API не принимает значение параметра. Название параметра указано в param.
  • 400parameter_unknown
    В теле есть поле, которое этот эндпоинт не принимает.
PATCH/v1/conversations/:conversation_id/translation
curl -X PATCH \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/translation \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "shown": true,
    "language": "en"
  }'
Ответ200
{
  "object": "conversation_translation",
  "conversation_id": "msgOtJ8dvT",
  "enabled": true,
  "decided": true,
  "source_language": "es",
  "language": "en",
  "shown": true
}

Перевод сообщений

POST/v1/conversations/:conversation_id/translateПраво writeMCPtranslate_messages

Переводит последние сообщения диалога. Если перевод выключен, переводите по одному сообщению.

Параметры пути

  • conversation_idstringОбязательно
    ID диалога.

Параметры тела

  • message_idsмассив strings
    Сообщения для перевода, из последних 20. По умолчанию все, если перевод включён.
  • languagestring
    Язык перевода. По умолчанию ваш язык в Gemlead, иначе английский.
    enfresitderuptnljazhkoartrhiidplukvithsv

Возвращает

Объект с conversation_id, language, а в data для каждого сообщения его message_id, text и translation.

Ошибки

  • 404resource_missing
    В аккаунте ключа нет диалога с этим ID.
  • 400parameter_invalid
    API не принимает значение параметра. Название параметра указано в param.
  • 400translation_off
    Перевод выключен, а вы запросили больше одного сообщения.
  • 502upstream_unavailable
    X или сервис Gemlead не ответил. Ничего не изменилось, повторите через минуту.
POST/v1/conversations/:conversation_id/translate
curl -X POST \
  https://gemlead.ai/api/v1/conversations/msgOtJ8dvT/translate \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message_ids": ["1985321409876543210"],
    "language": "en"
  }'
Ответ200
{
  "object": "message_translations",
  "conversation_id": "msgOtJ8dvT",
  "language": "en",
  "data": [
    {
      "message_id": "1985321409876543210",
      "text": "Sí, quiero cobrar por mi Discord. Cómo funciona?",
      "translation": "Yes, I want to charge for my Discord. How does it work?"
    }
  ]
}
Получайте новости Gemlead
прямо на вашу почту.
Подписаться
Подписываясь, вы принимаете нашу Политику конфиденциальности и соглашаетесь получать новости нашей компании.
Gemlead
Продукт
Начать
Войти
Для кого
ИИ-агенты
Возможности
Цены
Партнёрам
FAQ
Возможности
Покупатели 24/7Сначала горячие60%+ ответовDM-телепатияВсе DM вместеВаш ИИ-клоузерМасштаб без границAPI, MCP, вебхукиСпросите Gemlead
Ресурсы
ГлавнаяAPIБлог
Правовая информация
Условия
Приватность
© 2026 Gemlead, Inc. Все права защищены.
Русский