페이지 이동경로
  • Docs>
  • Message>
  • Troubleshooting

Message

Troubleshooting

This document covers the errors that may occur when implementing or calling Messaging APIs and their solutions. If you cannot find the error you encounter, see Response code > Message.

Common errors

code Description Solution
-401 If you call the Kakao Talk Sharing API or Kakao Talk Messaging API using the JavaScript SDK, you also must register the value of caller (https://example.com) as a website domain.

Message: domain mismatched! caller=https://example.com. check out registered web domains.		 In [My Application] > [Platform] > [Web], register the value of caller (https://example.com) as a website domain. For more detailed rules, see Register Web platform.
Ensure that site domains are sensitive to the scheme, subdomain, and port, so you must register your caller address precisely.

Errors that occur when sending messages to friends

code Description Solution
-2 You requested receiver_uuids in wrong format.

Message: Constraints on the parameter [receiver_uuids] are unsatisfied. The input receiver id(s) is invalid format.
or Constraints on the parameter [receiver_uuids] are unsatisfied. Not allowed to send a message to some of receivers.		 You must use the uuid(s) retrieved through the Retrieving list of friends or the Friends picker in a string array format.
(Example:
'receiver_uuids=["abcdefg0001","abcdefg0002","abcdefg0003"]'
)
-2 You did not pass receiver_uuids, required parameter for sending messages to friends.

Message: The Parameter [receiver_uuids] cannot be null.
or The Parameter [receiver_uuids] cannot be empty.		 You must pass the uuid(s) of your Kakao Talk friends through the receiver_uuids parameter in a string array format.
(Example:
'receiver_uuids=["abcdefg0001","abcdefg0002","abcdefg0003"]'
)
-2 The purpose of message template is not set properly.

Message: template_type (messageType: 'kakaolink/memo API') is invalid. please use 'message API' messageType.		 In [Tools] > [Message Template Builder], select your message template, and then set 'Purpose' to 'Kakao Talk Messaging API'.
-4 A user's account is blocked so that you cannot call the Messaging API for the user.

Message: user is blocked		 For the blocked user and details, ask Kakao Customer service.

See more

Message> Troubleshooting