Solapi icon

Solapi

Send messages with Solapi

Actions3

Overview

This node enables sending messages via the Solapi service, specifically focusing on sending Kakao AlimTalk messages (template-based notifications) under the "Message" resource and "Send Kakao AlimTalk" operation. It is useful for automating customer notifications, alerts, or marketing messages through KakaoTalk's official business messaging platform using predefined templates.

Typical use cases include:

  • Sending personalized transactional messages like order confirmations or delivery updates.
  • Dispatching promotional or informational messages with dynamic content via template variables.
  • Managing bulk message sending to multiple recipients efficiently.

Properties

Name Meaning
Authentication Method of authenticating API requests: either OAuth2 or API Key (HMAC-SHA256).
To Recipient phone numbers, separated by commas or new lines. Multiple recipients can be specified.
Country Code The country dialing code for the recipient numbers, default is "82" (South Korea).
Kakao Channel Name or ID Select the Kakao channel from which the message will be sent. This can be chosen from a list or specified dynamically via an expression.
Kakao Template Name or ID Select the Kakao AlimTalk template to use for the message. Templates are predefined message formats approved by Kakao. This can be selected from a list filtered by the chosen channel or specified via expression.
Template Variables Key-value pairs to fill in the placeholders defined in the Kakao template. Multiple variables can be provided to customize the message content dynamically.
From (Text Replacement Sender, Optional) Name or ID Optionally specify a sender ID for text replacement in the Kakao message. Can be selected from active sender IDs or specified via expression.

Output

The node outputs JSON data containing the response from the Solapi API after attempting to send the Kakao AlimTalk messages. The structure typically includes details about each message sent, such as status, message ID, and any errors encountered per recipient.

No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "messageId": "1234567890",
  "status": "success",
  "to": "01012341234"
}

Dependencies

  • Requires a valid Solapi account with access to Kakao messaging services.
  • An API authentication credential must be configured in n8n, either OAuth2 or API key with HMAC-SHA256 signature.
  • The node uses Solapi REST API endpoints to fetch channels, templates, and send messages.
  • Network connectivity to https://api.solapi.com is required.

Troubleshooting

  • Invalid or missing authentication: Ensure that the API credentials are correctly set up in n8n and match the selected authentication method.
  • Incorrect channel or template ID: Verify that the Kakao channel and template exist and are accessible with your Solapi account. Use the dropdowns or expressions carefully.
  • Malformed template variables: Template variables must match those defined in the selected Kakao template. Incorrect variable names or missing required variables may cause message sending failures.
  • Recipient number formatting: Phone numbers should be properly formatted without extra spaces or invalid characters. Use commas or new lines to separate multiple numbers.
  • API rate limits or quota exceeded: If many messages are sent rapidly, you might hit Solapi's rate limits. Check your Solapi account limits and adjust usage accordingly.
  • JSON parsing errors: When providing JSON strings for variables or buttons, ensure they are valid JSON to avoid parsing exceptions.

Links and References

This summary covers the static analysis of the node's execute logic for sending Kakao AlimTalk messages, focusing on input properties, output, dependencies, and common troubleshooting points.

Discussion