In-app generic action/chat

In-app generic action/chat enables brokers to integrate custom actions and support chat functionality directly within cTrader.

Prerequisites

Important

Before implementing in-app generic action/chat, ensure completion of:

Setup actions: Infrastructure & connectivity, authentication of API calls
Contracts: Broker identification, screen URL conventions
Identity options: Either SSO user creation and authorisation or one-time token handoff

In-app generic action/chat opens a screen using a token resolved by the identity option; it introduces no broker → cTrader endpoints of its own.

Token resolution depends on the identity option in use:

One-time token handoff: The broker redeems the OT token received via the URL — POST /ctid2/inAppToken/redeem (Block B).
SSO user creation and authorisation: No broker → cTrader call is required; cTrader validates the OT token via the broker CRM's POST /oauth2/onetime/authorize endpoint (called by cTrader, not the broker).