n8n-nodes-n8ntools-kakao

v1.0.3

Published

3 months ago

N8N Tools KakaoTalk Enhanced node with comprehensive KakaoTalk API support

Downloads

0High
0Medium
0Low

n8ntools.oficial

n8n-community-node-package kakaotalk messaging korea south-korea alimtalk friendtalk sangdamtalk

N8N Tools - Kakao Enhanced

Complete Kakao integration with 40+ operations covering the full Kakao ecosystem. This N8N community node provides comprehensive access to KakaoTalk messaging, Kakao Maps, Kakao Pay, User management, and Business features through the official Kakao APIs with enhanced functionality for Korean market automation.

✨ Features

💬 KakaoTalk Business: Send messages, templates, and rich media through KakaoTalk for Business
🗺️ Kakao Maps Integration: Geocoding, directions, place search, and location services
💳 Kakao Pay Operations: Payment processing, subscription management, and transaction handling
👤 Kakao User Management: Profile management, friend connections, and social features
📱 Kakao Channels: Manage business channels, followers, and automated responses
🔍 Kakao Search: Web search, image search, and blog search capabilities
📊 Kakao Analytics: Business insights, message analytics, and user engagement metrics
🏪 Kakao Commerce: Product catalog, shopping integration, and order management
🎯 Targeted Messaging: Segmented messaging with personalization and automation
🔒 Secure API: Powered by N8N Tools platform with usage tracking and validation

🚀 Quick Start

Installation

Install this node in your N8N instance:

Via Community Nodes (Recommended)

Go to Settings > Community Nodes in your N8N interface
Click Install a community node
Enter n8n-nodes-n8ntools-kakao-enhanced
Click Install

Via npm

npm install n8n-nodes-n8ntools-kakao-enhanced

Setup Credentials

Sign up at N8N Tools and get your API key
In N8N, create new N8N Tools API credentials
Enter your API URL: https://api.n8ntools.io
Enter your API key

📋 Available Resources

💬 KakaoTalk (10 Operations)

Advanced KakaoTalk business messaging:

| Operation | Description | Benefits | |-----------|-------------|----------| | Send Text Message | Send plain text messages | Direct customer communication | | Send Template Message | Send approved business templates | Professional branded messages | | Send Rich Card | Send interactive cards with images | Enhanced engagement | | Send List Template | Send structured list messages | Product/service showcases | | Send Button Template | Send messages with action buttons | Call-to-action messaging | | Send Carousel | Send multiple cards in carousel | Multiple offerings display | | Send Location | Share location and map information | Business location sharing | | Send Image | Send image messages with captions | Visual communication | | Get Message Status | Check delivery and read status | Message tracking | | Manage Friends | Add/remove friend connections | Contact management |

🗺️ Kakao Maps (8 Operations)

Comprehensive location and mapping services:

Geocoding: Convert addresses to coordinates
Reverse Geocoding: Convert coordinates to addresses
Place Search: Find businesses, landmarks, and POIs
Keyword Search: Search locations by keywords
Category Search: Find places by category
Directions: Get driving, walking, transit directions
Distance Matrix: Calculate distances between multiple points
Static Maps: Generate static map images

💳 Kakao Pay (7 Operations)

Payment processing and financial services:

Create Payment: Initialize payment transactions
Process Payment: Complete payment processing
Cancel Payment: Cancel or refund payments
Get Payment Status: Check payment transaction status
Subscription Management: Handle recurring payments
Payment History: Retrieve transaction history
Merchant Services: Manage merchant account features

👤 User Management (6 Operations)

Kakao user and profile operations:

Get User Info: Retrieve user profile information
Update Profile: Modify user profile data
Friend Management: Manage friend lists and connections
User Authentication: Handle Kakao Login integration
Privacy Settings: Manage user privacy preferences
Account Linking: Link external accounts to Kakao

📱 Kakao Channels (5 Operations)

Business channel management:

Create Channel: Set up new business channels
Manage Followers: Handle channel subscriptions
Send Channel Message: Broadcast to channel followers
Auto-Reply Setup: Configure automated responses
Channel Analytics: Track channel performance metrics

🔍 Kakao Search (4 Operations)

Search and discovery services:

Web Search: Search web content through Kakao
Image Search: Find images and visual content
Blog Search: Search Kakao blog posts
News Search: Search news articles and updates

💡 Usage Examples

Send KakaoTalk Template Message

