The
Developer-SDK
is a part of the Text Platform Developer Studio and its main purpose is to arm your project with tooling that optimizes usage ofText Platform
ecosystem.
To use the Developer SDK
, you need to install it first. You can do this using npm or yarn:
npm install @livechat/developer-sdk
The App
is class that provides methods for initializing and configuring your developer application.
In order to use the App
class in your project first you need to define your AppConfig
accordingly to shape:
interface AppConfig {
/* 1 */ appId: string;
/* 2 */ auth?: {
clientId?: string;
mode?: "popup" | "iframe" | "redirect";
};
}
We suggest store config in dedicated file: livechat.config.json
// livechat.config.json
{
...
}
but you can also store in it variable:
const config: AppConfig = {
// ...
};
- Developer App ID
A required property of AppConfig
is appId
- it can be obtained directly from Developer Console by extracting it from url:
https://platform.text.com/console/apps/{appId}/monitor
- Authorization
If your Developer App has authorization block you can use Developer-SDK
to process authorization for you. You can find value for property clientId
in your Authorization block in Developer Console. Second parameter is mode
- use can use three different strategies: popup
, iframe
, redirect
(default if not given).
Use the App.init
method to initialize your Developer App. It takes a AppConfig
as its argument and returns a App
instance:
import { App, AppConfig } from "@livechat/developer-sdk";
import lcConfig from "./livechat.config.json";
const config = lcConfig as AppConfig;
const app = App.init(config);
In order to trigger authorization you can use authorize
method on your app instance:
await app.authorize();
Keep in mind that authorize
method behavior vary depending on authorization strategy:
- for
popup
andiframe
it resolves as soon as login process is finished and returns authorization data (alsoapp.authorization
is being filled) - for
redirect
it returnsundefined
, but it redirects to login process and when it's backauthorize
method has to be call again to finalize authorization
Usage:
Have a look at @livechat/developer-sdk to see how the App
can be integrated into your react application.
Developer app instance allows you to use Developer Console Reporting feature.
Usage:
await app.features.reporting.sendError("4xx");
Definition:
interface ReportingFeature {
sendError(type: "4xx" | "5xx", payload?: string): Promise<void>;
}
API:
POST https://api.text.com/app_monitoring/${appId}/events
BODY
required: true
content:
application/json:
schema:
type: object
properties:
organization_id:
type: string
format: uuid
description: Organization ID associated with the event
example: 3aa138c1-c137-41c6-6b26-cface5857378
type:
type: string
description: "Event type. Supported types: 4xx, 5xx"
example: "4xx"
payload:
type: string
description: "Event payload. Max length: 1 kB."
example: "{\"code\": 404, \"reason\": \"Not found\"}"