Conectar o KakaoTalk Business

O KakaoTalk é o app de mensagens líder na Coreia do Sul. Diferente da maioria dos canais, o KakaoTalk Business não se conecta direto: você contrata um BSP (Business Service Provider) local — Bizm, Infobank ou NHN Toast são os mais comuns — que atua entre a Omnifox e o Kakao para enviar Alimtalk (notificações) e Friendtalk (mensagens promocionais).

Requisitos

• Um contrato ativo com um BSP coreano (a Omnifox usa Bizm por padrão, mas também suporta Infobank e NHN Toast)
• Um Kakao Plus Channel (canal de marca) cadastrado nesse BSP
• API Key e Sender Key emitidos pelo BSP

Passos para conectar

1. Contrate um BSP e cadastre seu Plus Channel — o BSP fornece a API Key e a Sender Key.
2. Na Omnifox, vá em Canais → Conectar novo canal e escolha KakaoTalk Business.
3. Selecione seu BSP Provider (Bizm, Infobank, NHN Toast, ou Custom para outro). A Base URL é preenchida automaticamente, exceto se você escolher Custom.
4. Cole a API Key e a Sender Key do seu Plus Channel.
5. Preencha, se aplicável, o Plus Friend ID público e um prefixo de template (por exemplo OMFX_) para identificar seus templates de Alimtalk.
6. Salve e configure o callback do seu BSP apontando para a Webhook URL exibida pela Omnifox.

Configuração

• BSP Provider / Base URL: define o host da API (api.bizmsg.kr, omni.ibapi.kr, api-alimtalk.cloud.toast.com, ou um próprio).
• API Key: no Bizm aceita o formato userid:apikey ou um bearer direto.
• Sender Key: ID do seu Plus Channel registrado no BSP.
• Template Code Prefix: opcional, ajuda a identificar seus templates de Alimtalk pré-aprovados pelo Kakao.

Exemplo

Um cliente em Seul recebe um Alimtalk de confirmação de pedido e, se responder, essa mensagem entra no Inbox da Omnifox como uma conversa do KakaoTalk pronta para um atendente continuar.

Dicas

• O Alimtalk exige templates pré-aprovados pelo Kakao; não é possível enviar texto livre como notificação transacional.
• O BSP assina o corpo com HMAC-SHA256 usando sua API Key, no header X-Kakao-Signature.

Solução de problemas

• Os envios falham: confirme que a Sender Key corresponde exatamente ao Plus Channel ativo no BSP.
• Eventos recebidos não chegam: verifique se o callback configurado no painel do BSP aponta para a Webhook URL correta.