OkeyBot
🦸‍♂️ Soporte dedicado🚀 Crear cuenta🟢 API de WhatsApp
  • 👋Bienvenido a OkeyBot
  • 📖Glosario de Términos
  • 🚀Comenzando
    • ⚡Inicio Rápido
    • 🔌Conectando un Canal
    • 👥Invita a tus Colegas
    • ✏️ Responder a los Mensajes
    • 🤖Creando un Chatbot
  • 🎛️ Módulos de navegación
    • 💻Escritorio
    • 💬Mensajes
      • Asignación y Cierre de Conversación
      • Interacción con IA
      • Asistente de IA
    • 👤Contactos
      • Detalles de contacto
      • Sugerencias de Fusión de Contactos
      • Actividad de contacto
      • Canales del contacto
      • Importar Contactos
      • Exportar contactos
      • Segmentos
    • 📣Difusiones
      • Gestión de difusiones
      • Enviar difusión
      • Difusiones y flujos de trabajo
      • Solución de conflictos
    • 📑Flujos de Trabajo
      • Disparadores
      • Pasos
    • 📊Reportes
      • Conversaciones
      • Respuestas
      • Resoluciones
      • Mensajes
      • Contactos
      • Asignaciones
      • Tabla de clasificación
      • Usuarios
      • Difusiones
  • ⚙️Ajustes
    • 🛠️Administrar Espacio de Trabajo
    • ☸️Configuración General
    • 👥Usuarios
      • Niveles de acceso
    • 🫂Equipos
    • 🔛Canales
      • Menú persistente
    • 🆙Widgets de Crecimiento
    • 🔢Campos Personalizados
    • ⛓️Integraciones
    • 📝Notas de Cierre
    • 🏃Atajos
    • 🗂️Archivos
    • 📉Exportación de Datos
    • 🧠IA
  • 👥Cuenta de usuario
    • 👤Perfil del Usuario
    • ✅Actividad del Usuario
    • 🔔Notificaciones
    • 🔁Restablecer su Contraseña
  • 📞Contactos y mensajes
    • 🎯Variables Dinámicas
    • 👁️Búsqueda de Contactos y Bandeja de Entrada Personalizada
    • 🗨️Conversaciones
  • 🌐Canales de mensajería
    • 🗃️Resumen de Canales
    • 📌Facebook Messenger
      • Chat online de Facebook
      • Respuestas privadas
      • Mensaje de etiqueta
    • 📌 Instagram
    • 📌 WhatsApp
      • WhatsApp Cloud API META
      • WhatsApp Business API
        • Configuración WhatsApp Business API
      • 360Dialog WhatsApp
      • Twilio WhatsApp
      • MensajeBird WhatsApp
      • WhatsApp de Vonage
      • Plantillas de mensajes de WhatsApp
    • 📌 Widget de Chat Online
      • Instalar en WordPress
      • Instalar en Shopify
      • Instalar en Wix
      • Instalar en Joomla
      • Instalar en Squarespace
    • 📌Mensajes de Google Business
    • 📌LINE
    • 📌 Telegram
    • 📌 Viber
    • 📌 SMS
      • Twilio SMS
      • MessageBird SMS
      • Vonage SMS
    • 📌Twitter
    • 📌 WeChat
    • 📌 Email
      • Gmail
      • Otros proveedores
    • 📌Canal Personalizado
  • 🔌Integraciones
    • 🆗Dialogflow
      • Conectando a Dialogflow
      • Gestión de intenciones
        • Parámetros
          • Etiquetado
          • Apagando el Bot
          • Cerrar una conversación
          • Asignar
          • Envío de notificaciones personalizadas
          • Darse de baja
          • Campos de contacto y valores
          • Envío de atajos
          • Envío de archivos
          • Solicitando ubicación
        • Eventos
        • Plantillas de respuesta
        • Cargas útiles personalizadas
        • Request de webhook (Fulfillment)
    • 🆕Zapier
    • 👨‍💻API de Desarrollador
    • 🕸️Webhooks
  • ☁️Api de desarrolladores
    • 📥API de Contactos
    • 💭API de Mensajes
      • API Mensajes de plantillas
  • 🤝Programas de asociación
    • 💡Visión General
    • 💲Programa de Afiliación
    • ®️Programa de Socios
      • Apariencia de la plataforma
      • Nombre de dominio personalizado
      • API de revendedor
  • 📣Enlaces de interés
  • 🦸‍♂️ Soporte Ejecutivo
  • 🚨Actualizaciones
    • Octubre 2023 [v11.0] Nuevo disparador, paso de flujo de trabajo y más
    • Octubre 2023 [v10.9] Nuevo disparador de flujos de trabajo: Anuncios de clic-to-chat
    • Octubre 2023 [v10.8] Nueva experiencia de conexión de canales
    • Septiembre 2023 [v10.7] Saluda al nuevo Asistente de IA
    • Septiembre 2023 [v10.6] Mejoras en el flujo de trabajo y más
    • Agosto 2023 [10.5] Mejoras en el comportamiento del canal y configuración de Messenger
    • Agosto 2023 [v10.4] ¡IA de Okeybot ya está aquí!
    • Agosto 2023 [v10.3] Capacidades de búsqueda mejoradas en el módulo de mensajes
    • Julio 2023 [v10.2] Experiencia al usuario mejorada: nuevas funciones
    • Julio 2023 [v10.1] Nueva integración de Make.com
    • Julio 2023 [v10.0] Nuevas incorporaciones a las plantillas de mensajes de WhatsApp
    • Julio 2023 [v9.9] Experiencia de correo electrónico nueva y mejorada
    • Junio 2023 [v9.8] Experiencia de navegación de plantillas de flujo de trabajo mejorada
    • Junio 2023 [v9.7] Mejoras en los flujos de trabajo y experiencia de usuarios
    • Junio 2023 [v9.6] Nuevas actualizaciones para mejorar la experiencia
    • Mayo 2023 [v9.5] Análisis de reportes y difusiones renovados
    • Abril 2023 [v9.4] Números de teléfonos y correos estandarizados
    • Abril 2023 [v9.3] Okeybot es un proveedor oficial de WhatsApp
    • Marzo 2023 [v9.2] Pegatinas recibidas
    • Marzo 2023 [v9.1] Nuevo Módulo de Difusiones
    • Febrero 2023 [v9.0] Nuevas plantillas de Flujos de Trabajo y mejoras en las de WhatsApp
    • Enero 2023 [v8.9] Actualizado con los nuevos eventos webhooks
    • Enero 2023 [v8.8] ¡Mensajes de Google Business está aquí!
    • Diciembre 2022 [v8.7] Activar flujos de trabajo con webhooks entrantes
    • Diciembre 2022 [v8.6] ¡Protección mejorada contra virus!
    • Diciembre 2022 [v8.5] Nuevos Widgets para su Sitio Web y Nuevos Idiomas Disponibles.
    • Noviembre 2022 [v8.4] Nuevo Diseño en Detalles del Contacto e Idioma Árabe Disponible
    • Octubre 2022 [v8.3.6] Mejoras en Mensajería y Canales, Idioma Portugués Disponible, entre otros.
    • Octubre 2022 [v8.3.5] Actualización de la API de Contactos y Mensajería
    • Septiembre 2022 [v8.3.4]Construya la automatización de forma más intuitiva con estas mejoras.
    • Septiembre 2022 [v8.3.3] WhatsApp Cloud API
    • Agosto 2022 [v8.3.2] Importar contactos 2.0 y Idioma Español Disponible
    • Agosto 2022 [v8.3.1] No más conversaciones sin asignar cuando se cierran
    • Marzo 2022 [v8.3] Nuevos Accesos Directos, Variables y Condiciones de Flujo de Trabajo
    • Febrero 2022 [v8.2] Módulo de Mensajes Rediseñado, Nueva Integración de Canales Personalizados y más
    • Diciembre 2021 [v8.1] Nuevo Diseño de Navegación y Nuevos Pasos de Flujos de Trabajo
    • Noviembre 2021 [v8.0] Flujos de Trabajo (Automatización 2.0), y API de Mensajes de Plantilla
    • Agosto 2021 [v7.9] Plan Empresas, Mejoras en Mensajes de Plantillas de WhatsApp.
    • Agosto 2021 [v7.8] IMAP/SMTP, Mejoras Chat Web, Mensajes interactivos WhatsApp y más.
    • Julio 2021 [v7.7] ¡Instagram, mejoras en 360Dialog y más!
    • Junio 2021 [v7.6] Informes 2.0, Nota de cierre y más mejoras
    • Mayo 2021 [v7.5] Informes, Dashboard 2.0, Exportación de datos, Mensajes de voz, Zona horaria y más!
    • Febrero 2021 [v7.4] Combinación de contactos
