# Heyy AI integration on Definable

> Connect with your customers on Whatsapp, SMS, Messenger and Instagram using automation.

## What this connects

Connect with your customers on Whatsapp, SMS, Messenger and Instagram using automation.

Vendor: https://heyy.io/

## Tools available

**13** tools available. First 12:

- `HEYY_CREATE_ATTRIBUTE` — Create Contact Attribute — Tool to create a new custom attribute for contacts in Heyy. Use when you need to add custom fields to track additional information about contacts, such as customer segments, preferences, or custom identifiers.
- `HEYY_CREATE_CONTACT` — Create Contact — Tool to create a new contact in Heyy with optional details including first name, last name, email, phone number, labels, and custom attributes. Use when you need to add a new contact to your Heyy account.
- `HEYY_CREATE_LABEL` — Create Label — Tool to create a new label for categorizing contacts in Heyy. Use when you need to organize contacts into categories or groups.
- `HEYY_CREATE_WEBHOOK` — Create Webhook — Tool to create a new webhook for receiving event notifications across multiple channels. Use when you need to set up real-time event notifications for messages.
- `HEYY_DELETE_ATTRIBUTE` — Delete Attribute — Tool to delete an attribute by its unique identifier. Use when you need to remove an attribute from the system.
- `HEYY_DELETE_LABEL` — Delete Label — Tool to delete a label by its unique identifier. Use when you need to remove a label from the system.
- `HEYY_DELETE_WEBHOOK` — Delete Webhook — Tool to delete a webhook by its unique identifier. Use when you need to remove a webhook from Heyy.
- `HEYY_LIST_ATTRIBUTES` — List Attributes — Tool to retrieve all attributes available in the Heyy system. Use when you need to get a list of all attributes with their properties and visibility settings.
- `HEYY_LIST_AUTOMATIONS` — List Automations — Tool to retrieve automation workflows for a specified channel. Use when you need to get all workflows configured for a channel.
- `HEYY_LIST_CHANNELS` — List Channels — Tool to retrieve all available channels from the Heyy system. Use when you need to get a complete list of channels with their details including name, type, status, and timestamps.
- `HEYY_LIST_MESSAGE_TEMPLATES` — List Message Templates — Tool to retrieve all message templates available in the Heyy system. Use when you need to view all existing templates for messaging.
- `HEYY_LIST_WEBHOOKS` — List API Webhooks — Tool to retrieve all API webhooks configured for the account. Use when you need to inspect or manage webhook configurations.

## Auth

Auth schemes: `API_KEY`.

## How agents use Heyy

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

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

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

## Categories

- communication — https://definable.ai/apps/category/communication/
- marketing automation — https://definable.ai/apps/category/marketing-automation/

## Related

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