Skip to main content

Action Nodes

Automate actions in Superchat – from contact management to HTTP requests

Mika Hally avatar
Written by Mika Hally
Updated today

Action nodes execute actions - from simple changes to contacts and conversations to complex integrations with external systems.

Contact actions

Edit contact

Edit and update contact attributes - both system attributes (first name, last name, email, phone) as well as all custom contact attributes.

Actions by data type

Text

  • Set value

  • Reset

Number

  • Set value

  • Increase by

  • Decrease by

  • Reset

Single-Select

  • Set value

  • Reset

Multi-Select

  • Overwrite

  • Add

  • Remove

  • Reset

Date & Date / Time

  • Set value

  • Reset

Enter values:

  • Static: Enter value directly

  • Variable: Click variable icon and assign variable (e.g. response from "Ask question" node). Important: The data type of the variable must match the attribute - for example, a variable of type number cannot be assigned to an email attribute.

Special feature for email and phone number:

A contact has only ONE primary email and phone number - this is used for automations, campaigns and all communication. The contact can have additional emails and numbers, these are only for documentation purposes.

Toggle "Set as primary email address":

  • Activated: New email will be set as primary (if possible)

  • Radio "Existing email addresses remain": If contact already has an email AND conversation exists via this email → Primary can NOT be updated, new email will only be added as secondary

Common use cases:

  • Save email from "Ask question" node into contact attribute

  • Survey responses in custom contact attributes

  • Record preferences and interests

  • Record increase in number of support requests in a contact attribute

Important concept - saving data for other automations:

Use "Edit contact" to save information in contact attributes that you can later use in other automations with filters/conditions.

System variable "Current date/time" is particularly important:

Create a custom contact attribute of type "Date / Time" and save timestamps there for later timing logic.

Examples:

Timing-based routing logic

  • Contact attribute "Last manual processing" → Set to "Current date / time" when user marks conversation as completed (Trigger: Conversation manually marked as completed → Edit contact)

  • Other automation filters: If less than 30 min ago → Not to AI agent, but let human continue working

Status tracking

  • Attribute "Lead status", "Purchase interest", "Support level"

  • Other automations filter based on this for different flows

The principle:

Save data in contact attributes (especially timestamps with system variables) to use them later in other automations for intelligent filter and routing logic. This way you build complex, context-dependent automation flows.

Update contact list

Update contact lists of the selected contact.

Actions:

  • Overwrite

  • Add

  • Remove

  • Reset

Works exactly like update label - only for contact lists instead of conversation labels.

Use cases:

  • Automate newsletter opt-in / opt-out

  • VIP list based on purchase behavior

  • Segmentation by interests

Delete contact

Deletes the contact permanently.

Important - No follow-up path possible:

No further path can follow after this node. As soon as the contact is deleted, the automation ends automatically - the contact no longer exists.

Use case: Automate GDPR requests

Conversation actions

Update label

Update labels of the selected conversation.

Actions:

  • Remove

  • Add

  • Overwrite

  • Reset

Use cases:

  • Automatic tagging after keyword detection

  • Set status labels (e.g. "Processed", "Waiting for response")

  • Labels based on filters/conditions

Assign conversation

Assigns the conversation to one or more users.

Settings:

1. Assign specific user:

  • Then you select the user or users to be assigned

2. Assign any user:

  • In the next step: Select rule

    • Round Robin - Distributes conversations evenly in rotation

    • Workload - Distributes based on current workload (who has fewer open conversations)

  • In the last step: Select pool of users

3. Reset assignment:

  • Removes all current assignments from the conversation

Important - Inbox access:

The selected users must have access to the inbox where the conversation is located. If a user does not have access to the inbox, the assignment will not take place.

Common use cases:

  • Automatically distribute support tickets to team

  • Assign VIP customers to specific account manager

  • Assign to human team after AI agent handover

Mark conversation as spam

Marks the conversation as spam. No configuration needed.

Use case:

  • Detect spam keywords → Mark as spam

Mark conversation as done

Marks the conversation as completed. No configuration needed.

Use case:

  • Automatically mark as completed at the end of successful flows for a clean inbox.

Delete conversation

Deletes the conversation.

Settings:

  • Move to trash: Conversation will be automatically deleted after 60 days

  • Delete permanently: Immediately and irreversibly

Use case:

  • Automatically clean up spam or test conversations

Move conversation into another inbox

Moves the conversation to another inbox.

Use cases:

  • Team routing by topic (Technical → Support inbox, Sales → Sales inbox)

  • Team routing by location (Berlin → Munich, London → Manchester)

Create note

Creates a note in the conversation.

Common use cases:

  • Team updates: Note for the team when automation reaches certain phase: "AI agent couldn't help, manual review needed"

  • Data summary: Multiple "Ask question" nodes → Create note with all collected variables as summary

  • Documentation for follow-ups: Record what happened in the automation for later manual processing.

Automation control actions

End other automation

Ends other running automations on this contact.

Important for automation hierarchy:

Control which automations are allowed to run simultaneously.