Con tecnología de GitBook
En esta página
  • ¿Cómo funciona?
  • Recibir mensaje:
  • Enviar mensaje:
  • Configuración
  • Paso 1: Crear un canal
  • Paso 2: Pasar mensajes a Okeybot
  • Paso 3: Manejar mensajes salientes desde Okeybot
  • Tipo de mensaje
  • Solucionador de problemas

¿Te fue útil?

  1. Canales de mensajería

Canal Personalizado

Integrar la aplicación de mensajería de terceros en Okeybot.

AnteriorOtros proveedoresSiguienteDialogflow

Última actualización hace 3 años

¿Te fue útil?

Esta función se encuentra actualmente en fase Beta. ¡Si tiene algún problema, póngase en contacto con nosotros

Consejos: También le proporcionamos un ejemplo de canal personalizado que puede intentar implementar en su servidor.

¿Cómo funciona?

Recibir mensaje:

Para recibir un mensaje a través de un canal personalizado, se deben seguir los siguientes pasos:

  1. 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).

Enviar mensaje:

Para enviar un mensaje a través de un canal personalizado, se deben seguir los siguientes pasos:

  1. 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).

  2. 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.

Configuración

Paso 1: Crear un canal

  1. Seleccionar Canal Personalizado (Custom Channel).

  2. Introduzca la URL base de la API.

  3. 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:

    1. 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

    2. ID personalizado: Utilícelo si el proveedor de servicios de mensajería reconoce contactos en función de un ID generado a medida.

      1. La longitud máxima de caracteres es de 50.

      2. A-Z, a-z, 0-9, _ , =, + , / y @ están permitidos.

  4. El siguiente cuadro de diálogo proporcionará el ID de canal, el token de API y la URL del Webhook, p. ej.

    1. ID de canal: gfd8g7fd89dgfd

    2. API Token: aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd

    3. 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.

