n8n-nodes-dinastiapi

This is an n8n community node that provides a complete integration with DinastiAPI - a multi-user and multi-device REST API for WhatsApp.

DinastiAPI implements a robust WhatsApp Web API that allows you to send and receive messages, manage groups, handle media files, and much more through a simple REST interface.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

- Installation
- Operations
- Credentials
- Nodes Overview
- Message Configuration Parameters
- Usage Examples
- Features
- Error Handling
- Compatibility
- Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

$3

1. In n8n, go to Settings > Community Nodes
2. Click Install a community node
3. Enter n8n-nodes-dinastiapi
4. Click Install

$3

``bash
npm install n8n-nodes-dinastiapi
`

Operations

This package includes 11 specialized nodes, each focused on specific WhatsApp operations:

$3

#### Core Parameters
- Message ID - Custom message identifier for tracking (auto-generated if not provided)
- Presence Simulation - Simulate typing/recording indicators (0-30,000ms)
- Text/Documents: Shows typing indicator
- Audio/Video: Shows recording indicator
- Example: 2000 for 2-second typing simulation

#### WhatsApp Features
- Message Duration - Disappearing messages with expiration times:
- 0 - No expiration (default)
- 86400 - 24 hours
- 604800 - 7 days
- 7776000 - 90 days

- View Once - Single-view messages (image/video/audio only)
- true - Message disappears after single view
- false - Normal message (default)

- Link Preview - Automatic URL preview for text messages
- true - Generate rich link previews
- false - Plain text URLs (default)

#### Message Context & Threading
- Forward Message - Mark message as forwarded
- isForwarded: true - Shows "Forwarded" label

- Reply To Message - Thread replies to specific messages
`json
{
"contextInfo": {
"context": [{
"stanzaId": "MESSAGE_ID_TO_REPLY_TO",
"participant": "5491155553935@s.whatsapp.net"
}]
}
}
`

- Forward Information - Enhanced forwarding structure
`json
{
"forwardInfo": {
"forward": [{
"isForwarded": true
}]
}
}
`

#### Mention System
- Specific Users - Mention individual users
`json
{
"mentions": {
"mentionConfig": [{
"type": "specific",
"jids": "5491155553934@s.whatsapp.net,5491155553935@s.whatsapp.net"
}]
}
}
`

- All Group Members - Mention everyone in group
`json
{
"mentions": {
"mentionConfig": [{
"type": "all"
}]
}
}
`

$3

All messaging operations support multiple recipient types:

- Phone Numbers: 5491155553934 (automatically formatted to @s.whatsapp.net)
- Groups: 120363312246943103@g.us
- Newsletters: 120363025246943103@newsletter
- LIDs: user@lid

$3

All media types (image, audio, video, document, sticker) support three source types:

#### Binary Data
`json
{
"imageSource": "binary",
"binaryProperty": "data"
}
`

#### Base64 Encoding
`json
{
"imageSource": "base64",
"imageBase64": "data:image/jpeg;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}
`

#### URL Sources
`json
{
"imageSource": "url",
"imageUrl": "https://example.com/image.jpg"
}
`

$3

#### Text Messages
`json
{
"messageType": "text",
"phone": "5491155553934",
"body": "Hello World!",
"additionalOptions": {
"linkPreview": true,
"presence": 2000
}
}
`

#### Image Messages
`json
{
"messageType": "image",
"phone": "5491155553934",
"imageSource": "url",
"imageUrl": "https://example.com/image.jpg",
"caption": "Check this out!",
"additionalOptions": {
"viewOnce": true,
"presence": 1500
}
}
`

#### Audio Messages
`json
{
"messageType": "audio",
"phone": "5491155553934",
"audioSource": "url",
"audioUrl": "https://example.com/audio.ogg",
"additionalOptions": {
"presence": 3000
}
}
`

#### Video Messages
`json
{
"messageType": "video",
"phone": "5491155553934",
"videoSource": "url",
"videoUrl": "https://example.com/video.mp4",
"caption": "Amazing video!",
"additionalOptions": {
"viewOnce": true,
"duration": 86400
}
}
`

#### Document Messages
`json
{
"messageType": "document",
"phone": "5491155553934",
"documentSource": "url",
"documentUrl": "https://example.com/document.pdf",
"fileName": "report.pdf",
"additionalOptions": {
"presence": 2500
}
}
`

#### Location Messages
`json
{
"messageType": "location",
"phone": "5491155553934",
"latitude": 48.858370,
"longitude": 2.294481,
"locationName": "Eiffel Tower"
}
`

#### Contact Messages
`json
{
"messageType": "contact",
"phone": "5491155553934",
"contactName": "John Doe",
"vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nTEL:+1234567890\nEND:VCARD"
}
`

#### Button Messages
`json
{
"messageType": "buttons",
"phone": "5491155553934",
"body": "Choose an option:",
"additionalOptions": {
"mentions": {
"mentionConfig": [{
"type": "all"
}]
}
}
}
`

#### List Messages
`json
{
"messageType": "list",
"phone": "120363312246943103@g.us",
"buttonText": "Choose Service",
"description": "Select the service you need",
"topText": "Available Services",
"footerText": "Powered by AI",
"listItems": {
"item": [
{
"title": "Technical Support",
"desc": "Get help with technical issues",
"rowId": "tech_support"
},
{
"title": "Sales Information",
"desc": "Learn about our products",
"rowId": "sales_info"
}
]
}
}
`

#### Poll Messages
`json
{
"messageType": "poll",
"phone": "120363312246943103@g.us",
"pollHeader": "Which feature should we prioritize?",
"pollOptions": "AI Chat,Voice Messages,File Sharing,Video Calls"
}
`

#### Link Messages
`json
{
"messageType": "link",
"phone": "5491155553934",
"link": "https://example.com",
"linkCaption": "Check out this amazing website!",
"additionalOptions": {
"presence": 1000
}
}
`

#### Sticker Messages
`json
{
"messageType": "sticker",
"phone": "5491155553934",
"stickerSource": "url",
"stickerUrl": "https://example.com/sticker.webp"
}
`

$3

`json
{
"messageType": "image",
"phone": "120363312246943103@g.us",
"imageSource": "url",
"imageUrl": "https://example.com/photo.jpg",
"caption": "Team photo from today's meeting! @everyone",
"additionalOptions": {
"id": "custom_msg_001",
"presence": 2000,
"duration": 604800,
"viewOnce": false,
"isForwarded": true,
"contextInfo": {
"context": [{
"stanzaId": "PREVIOUS_MESSAGE_ID",
"participant": "5491155553935@s.whatsapp.net"
}]
},
"mentions": {
"mentionConfig": [{
"type": "all"
}]
},
"forwardInfo": {
"forward": [{
"isForwarded": true
}]
}
}
}
`

$3

#### Presence Simulation
- Text Messages: Use 1000-3000ms for natural typing simulation
- Audio Messages: Use 2000-5000ms for recording simulation
- Long Messages: Calculate ~100ms per word for realistic timing
- Groups: Keep under 2000ms to avoid spam appearance

#### Message Duration
- Sensitive Data: Use 24 hours (86400) for confidential information
- Temporary Messages: Use 7 days (604800) for time-sensitive content
- Compliance: Use 90 days (7776000) for audit trail requirements

#### View Once Messages
- Security: Use for passwords, sensitive documents, private photos
- Business: Use for confidential reports, temporary access codes
- Support: Supported only for image, video, and audio messages

#### Mentions
- Groups: Use type: "all" sparingly to avoid notification fatigue
- Specific: Always include proper JID format (@s.whatsapp.net)
- Mixed: You can combine specific mentions with other message features

#### Media Sources
- Performance: URL sources are fastest and reduce payload size
- Reliability: Binary data is most reliable for critical media
- Compatibility: Base64 offers good balance of reliability and performance

#### Error Handling
- Continue on Fail: Enable for batch operations to process all items
- Validation: Always validate phone numbers and JIDs before sending
- Timeouts: Set appropriate timeouts for media-heavy operations

Usage Examples

$3

`javascript
// Using DinastiAPI Message node
{
"messageType": "text",
"phone": "5491155553934",
"body": "Hello from n8n!"
}
`

$3

`javascript
// Using DinastiAPI Message node
{
"messageType": "image",
"phone": "5491155553934",
"imageSource": "binary",
"binaryProperty": "data",
"caption": "Check out this image!"
}
`

$3

`javascript
// Using DinastiAPI Group node
{
"operation": "create",
"groupName": "My n8n Group",
"participants": "5491155553934,5491155553935"
}
`

$3

`javascript
// Using DinastiAPI Trigger node - Basic setup
{
"events": ["Message", "ReadReceipt"],
"filters": {
"messageType": "text",
"isGroup": "false"
}
}
`

$3

`javascript
// Complete trigger setup with all features
{
"events": ["Message"],
"filters": {
"fromPhone": "5521971532700@s.whatsapp.net",
"chatId": "120363312246943103@g.us",
"messageType": "media",
"containsText": "urgent",
"isGroup": "true",
"isFromMe": "false",
"tokenFilter": "setupautomatizado"
},
"options": {
"simplifyOutput": true,
"includeMediaData": true,
"parseMessageContent": true,
"includeRawData": false
}
}
`

$3

`javascript
// Simplified output for a text message
{
"eventType": "Message",
"token": "setupautomatizado",
"messageId": "A6BA5FB09055C47722F936C3FC74D98F",
"chat": "5521971532700@s.whatsapp.net",
"sender": "5521971532700@s.whatsapp.net",
"timestamp": "2025-05-28T06:47:26-03:00",
"messageType": "text",
"isFromMe": false,
"isGroup": false,
"pushName": "Guilherme Jansen",
"verifiedName": "Guilherme Jansen - Setup Automatizado",
"text": "Oi"
}
`

$3

`javascript
// Output for audio message with S3 and base64 data
{
"eventType": "Message",
"messageType": "ptt",
"audioUrl": "https://mmg.whatsapp.net/v/...",
"duration": 3,
"mimeType": "audio/ogg; codecs=opus",
"mediaBase64": "T2dnUwACAAAAAAAA...",
"mediaMimeType": "application/ogg",
"mediaFileName": "DB56752B6A203E5A96A2E533C4D0A7CF.oga",
"s3Data": {
"bucket": "evolution",
"key": "users/2fb8378b312c1d2dd127e094d9a99115/inbox/...",
"url": "https://s3.setupautomatizado.com.br/evolution/...",
"size": 8084
}
}
`

$3

`javascript
// Output for buttons message
{
"eventType": "Message",
"messageType": "buttons",
"text": "ESCOLHA O MENU!",
"buttons": [
{
"id": "81ad952f-1085-4d2c-a4b9-de228cfc4117",
"text": "SUPORTE",
"type": 1
},
{
"id": "a4767ccb-ded6-4edd-be6a-363972fdaa0f",
"text": "COMERCIAL",
"type": 1
},
{
"id": "8f72fd66-1e6f-48bd-a5b5-c509fcc5a9f1",
"text": "ATENDIMENTO",
"type": 1
}
]
}

// Output for list message
{
"eventType": "Message",
"messageType": "list",
"title": "",
"text": "",
"buttonText": "",
"sections": [
{
"title": "",
"rows": [
{
"id": "",
"title": "",
"description": ""
}
]
}
]
}
`

$3

`javascript
// Using DinastiAPI AI node - Perfect for AI workflows
{
"operation": "sendText",
"phoneNumber": "5491155553934",
"message": "Hello! This is an AI-generated response from n8n."
}
`

$3

`javascript
// Using DinastiAPI AI node with multiple items
[
{
"operation": "sendImage",
"phoneNumber": "5491155553934",
"imageSource": "url",
"imageUrl": "https://example.com/image1.jpg",
"caption": "AI Analysis Result 1"
},
{
"operation": "sendDocument",
"phoneNumber": "5491155553935",
"documentSource": "url",
"documentUrl": "https://example.com/report.pdf",
"fileName": "AI_Report.pdf",
"caption": "Generated Report"
}
]
`

$3

`javascript
// Send sticker for reactions
{
"operation": "sendSticker",
"phoneNumber": "5491155553934",
"stickerSource": "url",
"stickerUrl": "https://example.com/thumbs-up.webp"
}

// Send buttons for AI decision tree
{
"operation": "sendButtons",
"phoneNumber": "5491155553934",
"message": "How can I help you today?",
"additionalOptions": {
"mentions": {
"mentionConfig": [{
"type": "specific",
"jids": "5491155553934@s.whatsapp.net"
}]
}
}
}

// Send list for AI-generated menu
{
"operation": "sendList",
"phoneNumber": "120363312246943103@g.us",
"buttonText": "Choose Service",
"description": "Select the service you need",
"topText": "AI Assistant Services",
"footerText": "Powered by AI",
"listItems": {
"item": [
{
"title": "Technical Support",
"desc": "Get help with technical issues",
"rowId": "tech_support"
},
{
"title": "Sales Information",
"desc": "Learn about our products",
"rowId": "sales_info"
},
{
"title": "General Questions",
"desc": "Ask any general questions",
"rowId": "general_qa"
}
]
}
}

// Send poll for group decisions
{
"operation": "sendPoll",
"phoneNumber": "120363312246943103@g.us",
"pollHeader": "Which feature should we prioritize?",
"pollOptions": "AI Chat Enhancement,Voice Messages,File Sharing,Video Calls"
}
`

$3

`javascript
// Complete AI workflow with mentions and media
{
"operation": "sendVideo",
"phoneNumber": "5491155553934",
"videoSource": "base64",
"videoBase64": "data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc...",
"caption": "Here's your AI-generated tutorial video",
"additionalOptions": {
"id": "ai_tutorial_001",
"mentions": {
"mentionConfig": [{
"type": "all"
}]
}
}
}

// AI processing with binary data from previous nodes
{
"operation": "sendDocument",
"phoneNumber": "5491155553934",
"documentSource": "binary",
"documentBinaryProperty": "processed_report",
"fileName": "AI_Analysis_Report.pdf",
"caption": "Your personalized AI analysis is ready!"
}

// Get business profile information
{
"operation": "businessProfile",
"businessPhone": "5491155553934"
}

// Get privacy settings
{
"operation": "privacySettings"
}

// Update push name
{
"operation": "updatePushName",
"pushName": "João Silva - Updated"
}

// Get current status
{
"operation": "getMyStatus"
}

// Set new status
{
"operation": "setMyStatus",
"statusMessage": "Available for work! 🚀"
}

// AI Tools - Get business profile
{
"operation": "getBusinessProfile",
"businessPhoneNumber": "5491155553934"
}

// AI Tools - Get my status
{
"operation": "getMyStatus"
}
``

Error Handling

All nodes include comprehensive error handling:

- Automatic Retries - Failed requests are retried with exponential backoff
- Continue on Fail - Option to continue workflow execution on errors
- Detailed Error Messages - Clear error descriptions for debugging
- HTTP Status Codes - Proper status code handling
- Authentication Errors - No retry on authentication failures

Compatibility

- n8n Version: Minimum n8n Version: While the node might work with earlier versions, it has been developed and tested primarily on n8n version 1.19.3.
- Node.js: 20.15 or higher
- DinastiAPI: Compatible with all DinastiAPI versions
- WhatsApp: Supports all current WhatsApp message types including interactive content
- Media Formats:
- Images: JPEG, PNG, WebP
- Videos: MP4, AVI, MOV (H.264 codec recommended)
- Audio: OGG (Opus), MP3, WAV, AAC
- Documents: PDF, DOCX, XLSX, TXT, and all file types
- Stickers: WebP format (recommended), PNG with transparency

Resources

- n8n Community Nodes Documentation
- DinastiAPI Documentation
- DinastiAPI API Documentation
- WhatsApp Business API

Support

For issues and feature requests, please use the GitHub issues page.

License

MIT

Author

Guilherme Jansen - guilherme@setupautomatizado.com.br

---

Made with ❤️ for the n8n community