Skip to content
DIMENSION LABS Docs

02 Get your data in /Integrations

Any other system

Connect any system with an API by pulling its messages and sending them to Dimension Labs with the universal API.

If your platform has no guide here, the same pattern works for it: pull new messages from its API, reshape each into our format, and send it to the universal API. You run this on your side, using this page and your vendor’s API docs.

The pattern

Section titled “The pattern”
  1. Get API access in your system: an API key, token or OAuth app with read access to conversations.
  2. Add a source in Dimension Labs: Data Sources > Unstructured data, the Universal API tile. Copy its API key. See Your API key.
  3. Pull new messages since the last run. Most vendors offer an “updated since” or incremental endpoint.
  4. Reshape each message into the conversation format: text, userId, incoming, sessionId, dimensionlabs_timestamp, plus conversationId and any extra fields in platformJson.
  5. Send each message with sendToDimensionLabs from dimensionlabs.mjs. Write it as export async function syncX({ since, historical = false }) that returns the new since, like every guide, and the scheduled sync runner works with it unchanged.
  6. Run it: once for history (then a backfill), then every 15 minutes.

Any guide makes a good starting point; Zendesk is a typical one. Before you go live, read Rules that trip up integrations: direction, milliseconds, one-second spacing, no colons in ids, and no personal data. If your system has no userId, copy the sessionId into userId.

Need help? Email [email protected] with the system’s name and a sample record.