Direct7 Integration with n8n
Send SMS and WhatsApp messages, run number look-ups, and track delivery status — all from your n8n workflows.
Direct7 is now available as an official node in n8n Cloud. This guide walks you through every capability of the node — sending SMS, sending WhatsApp messages (text, media, contacts, location, interactive, and templates), checking number look-ups, and retrieving message status reports — so your team can start building workflows right away.
Getting Started
Step 1: Add the Direct7 node and connect your accountWe are pleased to invite you to a demonstration of the Direct7 integration with the n8n platform.
Details:
Add the node: In any workflow, click the + button, search for "Direct7," and drag it onto the canvas.
Create a credential: Click Create New Credential on the node and enter your Direct7 API key/token.
API Key: Found in your Direct7 dashboard under API settings — copy it exactly as shown.
Test the connection: Use the Test button on the credential dialog to confirm n8n can reach the Direct7 API before continuing.
Choose a Resource: Once connected, use the node's Resource dropdown to pick what you want to work with — Message, WhatsApp, Lookup, or Status/Reports.
Sending SMS Messages
Step 1: Configure the Send SMS operation
Details:
Resource: Select "Message."
Operation: Select "Send SMS."
Recipient Number: Enter the destination number in international format (e.g.
+9471XXXXXXX).Sender ID: Choose your approved originator/sender ID from the dropdown, or type it if it's a free-text field.
Message: Enter the SMS text. You can use an expression, e.g.
={{ $json.message }}, to send dynamic content from earlier nodes.
Sending WhatsApp Messages
The Direct7 node supports six WhatsApp message types: Text, Media, Contacts, Location, Interactive, and Template. All of them share the same starting point below, then branch based on the message type you choose.
Step 1: Select the WhatsApp resource and message type
Details:
Resource: Select "WhatsApp."
Operation: Select "Send Message."
Message Type: Choose the type of WhatsApp message you want to send:
Text — a plain chat message.
Media — an image, video, audio clip, document, or sticker.
Contacts — one or more shared contact cards.
Location — a pinned map location.
Interactive — buttons or a selectable list.
Template — a pre-approved Meta template message.
To: Enter the recipient's WhatsApp number in international format for every message type below.
Sending a Text Message
Details:
Body: Type the message text, or use an expression to pull it from a previous node.
Preview URL (optional): Toggle this on if your message contains a link and you want WhatsApp to render a link preview.
Sending a Media Message
Details:
Media Type: Choose Image, Video, Audio, Document, or Sticker.
Media Source: Provide either:
Media URL — a publicly reachable link to the file, or
Media ID — an ID from a file already uploaded to Direct7's media store.
Caption (optional): Add a short caption — supported for images, videos, and documents.
Filename: For Document type, set the filename shown to the recipient (e.g.
invoice.pdf).
Sending a Contact Card
Details:
Contact Name: Enter the contact's first and last name.
Phone Numbers: Add one or more numbers for the contact, each with an optional type label (Home, Work, Mobile).
Additional Fields (optional): Expand to add extra details:
Organization — company and job title.
Email — one or more email addresses.
Address — street, city, and country.
Sending a Location
Details:
Latitude / Longitude: Enter the coordinates of the point you want to share.
Name (optional): A short label for the place, e.g. "Office HQ."
Address (optional): A readable address to display alongside the pin.
Sending an Interactive Message
Details:
Interactive Type: Choose Button (up to 3 quick-reply buttons) or List (a scrollable menu of options).
Header / Body / Footer: Body text is required; header and footer are optional.
Action: Depending on the type chosen above:
Buttons — add each button's display text and a unique ID used to identify the reply.
List — add one or more Sections, each containing Rows with a title, optional description, and a unique row ID.
Sending a Template Message
Details:
Template Name: Select from templates already approved in your Direct7/Meta account.
Language: Choose the language variant of the approved template.
Components (optional): Fill in placeholders the template was built with:
Header parameters — for templates with a dynamic image, video, or text header.
Body parameters — the variable values that fill in
{{1}},{{2}}, etc. in the template body.Button parameters — dynamic values for call-to-action or quick-reply buttons, if the template uses them.
Number Look-Up
Step 1: Configure the Look-Up operation
Details:
Resource: Select "Lookup."
Operation: Select "Number Lookup."
Phone Number: Enter the number to check, in international format.
Response fields returned: A successful look-up typically returns:
Network / Operator — the carrier currently serving the number.
Country — the number's country of origin.
Number Status — whether the number is active, reachable, or invalid.
Ported status — whether the number has been ported to another carrier, if available.
Checking Status Reports
Step 1: Retrieve delivery status for a sent message
Details:
Resource: Select "Status" (or "Reports," depending on your node version).
Operation: Select "Get Message Status."
Message ID: Enter the ID returned when the message was originally sent — capture this from the previous node's output using an expression such as
={{ $json.messageId }}.Status values returned: Depending on the channel, expect one of the following:
Pending / Submitted — accepted by Direct7, not yet delivered.
Delivered — successfully delivered to the handset.
Read — WhatsApp only: the recipient has opened the message.
Failed / Undelivered — delivery was unsuccessful, usually with an error code.
Last updated