Connect Heyy to Your AI Agent

Look up a contact and use your supplied details to create or update its profile.

9 tools API key

Try a Heyy Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Heyy

Correct a Contact Profile

Find the matching contact and apply the name or custom attributes you specify.

/oo Heyy: Search Heyy contacts for [name or phone], read contact [ID], and update its name to [name] and custom attributes to [values].

Start Working with Heyy

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Heyy

    Connect a Heyy API key from Settings > API Keys.

    Connect Heyy →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Access to the Heyy business whose contacts you want to manage.

Heyy Tools

The Heyy connection reads and manages contacts, labels, and attribute definitions, and lists communication channels. It does not expose message sending or conversation reading.

Contact Records

Search and read contacts, create profiles, and update names, labels, or custom attributes.

Labels, Attributes, and Channels

Inspect available contact labels, attribute definitions, and channels; create labels or attribute definitions.

9 tools

List Contacts

List Heyy contacts with optional pagination, sorting, and search.

heyy.list_contacts

Get Contact

Retrieve one Heyy contact by ID.

heyy.get_contact

Create Contact

Create a Heyy contact with profile fields, labels, and custom attributes.

heyy.create_contact

Update Contact

Update a Heyy contact's profile fields, labels, or custom attributes.

heyy.update_contact

List Labels

List Heyy labels.

heyy.list_labels

Create Label

Create a Heyy label.

heyy.create_label

List Attributes

List Heyy contact attribute definitions.

heyy.list_attributes

Create Attribute

Create a Heyy contact attribute definition.

heyy.create_attribute

List Channels

List Heyy communication channels.

heyy.list_channels

Frequently Asked Questions

How can I find the correct contact?

Search the contact list and read the selected contact by its ID before applying changes.

Can I create a custom contact field?

Yes. Create an attribute definition with a name and external ID, then use the relevant values when creating or updating contacts.

Can I send a message through this connection?

The available actions manage contact data and list channels. There is no message-sending action in this connection.

Connect Heyy

About Heyy ↗