Conectar KakaoTalk Business

KakaoTalk es la app de mensajería líder en Corea del Sur. A diferencia de otros canales, KakaoTalk Business no se conecta directo: se contrata a un BSP (Business Service Provider) local — Bizm, Infobank o NHN Toast son los más comunes — que actúa como intermediario entre Omnifox y Kakao para enviar Alimtalk (notificaciones) y Friendtalk (mensajes promocionales).

Requisitos

• Un contrato activo con un BSP coreano (Bizm por defecto en Omnifox, también Infobank o NHN Toast)
• Un Kakao Plus Channel (canal de marca) dado de alta ante ese BSP
• API Key y Sender Key emitidos por el BSP

Pasos para conectar

1. Contratá un BSP y dado de alta tu Plus Channel — el BSP te entrega API Key y Sender Key.
2. En Omnifox, andá a Canales → Conectar nuevo canal y elegí KakaoTalk Business.
3. Seleccioná tu BSP Provider (Bizm, Infobank, NHN Toast, o Custom si usás otro). La Base URL se autocompleta salvo que elijas Custom.
4. Pegá el API Key y el Sender Key de tu Plus Channel.
5. Completá, si aplica, el Plus Friend ID público y un prefijo de plantilla (por ejemplo OMFX_) para identificar tus templates de Alimtalk.
6. Guardá y configurá el callback de tu BSP apuntando a la Webhook URL que te muestra Omnifox.

Configuración

• BSP Provider / Base URL: define el host de la API (api.bizmsg.kr, omni.ibapi.kr, api-alimtalk.cloud.toast.com, o uno propio).
• API Key: para Bizm acepta el formato userid:apikey o un bearer directo.
• Sender Key: ID de tu Plus Channel registrado en el BSP.
• Template Code Prefix: opcional, ayuda a identificar tus plantillas Alimtalk pre-aprobadas por Kakao.

Ejemplo

Un cliente en Seúl recibe una Alimtalk de confirmación de pedido, y si responde, ese mensaje entra al Inbox de Omnifox como una conversación de KakaoTalk lista para que un agente continúe.

Consejos

• Alimtalk requiere plantillas pre-aprobadas por Kakao; no podés enviar texto libre como notificación transaccional.
• El BSP firma el body con HMAC-SHA256 usando tu API Key en el header X-Kakao-Signature.

Solución de problemas

• Los envíos fallan: confirmá que el Sender Key corresponde exactamente al Plus Channel activo en el BSP.
• No llegan eventos entrantes: revisá que el callback configurado en el panel del BSP apunte a la Webhook URL correcta.