// Configuration
Resource: "KakaoTalk"
Operation: "Send Template Message"
User ID: "kakao_user_123"
Request Body: {
  "template_object": {
    "object_type": "feed",
    "content": {
      "title": "New Product Launch! 🚀",
      "description": "Check out our latest innovation - 50% off for early adopters",
      "image_url": "https://example.com/product-image.jpg",
      "link": {
        "web_url": "https://example.com/new-product",
        "mobile_web_url": "https://m.example.com/new-product"
      }
    },
    "buttons": [
      {
        "title": "View Product",
        "link": {
          "web_url": "https://example.com/new-product",
          "mobile_web_url": "https://m.example.com/new-product"
        }
      },
      {
        "title": "Get Discount",
        "link": {
          "web_url": "https://example.com/discount",
          "mobile_web_url": "https://m.example.com/discount"
        }
      }
    ]
  }
}

// Output
{
  "resource": "kakaotalk",
  "operation": "sendTemplateMessage",
  "success": true,
  "result_code": 0,
  "message_id": "msg_12345",
  "sent_at": "2024-01-15T10:30:00+09:00",
  "creditsUsed": 2,
  "creditsRemaining": 98
}

Kakao Maps Place Search

// Search for Restaurants
Resource: "Kakao Maps"
Operation: "Place Search"
Request Body: {
  "query": "한국 맛집",
  "category_group_code": "FD6",
  "x": "127.027619",
  "y": "37.497942",
  "radius": "5000",
  "sort": "distance",
  "size": "15"
}

// Get Directions
Resource: "Kakao Maps"
Operation: "Directions"
Request Body: {
  "origin": "127.027619,37.497942",
  "destination": "127.027819,37.498142",
  "waypoints": "127.027719,37.498042",
  "priority": "RECOMMEND",
  "car_fuel": "GASOLINE",
  "car_hipass": false,
  "alternatives": true
}

Kakao Pay Integration

// Initialize Payment
Resource: "Kakao Pay"
Operation: "Create Payment"
Request Body: {
  "cid": "TC0ONETIME",
  "partner_order_id": "order_12345",
  "partner_user_id": "user_67890",
  "item_name": "Premium Subscription",
  "quantity": "1",
  "total_amount": "29900",
  "tax_free_amount": "0",
  "approval_url": "https://example.com/payment/success",
  "cancel_url": "https://example.com/payment/cancel",
  "fail_url": "https://example.com/payment/fail"
}

// Check Payment Status
Resource: "Kakao Pay"
Operation: "Get Payment Status"
Request Body: {
  "cid": "TC0ONETIME",
  "tid": "T1234567890123456789",
  "partner_order_id": "order_12345",
  "partner_user_id": "user_67890"
}

Advanced Messaging with Rich Cards

// Send Product Carousel
Resource: "KakaoTalk"
Operation: "Send Carousel"
User ID: "kakao_user_123"
Request Body: {
  "template_object": {
    "object_type": "list",
    "header_title": "추천 상품",
    "header_link": {
      "web_url": "https://example.com/products",
      "mobile_web_url": "https://m.example.com/products"
    },
    "contents": [
      {
        "title": "스마트폰 케이스",
        "description": "프리미엄 가죽 케이스",
        "image_url": "https://example.com/case.jpg",
        "price": "25,000원",
        "discount": "20%",
        "link": {
          "web_url": "https://example.com/product/case"
        }
      },
      {
        "title": "무선 이어폰",
        "description": "노이즈 캔슬링 기능",
        "image_url": "https://example.com/earphone.jpg",
        "price": "150,000원",
        "discount": "15%",
        "link": {
          "web_url": "https://example.com/product/earphone"
        }
      }
    ],
    "buttons": [
      {
        "title": "전체 상품 보기",
        "link": {
          "web_url": "https://example.com/products"
        }
      }
    ]
  }
}

Channel Management and Broadcasting

// Create Business Channel
Resource: "Kakao Channels"
Operation: "Create Channel"
Request Body: {
  "channel_name": "테크 뉴스 채널",
  "description": "최신 기술 뉴스와 트렌드를 전해드립니다",
  "profile_image": "https://example.com/channel-profile.jpg",
  "category": "TECHNOLOGY",
  "public": true
}

// Broadcast to Channel Followers
Resource: "Kakao Channels"
Operation: "Send Channel Message"
Channel ID: "channel_12345"
Request Body: {
  "message_type": "feed",
  "content": {
    "title": "🔥 AI 기술 최신 동향",
    "description": "2024년 주목해야 할 AI 기술 트렌드를 소개합니다",
    "image_url": "https://example.com/ai-trends.jpg",
    "link": {
      "web_url": "https://example.com/ai-trends-2024"
    }
  },
  "target_type": "ALL_FOLLOWERS"
}

