N8N Tools KakaoTalk icon

N8N Tools KakaoTalk

Interact with KakaoTalk API

Actions15

Overview

This node integrates with the KakaoTalk API to manage and retrieve information about a user's friends on KakaoTalk. Specifically, the "Get Friends" operation fetches a paginated list of friends connected to the authenticated user.

Common scenarios where this node is useful include:

  • Building social features in applications that require access to a user's KakaoTalk friends.
  • Synchronizing friend lists for marketing or communication purposes.
  • Displaying or processing friend data within automated workflows.

For example, you might use this node to retrieve the first 10 friends starting from an offset of 0, then process or filter this list further downstream in your workflow.

Properties

Name Meaning
Offset Number indicating the starting point for pagination (default: 0). Useful for skipping a number of friends in the list.
Limit Number specifying how many friends to retrieve per request (default: 10). Controls the page size of results.

Output

The output JSON contains the response from the KakaoTalk API's friends endpoint. It typically includes an array of friend objects with details such as friend IDs, nicknames, and other metadata provided by the API.

The structure generally looks like:

{
  "elements": [
    {
      "uuid": "string",
      "profileNickname": "string",
      "profileImageURL": "string",
      ...
    },
    ...
  ],
  "totalCount": number,
  "afterUrl": "string"
}
  • elements: Array of friend entries.
  • totalCount: Total number of friends available.
  • afterUrl: URL for fetching the next page of results if more friends exist.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the KakaoTalk API.
  • The node uses the KakaoTalk REST API base URL (https://kapi.kakao.com).
  • Proper configuration of the API key credential in n8n is necessary for successful requests.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication failures.
    • Exceeding rate limits imposed by KakaoTalk API may result in errors or throttling.
    • Providing invalid pagination parameters (e.g., negative offset or limit) could lead to unexpected responses or errors.

  • Error messages:

    • "Unknown operation: getFriends": This indicates a misconfiguration in the operation parameter; ensure it is set exactly to "getFriends".
    • API errors returned from KakaoTalk (e.g., 401 Unauthorized) usually mean the API key is invalid or expired.

  • Resolutions:

    • Verify the API key credential is correctly set up and has required permissions.
    • Use valid numeric values for offset and limit.
    • Handle errors gracefully by enabling "Continue On Fail" in the node settings if partial success is acceptable.

Links and References

Discussion