Pipeline de API: recibir un radar inicial gratuito de 7 días para tu proyecto y seguir sus coincidencias

Índice: Pipelines de API — índice

Objetivo: una persona con página de proyecto en Cabi.Chat recibe un radar gratuito de 7 días para ese proyecto y sigue sus coincidencias.

Qué recibe la persona

• Un radar que Cabi.Chat lleva para su proyecto, gratis durante 7 días. Encuentra mensajes públicos en grupos de Telegram donde la gente pide lo que ofrece el proyecto y los reúne como coincidencias.
• El radar no escribe a nadie: la persona decide a quién contactar.
• Dos enlaces, ya reclamados para la persona en su proyecto: trial (manejarlo: iniciar / detener, editar palabras clave; 7 días) y view (leer el radar y sus coincidencias; sin fin).
• A los 7 días el radar se pausa; las coincidencias siguen legibles. Mantener un radar en marcha es un paso Pro: Pipeline de API: escuchar grupos de Telegram para encontrar a quien te necesita: crear y ajustar un radar, trabajar sus coincidencias y hacer el primer contacto (borrador, envío, outreach automático)

Quién lo llama

El dueño del proyecto: con su propia sesión o PAT, o a través de un oráculo de Cabi.Chat al que dio acceso de configuración. Un radar inicial por persona.

Pasos

1. Abrir. El cuerpo es opcional: sin él, las palabras clave salen de las rúbricas o el título del proyecto y de su ciudad.

POST /v0/my/projects/470000000000000020/starter-radar
{"keywords": [["dentist", "dental clinic"]], "not_groups": ["vacancy"], "city": "bali"}
→ {"campaign": "470000000000000021", "matches_workspace": "470000000000000022",
   "links": {"trial": {"nonce": "…", "token": "…", "url": "https://cabi.chat/l/…"},
             "view":  {"nonce": "…", "token": "…", "url": "https://cabi.chat/l/…"}},
   "trial_ends_at": "2026-10-22T…Z", "status": "Active", "is_active": true,
   "keyword_groups": [["dentist", "dental clinic"], ["bali"]], "not_groups": [["vacancy"]], "created": true}

• keywords: grupos (OR dentro de un grupo, AND entre grupos), incluida la ciudad; palabras de 4 letras o más; se pasan a minúsculas y se normalizan.
• not_groups: palabras de 2 letras o más, en lista plana o en grupos.
• Llamar otra vez para el mismo proyecto devuelve el mismo radar (created: false, el cuerpo se ignora).

2. Leer coincidencias.

GET /v0/my/workspaces/470000000000000022?contained_limit=200
→ {"contained": [{"card_type": "post", "nonce": "…", "snippet": "…", "source_url": "https://t.me/example_group/123", …}], …}

3. Ajustar durante la prueba. PATCH /v0/my/campaigns/470000000000000021 {"keyword_groups": [[…]], "not_groups": [[…]]}, y POST …/start / …/stop. Los demás campos los fija Cabi.Chat.

Reglas

• El proyecto no es tuyo → 404. Ya tienes otro radar inicial en otro proyecto → 409 … one starter radar per person. Los radares iniciales pueden no estar disponibles en algún momento → 400 starter radars are not available right now.
• Errores de palabras clave → 400 con el motivo (keywords hold no usable word (4+ letters), could not derive keywords from the project …: pass keywords).
• Una prueba terminada no se reinicia llamando otra vez.

Superficie de la API