Configurar KakaoTalk
Este artículo cubre cómo configurar el canal de mensajería KakaoTalk en Braze, incluyendo cómo configurar usuarios, conciliar ID de usuario y crear usuarios de prueba de KakaoTalk.
Requisitos previos
| Requisito | Descripción |
|---|---|
| Cuenta con un partner de KakaoTalk compatible | Se necesita una cuenta con un partner de KakaoTalk compatible, CJ OliveNetworks o Infobip, para usar el canal de mensajería de KakaoTalk. |
| Canal Business de KakaoTalk | Tu cuenta de KakaoTalk debe ser un canal Business de KakaoTalk para enviar mensajes de KakaoTalk a través de Braze. Cuando creas una cuenta, su estado predeterminado es básico. Para convertir tu cuenta en un canal Business, necesitarás verificar tu negocio y proporcionar la documentación pertinente. |
| Sender Key de KakaoTalk | Un Sender Key de KakaoTalk válido. |
| Número de teléfono de contacto | Un número de teléfono de contacto para el administrador de tu canal de KakaoTalk. |
| IP del clúster de Braze en la lista de permitidos | El registro en la lista de IP permitidas es obligatorio para todos los clientes. Registra las direcciones IP de Braze de tu clúster antes de integrar KakaoTalk en Braze. |
Registrar las direcciones IP de Braze
Registra las direcciones IP de Braze de tu clúster en tu panel de Comm.One.
- En tu panel de Comm.One, ve a Account Management (계정 관리), selecciona el icono de menú y luego selecciona View Details (자세히보기).
- Selecciona Center & Upload IP Allowlist (센터&업로드 IP 화이트리스트).
- Añade las direcciones IP de tu clúster de Braze. Para la lista completa de IP por clúster, consulta Lista de IP permitidas.
Tipos de cuentas de KakaoTalk
| Tipo de cuenta | Descripción |
|---|---|
| Canal básico | Un canal estándar de KakaoTalk que cualquier organización puede configurar. Permite la mensajería masiva y el chat 1:1 a través de KakaoTalk. |
| Canal Business | Un canal de KakaoTalk mejorado y verificado para empresas que requiere un proceso de solicitud y verificación. Ofrece características mejoradas, como
|
Solicitar un canal Business
Antes de iniciar la solicitud, reúne la siguiente documentación empresarial:
- Certificado de Registro Empresarial Coreano
- Identificación del Representante del Negocio
- Certificado de Empleo
- Licencias específicas del sector
La información en tu canal de KakaoTalk (como el nombre del canal, la imagen de perfil y otros datos) debe coincidir exactamente con la información de tus documentos oficiales presentados.
Después de reunir tu documentación, sigue estos pasos:
- Inicia sesión en el Centro de Administración del Canal KakaoTalk.
- Selecciona el canal de KakaoTalk existente que deseas actualizar.
- En la sección Management (관리), selecciona la opción Business Channel Application (비즈니스 채널 신청).
- Selecciona el botón Apply o Request (신청) para iniciar el proceso.
- Proporciona la información solicitada.
- Espera una notificación con los resultados de la revisión.
Integrar KakaoTalk
Conectar el canal de KakaoTalk a Braze
- Ve a Partner Integrations > Technology Partners y selecciona tu proveedor de KakaoTalk.
- Reúne las credenciales necesarias para tu proveedor (consulta la siguiente sección), luego ingrésalas en la página Technology Partners y guarda.
- Usa las credenciales recién guardadas para el envío.
CJ OliveNetworks
Ve a tu panel de Comm.One y reúne la siguiente información.
| Campo | Ubicación |
|---|---|
| Comm.One Login ID (로그인 아이디) | Selecciona tu perfil. |
| Sender Key (발신프로필 키) | Ve a Template Management (템플릿 관리) > Sender Profile Management (발신프로필 관리). |
| Channel name (카카오톡 채널 프로필명) | En tu panel de Comm.One, ve a Template Management (템플릿 관리) > Sender Profile Management (발신프로필 관리). |
| Sender number (연락처) |
|
| Credential (ID) & Password (비밀번호) | Ve a la misma ubicación del Sender number (사업자 등록번호), luego ve a API > Brand Message (브랜드 메시지). |
Solo puedes integrar una Sender Key de KakaoTalk en un espacio de trabajo a la vez. Para usar la misma Sender Key en un espacio de trabajo diferente, primero debes archivar el grupo de suscripción de KakaoTalk en el espacio de trabajo original, y luego contactar a soporte de Braze para eliminar la integración. Después de que Braze elimine la integración, puedes configurar la integración en el nuevo espacio de trabajo.
Solo se pueden registrar los canales mapeados a un único ID común.
Infobip
Ve a tu panel de Infobip y al Centro de administración del canal KakaoTalk para reunir la siguiente información.
| Campo | Ubicación |
|---|---|
| API Base URL | En el portal de Infobip, ve a Developer Tools > API Keys. |
| API Key | En el portal de Infobip, ve a Developer Tools > API Keys. |
| Sender name / Sender key | En el portal de Infobip, ve a Channels and Numbers > Channels, luego selecciona la pestaña Senders. |
| Sender profile UUID | En el Centro de administración del canal KakaoTalk, ve a Channels y busca el Search ID en la ventana de información del canal. |
| Channel name | En el Centro de administración del canal KakaoTalk, busca el channel name en la misma ventana de información del canal. |
Clave de API y URL base
- En el portal de Infobip, selecciona Developer Tools > API Keys.
- En la página API keys, copia la API base URL.
- Selecciona CREATE API KEY.
- Ingresa el Name, selecciona la Expiration date, y luego selecciona los alcances de API requeridos para KakaoTalk. Estos alcances controlan qué acciones de la API de Infobip puede realizar tu clave.
- Selecciona CREATE para generar la clave.
- Copia la clave generada. Puedes regresar a esta página para actualizar el nombre, la fecha de expiración o los alcances de API.
UUID del perfil de remitente y nombre del canal
- En el Centro de administración del canal KakaoTalk, selecciona Channels.
- En la ventana de Channel Information, busca el Channel name y el Search id (UUID del remitente).
- Ingresa la Customer center contact information. Esto es obligatorio al enviar mensajes publicitarios.
- Para ver un canal diferente, selecciona el ícono del canal en la parte superior del menú.
- En la lista de My channel, selecciona el canal que deseas ver, luego repite los pasos anteriores.
Configurar perfiles de usuario
Los perfiles de usuario deben tener números de teléfono en formato E.164 para enviarles mensajes a través de KakaoTalk. Los números de teléfono se muestran en el perfil de usuario. KakaoTalk requiere que los números de teléfono estén en formato E.164 (por ejemplo, +821025749774). Esto difiere de otros canales de mensajería que pueden aceptar números de teléfono en múltiples formatos.
Importar números de teléfono
Importa números de teléfono cargando un CSV o usando la API para crear un usuario. Asegúrate de que los números de teléfono estén en formato E.164 antes de importarlos.