Description

n8n-nodes-sendseven

This is an n8n community node for SendSeven – a unified messaging API platform enabling multi-channel messaging through WhatsApp, Telegram, SMS, Email, Messenger, Instagram, and more.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm Installation

npm install n8n-nodes-sendseven

Manual Installation

1. Clone this repository
2. Run npm install
3. Run npm run build
4. Copy the dist folder to your n8n custom nodes directory

Operations

SendSeven Node (Actions)

#### Message

• Send: Send a message through any channel (WhatsApp, Telegram, SMS, Email, etc.)

– Supports attachments: provide a comma-separated list of attachment UUIDs (from the Attachment resource) in the Attachment IDs field. These map to the attachments array of POST /messages. Raw URLs are not accepted — upload first.

#### Contact

• Create: Create a new contact
• Update: Update an existing contact (name, email, phone, avatar URL)
• Get: Get a contact by ID
• Delete: Delete a contact (GDPR delete — conversations anonymized, billing preserved)
• Search: Search contacts by name, email, or phone
• Add Tag: Add a tag to a contact
• Remove Tag: Remove a tag from a contact
• Set Custom Field: Set a custom field value on a contact. The Custom Field dropdown is populated from your tenant’s field definitions (GET /custom-fields); the value is written via POST /contacts/{id}/fields/{field_id}.
• Add Method: Add a contact method (platform ID). Method types: phone, email, whatsappid, telegramid, messengerid, instagramid. For messengerid/instagramid a Channel must be selected (these IDs are page-scoped).
• Delete Method: Delete a contact method by its method ID.

#### Conversation

• Get: Get a conversation by ID
• Search: Search conversations by contact, status, or channel type
• Close: Close a conversation
• Assign: Assign a conversation to a team member

#### WhatsApp Template

• Send: Send a pre-approved WhatsApp template message. Provide at least one recipient (Contact ID is no longer mandatory):

– Contact ID — a contact; uses its first WhatsApp method, phone as fallback.
– WhatsApp ID — a phone number without a leading + (stripped automatically) or an alphanumeric WhatsApp ID; matches an existing contact or creates one (ideal for stateless integrations).
– Contact Method ID (Additional Options) — target a specific WhatsApp number when a contact has several; must be a whatsapp_id-type method. If Contact ID is also set it must name the same contact.
– Conversation ID (Additional Options) — send within an existing WhatsApp conversation.

Additional Options also expose Channel ID (disambiguates a template referenced by NAME across channels, and selects the sending channel when only a WhatsApp ID is given), Language (Meta locale code such as en, de, enUS, ptBR — needed only when a template name exists in multiple languages; auto-resolved from the contact’s preferred language otherwise), Header Media URL, Header Document Filename, and Variable Values (JSON).

• List: List available WhatsApp templates

#### Attachment

• Upload: Upload a binary file (from an incoming binary property such as the output of an HTTP/Read-Binary node) as a multipart POST /attachments/upload. Returns the attachment id.
• Upload from URL: Fetch a public http(s) URL server-side via POST /attachments/from-url and store it. Returns the attachment id. Note: the URL-fetch MIME allowlist is stricter than direct upload (images, mp4/mov/webm, common audio, pdf).

##### Sending a message with an attachment

Chain two nodes:

1. Attachment → Upload (or Upload from URL) — produces an attachment object whose id is the attachment UUID.
2. Message → Send — set the Attachment IDs field to an expression referencing the previous node’s id (e.g. {{ $json.id }}), or a comma-separated list of several UUIDs. The node passes these into the attachments array of POST /messages, and the channel adapter renders them by content type (e.g. WhatsApp image/document, email attachment).

SendSeven Trigger Node (Webhooks)

Listen for real-time events:

• Message Received: Triggers when a new inbound message is received
• Message Sent: Triggers when an outbound message is delivered
• Message Delivered: Triggers when message delivery is confirmed
• Message Failed: Triggers when a message fails to send
• Message Read: Triggers when a message read receipt is received
• Email Received: Triggers when an inbound email is received
• Email Sent: Triggers when an outbound email is sent
• Email Delivered: Triggers when an email delivery is confirmed
• Email Bounced: Triggers when an email bounces
• Email Opened: Triggers when an email is opened
• Conversation Created: Triggers when a new conversation starts
• Conversation Closed: Triggers when a conversation is closed
• Conversation Assigned: Triggers when a conversation is assigned to an agent
• Conversation Reopened: Triggers when a conversation is reopened
• Contact Created: Triggers when a new contact is created
• Contact Updated: Triggers when a contact is updated
• Contact Deleted: Triggers when a contact is deleted
• Link Clicked: Triggers when a tracked link is clicked
• Campaign Sent: Triggers when a campaign completes sending

Authentication

This node supports two authentication methods:

API Key (Recommended for most users)

1. Log in to your SendSeven account at https://app.sendseven.com
2. Navigate to Settings > API Tokens
3. Create a new API token with the required scopes
4. Copy the token (format: s7_xxxxxxxxxxxx)
5. In n8n, add a new credential of type “SendSeven API”
6. Paste your API token

