Superchat icon

Superchat

Retrieve data from the Superchat API

Actions18

Overview

This node allows sending an email message through the Superchat platform. It is designed to send emails from a specified channel, either to an email address or a contact identified by their ID within Superchat. The node supports both HTML and plain text content for the email body, as well as optional attachments.

Common scenarios where this node is beneficial include:

  • Automating customer support responses by sending templated emails.
  • Sending notifications or updates to contacts managed in Superchat.
  • Integrating email communication into broader workflows that involve messaging and contact management.

Practical example:

  • A workflow triggers when a new support ticket is created, then uses this node to send a confirmation email to the customer with details about their ticket.

Properties

Name Meaning
Sender Name The name displayed as the sender beneath the message in Superchat (e.g., "Sent from n8n").
To (Email Address or Contact ID) The recipient's email address or their unique Contact ID in Superchat.
Channel ID The identifier of the channel from which the email will be sent. Can be provided directly or selected from a searchable list.
Subject The subject line of the email. Optional but recommended for clarity.
HTML The HTML content of the email body. At least one of HTML or Text must be provided.
Text The plain text content of the email body. At least one of HTML or Text must be provided.
Attachments (File IDs) Optional files to attach to the email. Files can be specified by their IDs, either entered manually or selected from a searchable list.

Output

The node outputs a JSON array containing the response from the Superchat API after attempting to send the email. This typically includes information about the success or failure of the operation and any metadata related to the sent message.

If attachments are included, they are referenced by their file IDs; however, the node does not output binary data itself.

Dependencies

  • Requires an active connection to the Superchat API via an API key credential configured in n8n.
  • The node depends on the availability of channels and files within the Superchat environment to send messages and attach files.
  • The "Channel ID" and "Attachments" properties support resource locators with search capabilities, relying on Superchat's API endpoints for listing channels and files.

Troubleshooting

  • Missing required fields: Ensure that at least one of the "HTML" or "Text" fields is filled; otherwise, the node will not send the email.
  • Invalid recipient: If the "To" field is neither a valid email address nor a recognized Contact ID, the API call may fail.
  • Channel not found: Providing an incorrect or non-existent Channel ID will cause the send operation to fail.
  • Attachment issues: Specifying invalid or inaccessible file IDs for attachments may result in errors.
  • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • API rate limits or downtime: Temporary failures might occur if the Superchat API is unavailable or rate-limited.

Links and References

Discussion