Connect Heyy integrations
VerifiedCustomer messaging on WhatsApp with AI employees, campaigns and automations, connected to WEXTL workflows and AI agents. Route Heyy messages and channel activity into workflows that keep your team and your tools in step. When Watch Events (Instant) arrives, update the CRM, a ticket or a doc automatically.
- 3-day trial
- Cancel anytime
- Up to 10 minutes quick set up
- GDPR
- Data Encryption
- 2FA
- Local Data Region
Supported triggers and actions for Heyy integration
Triggers can detect changes in Heyy and run actions that can create, search or modify data inside Heyy automatically[3], exactly how you set them.
- Watch Events (Instant) Fires the workflow the moment Heyy sends a webhook event. Each event includes its Event name, Delivery ID and Message.
- Watch New Chats Emits each conversation opened since the previous poll. Use Channel to restrict it to one number or account.
- Watch New Contacts Emits each contact added to Heyy since the previous poll.
- Get a Campaign Pulls a campaign with its Recurrence, Scheduled At and Latest Execution ID.
- Get a Channel Reads a messaging channel with its Type, Vendor and Status.
- Get a Chat Fetches a conversation including whether it Is Unread, its Unread Count and its Open Until time.
- Get a Contact Retrieves a contact with the Full Name, Handles and Labels, and shows whether it Is Subscribed.
- Get a File Finds a stored file by its File ID and returns its Name, Content Type, URL and Size.
- Get a Journey Shows a journey with its Type, Status and Steps.
- Get a Label Checks the Color a label was created with, plus when it was last changed through Updated At.
- Get a Message Template Reads a template with its Type, Status, Message Content and Variables.
- Get a Public File URL Turns a File ID into a public link, returned as URL.
- Get a Team Returns a team with its Name, Icon and Users.
- Get a User Fetches an agent with their Email, Phone Number and Profile Picture.
- Get an Attribute Looks up one contact field and shows its Type, Visibility and Details.
- Get an Automation Returns the Status of an automation together with the times it was Created At and last Updated At.
- Get the Workspace Reads the Name, Timezone and Availability of your workspace.
- List Attributes Finds contact attributes matching Search or a Filter Expression, ordered with Sort By. Use Limit to stop after a set total.
- List Automations Lists automations filtered by Status, free Search or a Filter Expression. Use Sort By to order them and Limit to fix the count.
- List Campaigns Returns campaigns matching Search or a Filter Expression such as equals(status, 'open'). Add Sort By for ordering and Limit for the size.
- List Channels Browses messaging channels. Narrow them with Channel Type, Status, Search or a Filter Expression. Set the order with Sort By and the count with Limit.
- List Chats Finds conversations by Status, Unread flag, Channel or Contact. Combine with Search, Filter Expression, Sort By and Limit.
- List Contacts Searches your contacts by Label, Subscribed state, exact Email or exact Phone Number, and by Search text or Filter Expression. Use Sort By and Limit for order and count.
- List Journeys Retrieves journeys for review, matched through Search or a Filter Expression, and ordered via Sort By. Use Limit to trim.
- List Labels Gathers labels. Type some Search words or a Filter Expression to find specific ones, then apply Sort By and Limit to shape the output.
- List Message Templates Shows message templates filtered by Status. For narrower results, type Search words or write a Filter Expression, then pick Sort By and Limit.
- List Teams Collects the teams of the workspace. Search and a Filter Expression can narrow them. Use Sort By to arrange them and Limit to set the total.
- List Users Lists the agents of the workspace, each with Email, Phone Number and Full Name. Use Limit to read fewer.
- List Webhooks Searches the webhooks registered in Heyy, each with a URL Host and Events. Narrow and order them through Search, Filter Expression and Sort By, and cap the count with Limit.
- Add Campaign Recipients Enrols the chosen Contacts in a Heyy campaign, and lists each one added with its Display Name and Phone Number.
- Add Labels to a Contact Attaches Labels to a contact and returns the updated profile.
- Assign a Chat to a Team Routes a conversation to a team. Leave Team empty to remove the current team. Turn on Trigger Automations to fire the automations tied to this change.
- Assign a Chat to a User Passes a conversation to one agent. Leave User empty to unassign it. Switch on Trigger Automations if automations should react to the change.
- Change a Chat Status Moves a conversation to a new Status. Turn on Trigger Automations to also run any automation set to start from a status change.
- Create a Campaign Sets up a campaign that runs an Automation for its recipients. Use Scheduled At to start it automatically, Variables (JSON) for automation values and Recurrence Rules to repeat it.
- Create a Contact Adds a person to Heyy with a First Name, Last Name, Phone Number or Email. Attach Labels and extra Attributes at the same time.
- Create a Label Adds a label with a Name and a Color, ready to be put on contacts.
- Create a Message Template Registers a template on a Channel in a chosen Language and Category. Fill Body, Header, Footer and Buttons (JSON) for its content, and Attachments for media files.
- Create a Team Creates a team with an Icon and a Name. Choose its Members from your users.
- Create an Attribute Defines a new contact field with a Type and Display Name. Add Options for the two select types, and use Show in Inbox, Show in Contacts or Ask When Creating Contacts to control where it appears. Heyy does not allow changing the Type afterwards.
- Create or Update a Contact Saves a person by First Name, Last Name, Phone Number or Email, adding Labels and Attributes. A matching contact is updated and otherwise a new one is created.
- Create or Update Contacts in Bulk Saves up to 1000 contacts in one request. Heyy matches each by phone number or email, so existing people are updated and new ones are created. Add Labels to tag them.
- Delete a Campaign Removes a campaign from Heyy and says whether its ID is among the Deleted Ids or the Not Found Ids.
- Delete a Chat Clears a conversation out of the inbox.
- Delete a Contact Deletes a person from your Heyy contacts.
- Delete a Label Removes a colored label from your Heyy workspace.
- Delete a Message Template Deletes a saved message template from a channel.
- Delete a Team Deletes a team from your Heyy workspace for agents.
- Delete an Attribute Deletes a contact attribute and reports Deleted Ids and Not Found Ids.
- Make an API Call Sends a free-form request to the Heyy REST API, signed with your saved credential.
- Mark a Chat as Not Sensitive Clears the sensitive flag from a conversation so it shows normally in the inbox.
- Mark a Chat as Read Sets a conversation to read, which resets its Unread Count.
- Mark a Chat as Sensitive Flags a conversation as holding sensitive content.
- Mark a Chat as Unread Sets a conversation to unread so it appears in the inbox again.
- Pause an Automation Stops an automation from running until it is unpaused, and reports its new Status.
- Remove Campaign Recipients Removes Contacts from a campaign recipient list and reports Deleted Ids and Not Found Ids.
- Remove Labels from a Contact Removes the chosen Labels from a contact and gives the refreshed profile.
- Send a Message Sends a message to an existing chat, or to a contact, phone number, email or handle through a Channel. Provide Text or Attachments, add a Header or Footer, and set Scheduled At to send later.
- Send a Template Message Sends an approved Template to a chat, contact, phone number, email or handle. Fill Variables (JSON) for body values, Template Attachments for header media and Scheduled At to send later.
- Start a Campaign Launches a campaign immediately. Give Variables (JSON) to fill the variables used by its automation.
- Subscribe a Contact Opts a contact in to receive messages and returns whether it Is Subscribed.
- Subscribe Contacts to a Journey Enrols Contacts in a journey and reports each Status and when they were Subscribed At.
- Trigger an Automation Runs an automation for one contact. Use Variables (JSON) to pass values, and Scheduled At to start it later instead of now.
- Unpause an Automation Resumes a paused automation and reports its new Status.
- Unsubscribe a Contact Opts a contact out of messages and shows whether it Is Subscribed afterwards.
- Unsubscribe Contacts from a Journey Ends the journey enrolment of the listed Contacts and shows each Status.
- Update a Campaign Edits a campaign Name, Automation, Scheduled At or Recurrence Rules. Use Clear Fields to empty a value such as the schedule or recurrence.
- Update a Contact Edits a contact First Name, Last Name or Attributes. Pick Clear Attributes and Clear Fields to empty values.
- Update a Label Renames a label or gives it a new Color code.
- Update a Message Template Rewrites a template Name, Category, Body, Header, Footer or Buttons (JSON), and swaps its Attachments.
- Update a Team Changes a team Icon, Name or Members.
- Update an Attribute Changes a contact field with a new Display Name or Options. Switch on Show in Inbox, Show in Contacts or Ask When Creating Contacts to decide where it appears.
- Upload a File Stores a File in Heyy for use in messages, with its File Type. The new file reports its ID, Name and URL.
How to integrate Heyy in automation workflow?
Heyy in three steps: start with "Watch Events (Instant)", connect one credential, then add your next step.
How Heyy connects and integrates with WEXTL
Save and approve your credentials once. WEXTL® stores authorization information encrypted and reuses the authentication whenever Heyy app is called in workflows. That allows your communication automations to run without your attention, per defined schedule[7]. See the integration guide[6] for a detailed list of fields that Heyy supports.
Full Heyy API documentationThe following table illustrates what fields Heyy integration require during authorization flow inside our workflow builder[4].
Connect Heyy
API Key*Text
••••••••
| Field | Type | Help |
|---|---|---|
API KeyRequired | password | In Heyy, open Settings, then API Keys, create a key and paste it here. Every request with this key can reach your whole workspace. |
Connect Heyy to popular apps on WEXTL
Enter a name of the other app you want to sync with Heyy below. Click on selected app to explore integration options with Heyy. If the app you search for is not available in WEXTL yet, you can use HTTP node[10] instead to integrate it directly.
Example automation with Heyy integration
Select Watch New Contacts trigger from Heyy - this will be a starting point in your automation. Whenever event happens in Heyy, workflow will start[7] from Watch New Contacts node.
Search for Add Labels to a Contact, connect it as the next step of integration sequence. You can use filters between Watch New Contacts and Add Labels to a Contact, so only important data pass from Watch New Contacts to the next step. WEXTL gives you full control over the process of Heyy automation. All parts of workflow are visible on the canvas[4].
Heyy on WEXTL has 73 modules for combining communication automations. Explore Heyy documentation for more.
- HeyyWatch New Contacts
- EZ TextingPerforms action
OR
- EZ TextingTriggers
- HeyyAdd Labels to a Contact
Frequently asked questions
Common questions about automating Heyy in your workflows.
What triggers does Heyy support?
Heyy has 3 triggers, including "Watch Events (Instant)", "Watch New Chats", and "Watch New Contacts". Triggers are start points of the workflow, and automations may start from them.
What actions can I run in Heyy?
Integration has 70 actions, including "Get a Campaign", "Get a Channel", and "Get a Chat", and more. Refer to our Heyy Documentation for detailed inputs and outputs.
Do I need to write code to build automations?
No. The 72 Heyy modules, like "Get a Campaign", are forms on the canvas: pick a field, map data from an earlier step. Code is optional[4].
Is the integration secure?
Yes. You fill in the Heyy credential once. WEXTL encrypts it at rest, and only your team can use it.
How does WEXTL integrate with Heyy?
Through the official Heyy API: 72 modules, plus "Make an API Call" for any endpoint they don't cover[3].
Can I use webhooks with Heyy?
Yes. "Watch Events (Instant)" is instant: Heyy pushes each event, so there is no polling delay.
Why use WEXTL platform for Heyy automation?
WEXTL is an AI-first visual canvas: describe the Heyy flow in plain words and AI wires the nodes[4].
References
List of sources used to gather information about the Heyy integration.
- Heyy integration source code, module specs and credentials implementation.
- Internal Heyy integration documentation, structured input and output parameters, scopes, and authentication methods.
- Official Heyy vendor API documentation, used to verify field meanings, authentication flows, and anything our own specs don't fully capture.
- WEXTL® Visual Workflow Builder, anonymized data from our technical support team.
- WEXTL® Apps Library
- WEXTL® Heyy App Documentation
- WEXTL® Workflow Scheduler
- WEXTL® HTTP node documentation
How we write and maintain Heyy app documentation
Explore how WEXTL® crafted Heyy integration page documentation. Used sources, the role of AI, and how the team validates the result.





















