Solapi icon

Solapi

Send messages with Solapi

Actions3

Overview

This node enables sending Kakao FriendTalk messages via the Solapi messaging platform. It supports sending customized friend talk messages with optional images, buttons, and advertisement flags. This is useful for businesses or services that want to engage customers through KakaoTalk's FriendTalk channel, which allows more interactive and rich content compared to plain SMS.

Typical use cases include:

  • Sending promotional messages with clickable buttons.
  • Delivering notifications or alerts with embedded images.
  • Running marketing campaigns with clear call-to-action (CTA) elements.

For example, a retailer could send a FriendTalk message with a product image and buttons linking to their online store or customer support.

Properties

Name Meaning
Authentication Method of authentication: either OAuth2 or API Key (HMAC-SHA256).
To Recipient phone numbers. Multiple numbers can be input separated by commas or new lines.
Text The main text content of the FriendTalk message.
Country Code Country dialing code for the recipient numbers. Defaults to "82" (South Korea).
Kakao Channel Name or ID The Kakao channel from which the FriendTalk message will be sent. Must be selected from available channels or specified via expression.
From (Text Replacement Sender, Optional) Name or ID Optional sender name or ID to replace the default sender information in the message. Can be selected from active sender IDs or specified via expression.
AD Flag Boolean flag indicating whether the message is an advertisement.
CTA Image ID (Optional) Name or ID Optional image ID to include in the FriendTalk message. Can be selected from available Kakao images or specified via expression.
Buttons (JSON Array) JSON array defining up to 5 buttons to include in the message. Each button object should specify properties like buttonName, buttonType, and linkMo (mobile link). Example: [{"buttonName":"Home","buttonType":"WL","linkMo":"https://..."}]

Output

The node outputs a JSON object containing the response from the Solapi API after attempting to send the FriendTalk message(s). The structure typically includes details about each message sent, such as status, message ID, and any errors encountered.

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.
  • Needs either OAuth2 credentials or API key credentials configured in n8n for authentication.
  • Access to registered Kakao channels and sender IDs within Solapi.
  • Network connectivity to Solapi's REST API endpoints.

Troubleshooting

  • Invalid recipient number format: Ensure phone numbers are correctly formatted and separated by commas or new lines without extra spaces.
  • Authentication errors: Verify that the OAuth2 token or API key credentials are correctly set up and have not expired.
  • Missing required fields: The to, text, and channelId fields are mandatory; missing these will cause errors.
  • Malformed buttons JSON: The buttons property must be a valid JSON array string. Invalid JSON will cause parsing errors.
  • Exceeded button limit: Only up to 5 buttons are supported; providing more may result in API rejection.
  • API rate limits or quota exceeded: Check your Solapi account limits if messages fail unexpectedly.
  • Error responses from Solapi: The node returns error messages from the API in the output JSON; review these for specific issues.

Links and References

Discussion