Use cases:

  • VIP flow starts → End standard support flow (prevents duplicate messages)

  • Clean handovers between flows

  • Prevent spam when multiple triggers fire simultaneously

Start other automation

Starts another automation. With this node the current automation ends.

Settings:

Select automation:

Only automations with manual trigger can be started. The list only shows automations that are published, active and have the trigger "Manually triggered".

Input fields:

If the target automation has input fields in the manual trigger, they must be filled in here. All fields can be populated with variables.

Use cases:

  • Automation chaining (Automation 1 collects data → Starts Automation 2 that processes)

  • Conditional branching (VIP → Start VIP onboarding, Standard → Start standard flow)

  • Pass data via input fields for personalized follow-up flow

Integration actions

Send HTTP request

Send and receive data from external systems via HTTP requests.

Settings:

Method:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

URL:

Enter URL - can be dynamic with variables (variable icon available)

Additional request elements (optional):

  • Add header - Custom headers for the request

  • Add body - Request body (e.g. send JSON data)

  • Add authentication - Select type:

    • API Key

    • Basic Auth

    • Bearer Token

Response:

The node shows the status (e.g. "Successful request - 200") and the response data in the body.

Test function:

Test the request directly in the node before you publish the automation.

Saved variables - Very important:

You can save specific fields from the response as variables:

  • NAME: Name the variable (e.g. "order_number")

  • JSON PATH: Which field from the response (e.g. $.order_id, $.status, $.customer.name)

  • These variables can then be used in later nodes

Common use cases for HTTP requests

  • Fetch data for AI agent:
    GET request to your database → Retrieve customer history, open orders, support tickets → Pass as context to AI agent for personalized support with full context

  • External system sync:
    Automation collects data via "Ask question" nodes → At the end POST request to CRM/ERP/accounting system → Data automatically synchronized without manual copy-paste

  • Personalized messages:
    GET request at the beginning of automation → Retrieve customer data (name, last order, preferences, birthday) → Use as variables in messages for highly personalized copy

  • Database operations:

    • GET: Query customer data

    • POST: Create new entries (lead, ticket, order)

    • PUT/PATCH: Update existing data

    • DELETE: Delete data (e.g. GDPR requests)

  • Custom workflows:

    • Make.com / Zapier: Trigger complex multi-tool workflows

    • Own APIs: Connect with internal systems

    • Webhooks: Trigger other automations in external tools

  • Notification systems:

    • Slack: Notify team of important events (VIP customer writes, high-value deal)

    • Discord: Community notifications

    • Microsoft Teams: Sales alerts

  • CRM updates:

    • HubSpot: Update contact properties, create deals, log activities

    • Salesforce: Sync leads, update opportunities

    • Pipedrive: Create persons, update deals

  • E-commerce integration:

    • Shopify: Retrieve order status, update inventory, create orders

    • WooCommerce: Check product availability, sync customer data

    • Stripe: Retrieve payment status, create payment links

Send conversion event to Meta

Send conversion events to the Meta Conversion API to improve your ad performance. Ideal for click-to-WhatsApp ads.

Prerequisite:

Before you can use this node, the Conversions API must be activated for your WhatsApp channel:

  1. Go to Settings → Inboxes

  2. Select your WhatsApp channel

  3. Check if the Conversions API tag is displayed in the top right

  4. If not activated: Click the button in the blue banner and connect your Facebook Business account

Settings:

Select event type:

Event type

When to use

Added to Shopping Cart

Product was added to cart

Application Submitted

Application for product or service submitted

Appointment Scheduled

Appointment successfully booked

Checkout Initiated

Checkout process started

Content Viewed

Important content viewed (e.g. product page)

Inbox Requested

Inbox or contact request submitted

Lead Submitted

New lead captured (e.g. form filled out)

Payment Information Added

Payment information provided or saved

Registration Completed

Registration or sign-up completed

Search Conducted

Search for product or service performed

Test Started

Free trial or test phase started

Select lead identification:

Meta must be able to identify the contact to assign the conversion event to the correct user.

Option 1: Click-to-WhatsApp ad ID

  • Most precise user assignment

  • Available for all businesses and phone numbers outside the EEA and the United Kingdom

  • Tip: Add a fallback identification if you use multiple channels from different countries

Option 2: Custom lead identification

  • Less precise user assignment

  • Available for businesses from all countries (except China and Cuba)

  • Important for EEA and United Kingdom: You must explicitly obtain user consent to share conversion events with Meta

Additional contact data (optional):

You can send additional contact attributes that Meta uses for ad optimization. Data that Meta requires in hashed form is automatically hashed by Superchat before sending.

Common use case:

  1. Trigger: "New incoming conversation" (from click-to-WhatsApp ad)

  2. Node "Ask question": Collect customer data

  3. Node "Send conversion event to Meta": Event "Lead Submitted"

  4. Node "AI agent" or further processing

You can use multiple conversion event nodes in one automation - one for each step in the funnel (e.g. first "Lead Submitted", later "Appointment Scheduled").

Did this answer your question?