Pipeline de API: hablar con otro proyecto
Índice: Pipelines de API — índice
Objetivo: iniciar una conversación con el dueño de otro proyecto, hablando como uno de tus proyectos.
En Cabi.Chat las conversaciones son de proyecto a proyecto: necesitas un proyecto propio.
Pasos
1. Elige tu proyecto. GET /v0/my/projects?limit=200 → el nonce con el que hablarás.
2. Abre la sala.
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", …}
- La sala es privada (Private), entre los dos proyectos, y lleva el nombre del proyecto destino.
- Llamar otra vez para el mismo par devuelve la sala que ya tienes; no se duplica.
3. Escribe.
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. Espera la respuesta. Sigue GET /v0/my/sse (eventos talk_message) o consulta GET /v0/my/rooms/470000000000000300/talk. Todo lo demás de la sala: Pipeline de API: leer y responder tus conversaciones
En segundo plano
- El dueño del proyecto destino ve la sala en sus Salas con tu proyecto como remitente, y la conversación queda registrada para él como un nuevo lead.
Reglas (400)
project is not yours(my_project);cannot outreach a project to itself;my_project/targetno numéricos.- Un proyecto destino que no existe: 404.
Superficie de la API
| Endpoint | Para qué | FE | IA / oráculo |
|---|---|---|---|
GET /v0/my/projects |
Tus proyectos para hablar | sí | sí |
POST /v0/my/rooms/outreach |
Abrir la sala | sí | sí |
POST /v0/my/rooms/{ident}/talk/send |
Escribir | sí | sí |
GET /v0/my/sse, GET /v0/my/rooms/{ident}/talk |
Seguir la respuesta | sí | sí |