curl -X POST \
  **<https://app.okeybot.com/custom/webhook**> \
  -H 'authorization: Bearer aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
  "channelId": "gfd8g7fd89dgfd",
  "contactId": "+60177872890",
  "events": [
    {
      "type": "message",
      "mId": "xcvzzxcxczxczxc",
      "timestamp": 2132131321000,
      "message": {
        "type": "text",
        "text": "Hello World"
      }
    }
  ],
  "contact": {
    "firstName": "John",
    "lastName": "Doe",
    "profilePic": "<https://static.independent.co.uk/s3fs-public/thumbnails/image/2015/07/08/14/pic.jpg>",
    "countryCode": "MY",
    "email": "john@okeybot.com",
    "phone": "+60177872890",
    "language": "es"
  }
}'

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)

"OK"

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.

curl -X POST \
  <API Base URL>/message \
  -H 'authorization: Bearer aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
	"channelId": "gfd8g7fd89dgfd",
	"contactId": "+60177872890",
	"message": {
		"type": "text",
		"text": "Hello World"
	}
}'

Respuesta de éxito (Estado HTTP → 200)

{
	"mId": "1640141607842"
}

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.

const {validationResult} = require('express-validator');

const validateToken = (req, res, next) => {
    const apiToken = <<API Token>>
    const bearerToken = req.headers.authorization;

    if (!bearerToken)
        return res.send(401)

    const token = bearerToken.substring(7, bearerToken.length);

    if (apiToken !== token) {
        return res.send(401)
    }
    next();
};

module.exports = {
    validateToken
};

Consejos: También le proporcionamos un ejemplo de canal personalizado que puede intentar implementar en su servidor.

Tipo de mensaje

Muestra de texto

{
  "type": "text",
  "text": "Welcome to Okeybot",
}

Campos

Campo

Descripción

Validación

tipo

Tipo de mensaje

Requerido. Texto.

texto

Texto de mensaje

Requerido. Longitud máxima de 7,000 caracteres.

Ejemplo para archivo multimedia

{
  "type": "attachment",
  "attachment": {
    "type": "image|video|audio|file",
    "url": "https://abc/japan.png",
    "mimeType": "image/png",
    "fileName":"company logo.png",
    "description": "latest company logo"
  }
}

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

Ejemplo para localización

{
  "type": "location",
  "latitude": 0.123456,
  "longitude": -0.1234,
  "address": "Sky Suites, Jalan P. Ramlee, Kuala Lumpur, 50250 Kuala Lumpur, Wilayah Persekutuan Kuala Lumpur"
}

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.

Ejemplo para respuesta rápida

{
  "type": "quick_reply",
  "title": "Select your preferred language",  
  "replies": [
    "Malay",
    "Spanish"
  ]
}

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

Solucionador de problemas

Su servidor de integración personalizado recibirá el mensaje y lo publicará en (en formato de ).

recibirá la solicitud post, guardará el mensaje y lo mostrará en el módulo de mensajería.

Cuando un Usuario/Flujo de trabajo / Difusión intente enviar un mensaje, llamará a su servidor de integración personalizado con la carga útil del mensaje (en formato de ).

En la plataforma , vaya a Configuración > Canales y haga clic en el botón AGREGAR CANAL.

Paso 2: Pasar mensajes a

La URL del Webhook se utiliza para PUBLICAR los Mensajes, Ecos de Mensajes y Recibos de Mensajes en la plataforma .

El siguiente código llamará al webhook en la plataforma y estará creando el contacto (si no existe) y guardando el mensaje contra el contacto.

Requerido. Campo único. Es generado por .

Requerido. ID único de contacto de . Max 50 carcteres.

Paso 3: Manejar mensajes salientes desde

Aquí está el ejemplo de cURL de llamando al punto final.

Esta función se encuentra actualmente en fase Beta. ¡Si tiene algún problema, póngase en contacto con nosotros !

🌐
📌
Okeybot
Okeybot
Okeybot
Okeybot
Okeybot
Okeybot
Okeybot
Okeybot
Okeybot
Okeybot
Okeybot
aquí
Okeybot
Okeybot
aquí!
Flujo del canal personalizado