📌Canal Personalizado
Integrar la aplicación de mensajería de terceros en Okeybot.
Última actualización
Integrar la aplicación de mensajería de terceros en Okeybot.
Última actualización
Esta función se encuentra actualmente en fase Beta. ¡Si tiene algún problema, póngase en contacto con nosotros aquí!
Consejos: También le proporcionamos un ejemplo de canal personalizado que puede intentar implementar en su servidor.
Para recibir un mensaje a través de un canal personalizado, se deben seguir los siguientes pasos:
Cuando un contacto intenta enviar un mensaje, el proveedor de servicios de mensajería llamará a su servidor de integración personalizado con la carga útil del mensaje (consulte la documentación de la API del proveedor de servicios de mensajería para obtener referencia).
Okeybot recibirá la solicitud post, guardará el mensaje y lo mostrará en el módulo de mensajería.
Para enviar un mensaje a través de un canal personalizado, se deben seguir los siguientes pasos:
Su servidor de integración personalizado recibirá el mensaje y lo enviará al proveedor de servicios de mensajería en el formato que requiera (consulte la documentación de la API del proveedor de servicios de mensajería para obtener referencia).
El proveedor de servicios de mensajería recibirá el Webhook y confirmará si el mensaje se ha entregado correctamente. Consejos, si el mensaje no se entrega correctamente, puede intentar agregar un mecanismo de reintento en su servidor de integración personalizado.
En la plataforma Okeybot, vaya a Configuración > Canales y haga clic en el botón AGREGAR CANAL.
Seleccionar Canal Personalizado (Custom Channel).
Introduzca la URL base de la API
.
Seleccione el tipo de ID
para el canal y haga clic en SIGUIENTE. Este ID tiene el propósito de identificar al usuario y se utilizará para comunicarse con su servidor de integración personalizado. Hay dos tipos de IDs:
Número de teléfono: Utilícelo si el proveedor de servicios de mensajería reconoce a los contactos en función de su número de teléfono.
Formato de muestra: + 60177872890
ID personalizado: Utilícelo si el proveedor de servicios de mensajería reconoce contactos en función de un ID generado a medida.
La longitud máxima de caracteres es de 50.
A-Z
, a-z
, 0-9
, _
, =
, +
, /
y @
están permitidos.
El siguiente cuadro de diálogo proporcionará el ID de canal, el token de API y la URL del Webhook, p. ej.
ID de canal: gfd8g7fd89dgfd
API Token: aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd
URL del Webhook: https://okeybot.com/custom/webhook
Consejos: Usar el tipo de ID de número de teléfono te permite iniciar una conversación y enviar el primer mensaje a un contacto.
La URL del Webhook se utiliza para PUBLICAR los Mensajes, Ecos de Mensajes y Recibos de Mensajes en la plataforma Okeybot.
El siguiente código llamará al webhook en la plataforma Okeybot y estará creando el contacto (si no existe) y guardando el mensaje contra el contacto.
Campos
Campo
Descripción
Validación
channelId
ID único del canal
contactId
Id único de contacto
events.type
Tipo Evento
Requerido. Mensaje.
events.mId
ID de Mensaje
Requerido. ID único de mensaje. Max 50 caracteres.
events.timestamp
Época única
Tiempo(millisegundos)
Requerido. Hora del evento que activó la devolución de llamada.
events.message.type
Tipo mensaje
Requerido. Tipos de mensajes disponibles: texto, archivo adjunto, ubicación y respuesta rápida.
Consulte la sección de tipo de mensaje para otras muestras de tipo de mensaje.
events.message.text
Texto del mensaje
Requerido. Longitud máxima de 7,000 caracteres.
contact.firstName
Nombre
Opcional. Max 50 caracteres.
contact.lastName
Apellidos
Opcional. Max 50 caracteres.
contact.profilePic
URL de foto de perfil
Opcional. El tamaño de la imagen del avatar no debe ser mayor de 100 kb. Recomendado 720x720
contact.locale
Código local
Opcional. Consulte aquí la lista de valores.
contact.countryCode
Código del país
Opcional. Código de país de 2 letras - Código ISO ALFA - 2.
contact.timezone
Huso horario
Opcional. (min: -24) (max: 24)
contact.email
Correo electrónico
Opcional. Max 50 caracteres.
contact.phone
Número de teléfono
Opcional. Max 18 caracteres.
contact.language
Idioma
Opcional. ISO 639-1
Respuesta de éxito (Estado HTTP → 200)
Okeyot llamará al siguiente punto final <URL de base de API > / mensaje
Importante: Asegúrese de implementar el código de mensaje saliente en la ruta / message
de su servidor web.
Aquí está el ejemplo de cURL de Okeybot llamando al punto final.
Respuesta de éxito (Estado HTTP → 200)
La autenticación debe realizarse en el punto final antes de pasar el mensaje al Proveedor de Servicios de mensajería. Aquí hay un ejemplo de middleware express.
Consejos: También le proporcionamos un ejemplo de canal personalizado que puede intentar implementar en su servidor.
Campos
Campo
Descripción
Validación
tipo
Tipo de mensaje
Requerido. Texto.
texto
Texto de mensaje
Requerido. Longitud máxima de 7,000 caracteres.
Campo
Descripción
Validación
type
Tipo de mensaje
Requerido. Adjunto
attachment.type
Tipo de adjunto
Requerido. Tipo de adjusntos disponibles: imagen, video, audio y archivo.
attachment.url
URL
Requerido. Max 2,000 caracteres. Asegúrese de que sea un enlace público para que los usuarios o contactos puedan ver el contenido.
attachment.mimeType
Tipo Mime del archivo adjunto
Opcional
attachment.fileName
Nombre del archivo
Opcional. El nombre del archivo debe incluir una extensión. Max 256 caracteres (incluyendo extensión del archivo). Enviar un archivo sin extensión o con una extensión incorrecta puede hacer que el contacto o el usuario no pueda abrir el archivo.
attachment.description
Descripción del archivo
Opcional. Max 256 caracteres. Solo aplicable para attachment.type = imagen
Campo
Descripción
Validación
type
Tipo de mensaje
Requerido. Localización
latitude
Coordenadas
Requerido. Latitud (±90°) dentro de rangos válidos.
longitude
Coordenadas
Requerido. Longitud (±180°) dentro de rangos válidos.
address
Dirección de ubicación
Opcional. Max 256 caracteres.
Campo
Descripción
Validación
type
Tipo de mensaje
Requerido. respuesta_rápida
title
Título de respuesta rápida
Requerido. Max 256 caracteres.
replies
Texto de respuesta
Requerido. Max 10 respuestas con un máximo de 256 caracteres por cada respuesta
Esta función se encuentra actualmente en fase Beta. ¡Si tiene algún problema, póngase en contacto con nosotros aquí!
Requerido. Campo único. Es generado por .
Requerido. ID único de contacto de . Max 50 carcteres.