Skip to content
ChatVendor ChatVendor

Messenger API

Everything the panel can do with a connected Telegram, WhatsApp or Instagram account, over REST — one key, one response shape, chapter by chapter.

Scenarios

Runs of your multi-step flows: list them, approve or reject a waiting step.

A run that reached a confirmation step waits in status confirm until you decide.

Base URL: https://chatvendor.net/api/v1 · every response is {"success": true, "data": …}

GET /scenario-runs Scenario runs

Scope: scenarios:manage

Response 200 · ScenarioRun[]

id integerscenario_id integeraccount_id integerpeer_id integerstatus string: active | waiting | confirm | done | failed | cancelledstep integerdata object

curl https://chatvendor.net/api/v1/scenario-runs \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
POST /scenario-runs/{runId}/decide Approve, reject or cancel a run

Scope: scenarios:manage

Parameters

runIdpath · integerrequired

Run id

Body (application/json)

decisionstring: approve | reject | cancelrequired

Response 200 · ScenarioRun

id integerscenario_id integeraccount_id integerpeer_id integerstatus string: active | waiting | confirm | done | failed | cancelledstep integerdata object

curl -X POST https://chatvendor.net/api/v1/scenario-runs/42/decide \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
  -H "Content-Type: application/json" \
  -d '{"decision":"approve"}'