API-пайплайн: написать другому проекту

Индекс: API-пайплайны — индекс

Цель: начать разговор с владельцем другого проекта от имени одного из ваших проектов.

Разговоры на Cabi.Chat идут от проекта к проекту: нужен свой проект.

Шаги

1. Выберите свой проект. GET /v0/my/projects?limit=200 → nonce, от имени которого вы будете говорить.

2. Откройте комнату.

POST /v0/my/rooms/outreach
{"my_project": "470000000000000001", "target": "470000000000000002"}
→ {"nonce": "470000000000000300", "card_type": "room",
   "i18n": [{"lang": "en", "title": "Project: Green Bakery"}],
   "talk": {"kind": "native", …}, "role": "owner", "visibility": "Private", …}

• Комната приватная (Private), между двумя проектами, названа по целевому проекту.
• Повторный вызов для той же пары возвращает уже существующую комнату; дубликата нет.

3. Напишите.

POST /v0/my/rooms/470000000000000300/talk/send
{"text": "Hello! We make wedding cakes and would like to work with you."}
→ {"event_id": "<event id>"}

4. Ждите ответа. Следите за GET /v0/my/sse (события talk_message) или опрашивайте GET /v0/my/rooms/470000000000000300/talk. Всё остальное в комнате: API-пайплайн: читать разговоры и отвечать в них

За кадром

• Владелец целевого проекта видит комнату в своих «Комнатах» с вашим проектом в качестве отправителя, а разговор записывается для него как новый лид.

Правила (400)

• project is not yours (my_project); cannot outreach a project to itself; my_project/target не числовые.
• Несуществующий целевой проект: 404.

Поверхность API