⚙️ Configuration Options

KakaoTalk Settings

Template Types: Feed, list, location, commerce templates
Message Priority: Normal, high priority delivery
Personalization: Dynamic content insertion
Rich Media: Images, videos, interactive elements

Kakao Maps Options

Search Radius: Distance-based filtering
Category Filters: Business type filtering
Language: Korean, English language support
Result Formats: JSON, XML response formats

Advanced Request Options

Request Body: JSON payload for operations
User ID: Target user identifier
Location Data: Coordinates and address information
Additional Options: Pagination, filtering, and analytics

🛠️ Example Workflows

Korean E-commerce Integration

[Order Placed] → [Kakao Enhanced: Send Template] → [Kakao Pay: Process Payment] → [Kakao Maps: Delivery Route] → [Status Updates]

Local Business Marketing

[Customer Signup] → [Kakao Enhanced: Add Friend] → [Location-based Offers] → [Store Visit Tracking] → [Follow-up Messages]

Food Delivery Service

[Order Received] → [Kakao Maps: Restaurant Location] → [Kakao Enhanced: Order Confirmation] → [Real-time Tracking] → [Delivery Completion]

Customer Support Automation

[Support Request] → [Kakao Enhanced: Auto-Reply] → [Category Classification] → [Agent Assignment] → [Resolution Tracking]

📊 Comparison with Standard Kakao Integration

| Feature Category | Standard Integration | Kakao Enhanced | Improvement | |------------------|---------------------|----------------|-------------| | KakaoTalk | 2 operations | 10 operations | +400% | | Kakao Maps | 0 operations | 8 operations | ∞ (new) | | Kakao Pay | 0 operations | 7 operations | ∞ (new) | | User Management | 1 operation | 6 operations | +500% | | Kakao Channels | 0 operations | 5 operations | ∞ (new) | | Kakao Search | 0 operations | 4 operations | ∞ (new) | | Total Operations | 3 operations | 40 operations | +1233% |

🔧 API Endpoints

All operations are routed through N8N Tools API for consistent authentication and usage tracking:

| Resource | Base Endpoint | |----------|---------------| | KakaoTalk | /api/v1/kakao-enhanced/kakaotalk/ | | Kakao Maps | /api/v1/kakao-enhanced/maps/ | | Kakao Pay | /api/v1/kakao-enhanced/pay/ | | User Management | /api/v1/kakao-enhanced/users/ | | Kakao Channels | /api/v1/kakao-enhanced/channels/ | | Kakao Search | /api/v1/kakao-enhanced/search/ |

🚨 Error Handling

The node provides comprehensive error handling with detailed messages:

{
  "error": "KAKAO_USER_NOT_FOUND",
  "success": false,
  "resource": "kakaotalk",
  "operation": "sendTextMessage",
  "details": {
    "issue": "The specified Kakao user ID does not exist or has blocked the service",
    "field": "user_id",
    "value": "INVALID_USER_ID",
    "error_code": -401
  }
}

💸 Pricing & Limits

Standard Operations: 1 credit per API call
KakaoTalk Messages: 2 credits (premium messaging service)
Kakao Pay Operations: 3 credits (financial transaction processing)
Monthly Quotas: Based on your N8N Tools subscription plan
Rate Limits: Based on your subscription tier
Usage Tracking: Real-time credit monitoring

🔧 Troubleshooting

Common Issues

Authentication Errors

Verify N8N Tools API key is valid and active
Check API URL is set to https://api.n8ntools.io
Ensure sufficient credits in your account

Kakao App Registration

Verify your Kakao app is properly registered
Check app permissions and scopes
Ensure app is approved for business use

Message Delivery Issues

Verify recipient has KakaoTalk installed
Check if user has blocked your service
Ensure message templates are approved

Location Service Errors

Verify coordinates are in valid format
Check if location services are enabled
Ensure search radius is within limits

📈 Performance Tips

Template Optimization: Pre-approve message templates for faster delivery
Location Caching: Cache frequently accessed location data
Batch Operations: Group related operations for efficiency
Error Handling: Implement retry logic for temporary failures
Korean Localization: Use proper Korean language formatting and cultural context

🆘 Support

Documentation: docs.n8ntools.io
API Reference: api.n8ntools.io/docs
Community: Discord
Email: [email protected]

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by N8N Tools