OAuth2 (For advanced integrations)

1. Log in to your SendSeven account
2. Navigate to Settings > OAuth Apps
3. Create a new OAuth application
4. Configure the redirect URI to match your n8n instance
5. In n8n, add a new credential of type “SendSeven OAuth2 API”
6. Complete the OAuth2 authorization flow

Required Scopes

Different operations require different scopes:

| Operation | Required Scopes |
|———–|—————–|
| Send Message | messages:create |
| Upload Attachment | messages:create |
| Read Messages | messages:read |
| Create/Update Contact | contacts:create, contacts:update |
| Delete Contact / Add or Delete Method / Set Custom Field | contacts:update (delete: contacts:delete) |
| Read Contacts | contacts:read |
| Read Custom Field Definitions | settings:read |
| Manage Tags | tags:read |
| Read Conversations | conversations:read |
| Manage Conversations | conversations:update |
| Webhooks | webhooks:create, webhooks:read, webhooks:delete |
| Knowledge Base | knowledge_base:read |
| Team Members | team:read |

Example Workflows

Send WhatsApp notification on new CRM lead

1. Add a trigger from your CRM (e.g., HubSpot, Salesforce)
2. Add SendSeven node with “WhatsApp Template > Send” operation
3. Map the lead data to template variables

Log support conversations to spreadsheet

1. Add SendSeven Trigger with “Conversation Closed” event
2. Add Google Sheets node to append row
3. Map conversation data to spreadsheet columns

Auto-respond to incoming messages

1. Add SendSeven Trigger with “Message Received” event
2. Add IF node to check message content
3. Add SendSeven node with “Message > Send” to reply

Resources

• SendSeven Documentation
• SendSeven API Reference
• n8n Community Nodes

Support

• Email: dev@sendseven.com
• Documentation: https://docs.sendseven.com/guides/integrations/n8n
• Status: https://status.sendseven.com

License

MIT License – see LICENSE file for details.

Changelog

1.2.4

• Republished from GitHub Actions with an npm provenance statement (required for n8n verified community node review). No functional changes from 1.2.3.
• Normalized repository.url to the git+https://...git form required for provenance verification.

1.2.0

• BREAKING FIX (custom fields): Custom fields are no longer sent in the contact Create/Update body — the backend silently dropped them (they are not contact-body fields). The dead Custom Fields JSON option was removed from Contact → Create. Use the new Contact → Set Custom Field operation, which resolves the field definition via GET /custom-fields (loadOptions dropdown) and writes the value via POST /contacts/{id}/fields/{field_id}. Action required: any workflow that relied on the old Custom Fields create/update option must switch to Set Custom Field — the old option had no effect.
• Added Attachment resource:

– Upload — binary input → multipart POST /attachments/upload (file part file, optional message_id).
– Upload from URL — POST /attachments/from-url (stricter MIME allowlist).
– Both return the attachment id for downstream use.

• Message → Send: added an Attachment IDs field (comma-separated attachment UUIDs) wired into the attachments array of POST /messages.
• Added Contact → Delete (DELETE /contacts/{id}, GDPR delete).
• Added Contact → Add Method / Delete Method (POST/DELETE /contacts/{id}/methods). Channel selection is shown conditionally and required for messengerid/instagramid.
• Added Contact → Remove Tag (DELETE /contacts/{id}/tags/{tag_id}).
• Added getCustomFields loadOptions helper and a sendSevenApiRequestFormData helper for authenticated multipart uploads.

1.1.0

• BREAKING: Webhook endpoint path changed from /webhooks to /webhook-endpoints
• BREAKING: Conversation close now uses POST (was PUT) with notes field (was resolution_note)
• BREAKING: Conversation assign now uses POST with user_id in URL path (was PUT with body)
• BREAKING: Removed pending conversation status (only open and closed remain)
• Added 3 message addressing modes: Recipient+Channel, Conversation ID, Contact+Channel
• Added contact_methods support for contact creation
• Updated contact fields: removed firstName, lastName, company, notes; added contactMethods, language, isBlocked
• Updated conversation fields: assigneduserid (was assignedtouserid), added needsreply, islivechat, isemail, subject; removed messagecount, unread_count
• Updated contact update to only accept name, email, phone, avatar_url
• Added close options: notes and summarize fields
• Added conversation search filter: needs_reply
• Updated webhook events: added message.delivered, message.failed, message.read, email.*, conversation.assigned, conversation.reopened, contact.deleted, link.clicked; removed message.status_updated, ticket.created, ticket.closed
• Updated OAuth2 scopes: replaced webhooks:update with webhooks:create/webhooks:delete; added knowledge_base:read, team:read

1.0.0

• Initial release
• Actions: Send Message, Create/Update/Get/Search Contact, Add Tag, Get/Search Conversation, Close/Assign Conversation, Send WhatsApp Template
• Triggers: Message Received/Sent, Conversation Created/Closed, Contact Created/Updated, Ticket Created/Closed, Campaign Sent
• Authentication: API Key and OAuth2 support