KakaoTalk
Connect a KakaoTalk Channel through an authenticated Kakao i Open Builder skill.
Connect a KakaoTalk Channel through an authenticated Kakao i Open Builder skill.
Prepare Kakao assets#
Create or select the Kakao Developers application, KakaoTalk Channel, and Kakao i Open Builder bot that will own the integration. Review Kakao's official Open Builder documentation for skills and blocks.
Collect or create these values:
| Make Agent Fast field | Source | Purpose |
|---|---|---|
| Channel ID | KakaoTalk Channel public/search ID | Associates the connector with the intended channel |
| REST API key | Kakao Developers app keys | Validates the Kakao application |
| Bot secret | A long random secret you generate | Authenticates inbound skill requests in X-Kakao-Bot-Secret |
The Bot secret is required on deployed Make Agent Fast environments because Kakao skill calls do not provide a platform signature. Generate a unique high-entropy value and do not reuse the REST API key as the secret.
Save the connector#
Open the site's Connectors page, choose KakaoTalk Channel, enter all three values, and select Connect. Make Agent Fast validates the REST API key where Kakao permissions allow it and displays the connector's unique Webhook URL after save.
Make Agent Fast cannot create the Open Builder skill or attach it to a block for you; the remaining work is in Kakao's console.
Configure the Open Builder skill#
- In Kakao i Open Builder, create a skill for the intended bot.
- Set the skill URL to the connector's copied Webhook URL.
- Add a custom request header named
X-Kakao-Bot-Secretwhose value exactly matches Bot secret. - Connect the skill to the fallback or scenario block that should invoke the agent.
- Save and deploy/publish the bot configuration according to Kakao's workflow.
The header is case-insensitive by HTTP rules, but the secret value is exact. Anyone who knows the webhook URL but not this secret should receive an unauthorized response.
Test capabilities#
Use the Open Builder test tool first, then the connected KakaoTalk Channel. Send a realistic Korean or supported-language text question and confirm the inline answer, Last message, and Conversations thread.
The current skill contract is text-only. The agent reply is returned synchronously as Kakao skillResponse version 2.0 with one simpleText output, capped below Kakao's text limit. Voice, files, images, and separate outbound audio are not supported.
Rotate or disconnect#
To rotate the Bot secret, update the connector and the Open Builder custom header as one coordinated change, then test immediately. A mismatch stops every inbound request. Rotate the REST API key in Kakao Developers and Make Agent Fast before revoking the old key.
Disabling or removing the connector does not delete the Open Builder skill or block. Remove or detach those provider-side objects when permanently decommissioning the integration.
Troubleshooting#
| Symptom | Fix |
|---|---|
| Connector requires a Bot secret | Generate one; deployed environments refuse an unauthenticated Kakao webhook |
| REST API key rejected | Use the REST API key from the intended Kakao app and confirm its channel permissions |
| Open Builder receives unauthorized | Add/update X-Kakao-Bot-Secret so it exactly matches the connector value |
| Test tool shows a fallback instead of an answer | Confirm the block invokes the saved skill URL and inspect Kakao request/response logs |
| Requests time out | Test a fast agent configuration; Kakao expects the skill response inline |
| Voice or images are ignored | Expected; the current connector accepts text only |
Do not expose the REST API key or Bot secret in client code or public documentation.