Skip to content
Truto

Unified API

Unified Instant Messaging API

One standardized interface to read and write instant messaging data across every provider. 7 unified resources, 4 supported integrations, zero provider-specific code.

https://api.truto.one/unified/instant-messaging
Start integrating API docs
7

Unified resources

4

Supported integrations

Pass‑through

Real-time, no data storage

Data Model

IM resources

Every resource is normalized across providers. Use the same schema whether your customer is on Google Chat or Microsoft 365.

Attachments

Attachments are files or links that are attached to messages in the source application.

10 fields Docs →
Attachments fields
id string
file_name string
channel_id string
size number
file_url string
content_type string
uploaded_by string
uploaded_by_type string
created_at string
updated_at string

Channels

Channels are a way to group the communication happening between users in the source application. Channels can be used for group messaging, team messaging, etc.

12 fields Docs →
Channels fields
id string
name string
description string
organization object
workspace object
group object
type string
status string
is_member boolean
created_by object
created_at string
updated_at string

Groups

Groups are a collection of users in the source application. In some applications, they might also be called Teams.

8 fields Docs →
Groups fields
id string
name string
description string
organization object
workspace object
type string
created_at string
updated_at string

Members

Members are users, apps, bots and integrations part of the organization. To differentiate between the type of member, use the `type` attribute.

25 fields Docs →
Members fields
id string
first_name string
last_name string
title string
name string
username string
emails array
phones array
status string
is_email_verified boolean
organizations array
workspaces array
type string
groups array
avatar string
timezone string
languages array
bio string
created_at string
updated_at string
last_active_at string
last_login_at string
status_changed_at string
activated_at string
urls array

Messages

Messages are the communication between users in the source application.

9 fields Docs →
Messages fields
id string
body object
attachments array
author object
channel object
parent object
has_children boolean
created_at string
updated_at string

Organizations

Organizations are the top level entity in the source application. Users are associated with an organization.

4 fields Docs →
Organizations fields
id string
name string
created_at string
updated_at string

Workspaces

Workspaces represent concepts like teams, workspaces, projects in apps that support them

7 fields Docs →
Workspaces fields
id string
name string
description string
status string
organization object
created_at string
updated_at string

Integrations

4 integrations, one API

Connect to any of these providers through the Unified Instant Messaging API. Same resources, same schema, same code.

Google Chat Microsoft 365 Microsoft Teams Slack

How It Works

From zero to integrated

Go live with the Unified Instant Messaging API in under an hour. No boilerplate, no maintenance burden.

01

Connect your customer’s account

Use Truto’s pre-built auth flows to connect any instant messaging provider. OAuth, API keys, and custom auth — all handled.

02

Query the unified API

Read and write data through a single, normalized REST API. Same endpoints, same schema, regardless of the underlying provider.

03

Customize with JSONata

Need a field the unified model doesn’t cover? Extend the schema with declarative JSONata mappings — no code deploys, no waiting on us.

From the Blog

IM integration guides

Deep dives, architecture guides, and practical tutorials for building instant messaging integrations.

Connect Zendesk to ChatGPT: Automate Ticket Support & Agent Tasks

Learn how to connect Zendesk to ChatGPT using a managed MCP server. Automate ticket triage, update statuses, and execute support workflows without custom code.

Connect Jira to ChatGPT: Automate Issue Tracking & Task Updates

Learn how to connect Jira to ChatGPT using a managed Model Context Protocol (MCP) server. Automate ticket triage, issue updates, and IT workflows without building custom API integrations.

Why B2B Fintech Needs More Than Bank Data: Embracing Unified APIs for Core Business Systems

Bank feeds aren't enough for B2B fintech. Learn why engineering teams are adopting horizontal unified APIs to integrate with NetSuite, Workday, and QuickBooks.

What Is the ROI of Adding Integrations to Your SaaS Product? (2026 Guide)

Calculate the true ROI of SaaS integrations. Hard numbers on ARR impact, churn reduction, maintenance costs, and why most teams get the TCO math wrong.

Connect Pylon to ChatGPT: Automate B2B Support Sync

Learn how to connect Pylon to ChatGPT using Truto's managed MCP server. Automate B2B support triage, user management, and account sync without custom code.

Plugging Revenue Leaks: Automating Quote-to-Cash with Unified APIs

Revenue leakage costs companies 3-7% of top-line revenue annually. Learn how engineering teams use unified APIs to automate quote-to-cash workflows.

Unified Instant Messaging API

Start building with the Unified Instant Messaging API

4 integrations. 7 unified resources. Zero provider-specific code. Ship instant messaging integrations in hours, not months.

Talk to us