# Superchat AI integration on Definable

> Superchat is a unified messaging platform that enables businesses to communicate with customers across multiple channels, including WhatsApp, Instagram Direct, Facebook Messenger, Email, and more.

## What this connects

Superchat is a unified messaging platform that enables businesses to communicate with customers across multiple channels, including WhatsApp, Instagram Direct, Facebook Messenger, Email, and more.

Vendor: https://www.superchat.com/

## Tools available

**17** tools available. First 12:

- `SUPERCHAT_CREATE_CONTACT` — Create Contact — Create a new contact in Superchat with phone or email handles. Use this tool to register contact details before sending messages. You must provide at least one handle (phone or email). Optional fields include first name, last name, gender, and custom attributes (if predefined in your account settings).
- `SUPERCHAT_CREATE_TEMPLATE_FOLDER` — Create Template Folder — Create a new template folder in SuperChat for organizing message templates. Template folders help organize WhatsApp and other messaging templates into logical groups (e.g., Marketing, Sales, Customer Support). Use this action before creating templates when you want to keep them organized.
- `SUPERCHAT_DELETE_WEBHOOK` — Delete Webhook — Tool to delete a specific webhook by its ID. Use when you need to remove an obsolete or unwanted webhook subscription. First use SUPERCHAT_LIST_WEBHOOKS to retrieve the webhook ID, then use this action to delete it. Example: Delete webhook wh_UPYSN0Etofjl7lhhQ9yhL.
- `SUPERCHAT_GET_CONTACT` — Get Contact — Retrieve a specific contact's details by ID. Returns the contact's name, handles (phone, email, social), custom attributes, and timestamps. Use this to look up contact information before sending messages or updating contact details. Example: "Get contact details for co_abc123" or "Fetch info for contact co_xyz789".
- `SUPERCHAT_GET_FILE` — Get File — Retrieve metadata for a specific file by its ID. Returns file details including the file name, MIME type, API resource URL, and a temporary download link with expiration. Use this to get information about uploaded files before downloading or processing them.
- `SUPERCHAT_GET_USER` — Get User — Retrieve details of a specific user in the Superchat workspace by their user ID. Use this tool when you need to fetch profile information for a known user. Note: You can obtain user IDs by first calling the List Users action. Example user_id format: 'us_abc123xyz'
- `SUPERCHAT_LIST_CHANNELS` — List Channels — Lists all communication channels in your Superchat workspace. Channels represent different messaging mediums (WhatsApp, email, SMS, Telegram, Instagram, Facebook) through which conversations occur. Results are sorted by creation date (newest first) and can be paginated using 'limit', 'after', or 'before' parameters.
- `SUPERCHAT_LIST_CONTACTS` — List Contacts — List all contacts in the Superchat workspace with cursor-based pagination. Use this tool to browse contacts, find contact IDs, or export contact data. Results are sorted by creation date (newest first).
- `SUPERCHAT_LIST_CONVERSATIONS` — List Conversations — Retrieves a paginated list of all conversations in your Superchat account. Each conversation includes channel info, status (open/snoozed/done), assigned users, contacts, labels, and inbox details. Use this to browse conversations, find specific ones by status or channel, or get conversation IDs for further operations. Supports cursor-based pagination to handle large result sets.
- `SUPERCHAT_LIST_CUSTOM_ATTRIBUTES` — List Custom Attributes — List all custom attributes defined for contacts in your Superchat account. Custom attributes are user-defined fields that extend contact data beyond standard fields like name and email. Use this action to discover available custom attributes before reading or updating contact information. Supports cursor-based pagination for accounts with many custom attributes. Common use cases: - Discover available custom fields before updating contacts - Retrieve custom attribute types (string, number, date, select, etc.) - Get custom attribute IDs for use in other API calls
- `SUPERCHAT_LIST_INBOXES` — List Inboxes — Tool to list all inboxes. Use when you need to retrieve inbox IDs and metadata before sending or organizing messages.
- `SUPERCHAT_LIST_LABELS` — List Labels — List all labels in the Superchat workspace. Labels are used to categorize and organize conversations. Use this tool to retrieve available labels and their IDs, which can then be used to assign labels to conversations via the update conversation endpoint. Supports cursor-based pagination for workspaces with many labels.

## Auth

Auth schemes: `API_KEY`.

## How agents use Superchat

Inside a Definable workflow, Superchat is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Superchat** — the Researcher (GPT-5.5) pulls context from Superchat (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Superchat** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Superchat (create record, post message, draft email).
- **Designer / Engineer → Distributor → Superchat** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Superchat (attach file, open PR comment, post status).

The Verifier checks every Superchat call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- team chat — https://definable.ai/apps/category/team-chat/
- customer support — https://definable.ai/apps/category/customer-support/

## Related

- HTML page: https://definable.ai/apps/superchat/
- Same category (team chat): https://definable.ai/apps/category/team-chat/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt