Integrar WikiChat con Make / Integromat

Desde tu panel, ve a Integraciones en el menú lateral y selecciona Make. Después, da clic en el botón para iniciar la integración con Make.

Serás dirigido a una página web donde, si ya iniciaste sesión en Make, la app de WikiChat se añadirá automáticamente.

Configura WikiChat en tu cuenta de Make

Ahora podrás crear un nuevo escenario en Make. Busca la app de WikiChat y agrégala al escenario.

Cuando la app esté dentro del escenario tendrás acceso a diferentes disparadores y acciones para tus automatizaciones.

• Si deseas crear una etiqueta, primero debes conectar tu canal de WikiChat.
• Necesitarás tu API Key para conectar tu cuenta. Si aún no tienes una, puedes crearla desde tu panel de WikiChat.
• Ingresa tu API Key y haz clic en Continuar.

Una vez conectado, ya puedes crear y configurar tus automatizaciones entre WikiChat y otras plataformas desde Make.

Paso 1: Crea tu API Key en X.AI

Ingresa a la plataforma de X.AI. Dentro de tu cuenta, sigue las instrucciones para generar tu clave API única.

Paso 2: Copia y espera la clave

Copia la API key que generas y espera a que el sistema confirme su disponibilidad para uso. Asegúrate que el estado indique que está lista.

Paso 3: Configura tu clave API en WikiChat

1. Ve a la sección Integraciones de WikiChat.
2. Selecciona X.AI e ingresa tu clave API en el campo indicado.
3. Guarda y verifica que el estado cambie a “Verificada”.

Ya puedes empezar a usar X.AI en tus flujos.

Usar X.AI en tus flujos

1. Abre el bot desde WikiChat.
2. Dirígete a un Nodo de Acción.
3. Selecciona Integraciones y elige X.AI.

Aquí puedes configurar las acciones, como Chat Completion, con las siguientes opciones:

• System Message: Describe la función o rol de tu bot para dar contexto a la IA.
• Message: Es el texto que ingresa el contacto y que la IA debe responder. Puedes usar {{last_text_input}}.
• System JSON Field ({{XAi}}): Guarda el historial de conversación. Límite de 20,000 caracteres.
• Model: Elige el modelo de IA. Por defecto es grok-beta.
• Max Tokens: Limita el número de tokens de la respuesta.
• Temperature: Ajusta la creatividad de la respuesta.
• Presence Penalty y Frequency Penalty: Controla repeticiones y originalidad.
• Stop Sequences: Define hasta 4 secuencias para detener respuesta.
• Number of Completions: Elige cuántas respuestas genera por petición (más, requiere más consumo).

Ejemplo de respuesta

{
  "id": "3b52aa21-8cba-4499-9732-2133d4bbe1f2",
  "object": "chat.completion",
  "created": 1732584765,
  "model": "grok-beta",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Para reservar, dime fecha, hora, personas y tus datos para confirmar."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 78,
    "completion_tokens": 139,
    "total_tokens": 217
  }
}

Crear flujos avanzados

Puedes construir flujos que usen la respuesta de X.AI como parámetro personalizado y personalizar la interacción según el contexto del contacto.

Algunos ejemplos de uso creativo:

• Automatizar reservas.
• Responder preguntas frecuentes contextualizadas.
• Ofrecer recomendaciones personalizadas.

Al aprovechar X.AI en WikiChat creas experiencias para tus contactos más intuitivas y potentes.

Cómo integrar WikiChat con Zapier

1. Desde tu panel principal, ve al menú de Integraciones y selecciona Zapier.
2. Haz clic en Iniciar integración con Zapier.

Serás redirigido a una web para probar la app de WikiChat. Haz clic para añadir la app a tus integraciones personalizadas dentro de Zapier.

3. En la siguiente página, haz clic en Añadir conexión y te pedirá tu token API.

Para generar tu token API, revisa la guía de generación de API en WikiChat.

4. En Zapier, dirígete a Mis Apps > Integraciones Personalizadas. Presiona la app WikiChat para conectar tu cuenta.
5. Pega el token API y haz clic en Sí, continuar. Zapier conectará tu chatbot de WikiChat y lo verás en tu lista de conexiones.

Cómo usar Zapier en WikiChat

Puedes usar Zapier directamente en tus flujos. Dentro de cualquier flujo, crea un bloque de acción, elige Integraciones y selecciona Zapier. Ingresa el nombre del evento definido en tu zap de Zapier. El nombre debe ser exacto para funcionar correctamente.

Para una guía visual, revisa nuestros videos tutoriales de WikiChat sobre integración con Zapier.

Conexión con SendGrid

Para conectar SendGrid, ingresa a Integraciones y selecciona Email Marketing > SendGrid.

• Necesitas: API Key, Nombre del remitente, Email del remitente y Dominio de recepción.

Obtener API Key

1. Entra a SendGrid y ve a Configuración > API Keys.
2. Haz clic en "Crear API Key", asígnale un nombre, selecciona acceso completo y guárdala.
3. Copia la llave y resguárdala, ya que solo la verás una vez.

Autenticación de Dominio

1. Desde el menú, ve a Autenticación del remitente.
2. Haz clic en "Autentica tu dominio" y sigue los pasos para elegir tu proveedor DNS.
3. Agrega los registros CNAME que SendGrid te proporciona a tu dominio.
4. Marca la opción "He agregado estos registros" y verifica el dominio.

Verificación de un remitente único

1. Haz clic en "Verificación de remitente único".
2. Llena tus datos y crea el remitente.
3. Verifica el email haciendo clic en el enlace enviado.

Completar integración en WikiChat

• Rellena los campos de integración en WikiChat con los datos obtenidos.
• Guarda y copia la URL de webhook generada.
• En SendGrid, ve a Ajustes > Inbound Parse, añade el dominio y pega la URL del webhook.

Esto habilitará la sincronización bidireccional de correos en WikiChat.

Enviar correos desde un bot

Puedes añadir el paso "Enviar email" al flujo del bot, definiendo remitente, destinatario, asunto y mensaje.

• Responde directamente a correos y consulta conversaciones desde la bandeja de entrada en WikiChat.

Mira un video tutorial de configuración aquí: Ver tutorial

¿Quién debe usar los webhooks?

Esta función está pensada para desarrolladores con experiencia usando APIs y manejo de plataformas externas.

Paso a paso para configurar un webhook

1. Configura tu URL de Webhook:
   • Entra a Integraciones y luego a Webhooks.
   • Puedes agregar encabezados propios para mayor seguridad.
   • Proporciona la URL donde deseas recibir la información.
2. Activa el Webhook en tu Canal:
   • Ingresa a la configuración del canal (por ejemplo, WhatsApp o SMS).
   • En Configuración de Chat en Vivo, selecciona Webhook.
3. Utiliza la acción Pausar Automatización:
   • Incluye "Pausar Automatización" en tu flujo donde quieras pasar la conversación a tu plataforma.
   • Tras ese punto, cualquier mensaje del contacto será enviado a tu Webhook URL.

Ejemplo de payload

El contenido enviado a tu Webhook es un JSON con estos campos principales:

• meta: identificadores de usuario, agente, flujo y equipo.
• message: ID del mensaje, tipo, remitente, tipo de contenido, IDs de agente.
• payload: texto del mensaje, usuario, fecha, timestamp, estado de entrega y visto.

{
  "meta": {
    "user_ns": "Identificador único del contacto",
    "agent_id": "ID del agente",
    "flow_ns": "Identificador único del flujo",
    "team_id": "ID del equipo"
  },
  "message": {
    "_id": "ID único del mensaje",
    "mid": "ID en el canal",
    "type": "Tipo de mensaje",
    "msg_type": "Tipo de contenido",
    "sender_id": "ID del remitente",
    "assigned_agent_id": "ID del agente asignado"
  },
  "payload": {
    "text": "Texto del mensaje",
    "username": "Usuario",
    "date": "Fecha",
    "timestamp": "En milisegundos",
    "is_delivered": 1,
    "seen": "Campo visto (puede estar vacío)"
  }
}

Cómo responder usando la API de WikiChat

Al recibir el mensaje, puedes usar la API de WikiChat para responderle al contacto. Usa los campos user_ns y flow_ns para dirigir el mensaje a la conversación correcta.

Recuerda que los webhooks permiten manejar diversos tipos de mensajes y requieren conocimientos técnicos. Consulta nuestra documentación de API para más detalles.

Conexión con Facebook Ads

1. Dirígete a Integraciones y selecciona Listar Negocios con Cuentas Publicitarias.
2. Elige la cuenta publicitaria que deseas manejar.
3. Conecta también tu cuenta de Facebook Business Manager desde Integraciones.
4. Conecta tu cuenta de Facebook en el canal correspondiente y vincúlala con tu bot.

Usa el Nodo de Acción

1. Inserta un Nodo de Acción en tu flujo.
2. Accede a Acciones Avanzadas.
3. Selecciona API de Facebook para trabajar con las opciones disponibles.

Funciones para Anuncios de Página

• Listar publicaciones publicitarias para ver los anuncios activos.
• Obtener comentarios en publicaciones de anuncios.
• Responder automáticamente a comentarios según palabras clave.
• Listar formularios de leads conectados a tus anuncios.
• Consultar preguntas de formularios de leads.
• Obtener leads capturados por tus formularios publicitarios.
• Acceder a detalles de la generación de leads por anuncio.

Funciones del API de Facebook Ads

• Listar todas tus cuentas de anuncios de Facebook asociadas.
• Consultar detalles de una cuenta o campaña específica.
• Administrar audiencias personalizadas (crear, modificar, eliminar).
• Agregar o quitar contactos a audiencias por correo o teléfono.

Puedes personalizar la automatización para potenciar el alcance y resultados de tus campañas.

Conectar CRM V2

1. Accede a tu panel de WikiChat.
2. Dirígete al apartado de Integraciones.
3. Selecciona CRM V2, inicia sesión con tu correo y contraseña.
4. Conecta tu cuenta y haz clic en Confirmar. Serás redirigido de vuelta a WikiChat.

Acciones disponibles

• Gestión de ubicaciones: obtener información, crear, actualizar y eliminar etiquetas de ubicación.
• Contactos: buscar, crear, actualizar, eliminar, asignar notas o etiquetas, buscar duplicados y unir información (upsert).
• Mensajería: envía SMS y correos electrónicos por ID de contacto.
• Campañas: gestionar campañas y asociar contactos.
• Calendarios: obtener, crear, actualizar, eliminar eventos y consultar disponibilidad.
• Workflows: agregar o quitar contactos de flujos automatizados.
• Campos y valores personalizados: crear, consultar, actualizar o eliminar campos personalizados.
• Oportunidades: buscar, crear, actualizar y eliminar, también permite upsert y gestionar el estado.
• Equipo: consultar, crear, actualizar y eliminar miembros.
• Plantillas: obtener plantillas de SMS/email.

Automatizaciones y triggers

Solo están disponibles en la API V2. Puedes activar flujos en WikiChat al crear, borrar o modificar contactos, campañas, tareas, oportunidades, citas y etiquetas.

Recuerda que el trigger solo funcionará cuando el contacto haya sido creado desde WikiChat.

Paso a paso

1. Crea una fuente de datos de mensajería en Meta Events Manager: Visita Meta Events Manager. Haz clic en + Agregar fuente de datos y selecciona Mensajería.
2. Integra tu canal:
   • Para Facebook: Elige Facebook, selecciona tu página y otorga permisos. Si no aparece, verifica que seas administrador y que tu página esté activa y conectada a un Business Manager.
   • Para Instagram: Si no aparece, abre la app > Configuración > Centro de Cuentas > Conectar con Facebook.
   • Para WhatsApp: Solo puedes usar un número de WhatsApp Business Platform conectado con un ID de página de Facebook.
3. Asigna un nombre único a la fuente de datos (evita usar exactamente el nombre de la página) y completa la integración.
4. Copia las credenciales: En la pestaña Configuración del origen de datos, copia el Data Set ID y el Access Token.
5. Agrega las credenciales en WikiChat: Ve a Configuración del espacio de trabajo > Integraciones > Meta Conversions API. Pega ambos datos y guarda.
6. Envia eventos desde tu flujo: Abre el Flow Builder, añade un nodo de acción y selecciona Acciones de eventos > APIs Facebook/Instagram/WhatsApp > Meta Conversions API.
7. Testea los eventos: En el administrador de eventos, ve a "Eventos de prueba" y copia el código de prueba. Pégalo en el nodo de acción y ejecuta el flujo para verificar que el evento llegue.
8. Click to WhatsApp Ads (CTWA): Si usas CTWA, captura el referral ID y el Page ID en el flujo. Sigue este tutorial sobre cómo guardar el CTWA_clid.

Notas importantes y solución de problemas

• Solo puedes usar números de WhatsApp Business Platform.
• Las páginas deben estar conectadas a un Business Manager y activas.
• Verifica que el token esté vigente y generado correctamente.
• Para campañas CTWA necesitas referral ID y Page ID.
• Si tienes problemas de permisos o restricción de cuenta publicitaria, revisa la configuración y la facturación en Meta.

Puedes reutilizar la misma fuente de datos en varios flujos. Solo tendrás que reintegrar si necesitas separar eventos por marca o canal. Siempre haz pruebas antes de publicar flujos. Si necesitas soporte, contacta al equipo WikiChat.

Cómo obtener tu API Key de Deepseek

Debes autenticarte en tu panel de Deepseek para generar tu token API.

Configuración de Deepseek en WikiChat

• Ve a Integraciones > Inteligencia Artificial.
• Selecciona Deepseek.
• Introduce tu API token de Deepseek para conectar la integración.

Una vez configurado, tendrás acceso a las funciones de Deepseek desde el Flow Builder de WikiChat usando el nodo de Integraciones.

Uso dentro del Flow Builder

• Crea un nodo de acción y selecciona Integraciones.
• Elige Deepseek del menú para acceder a sus funciones.

Acciones disponibles de Deepseek

• Crear Chat Completion: personaliza respuestas dinámicas en tus conversaciones.
• Limpiar historial recordado: elimina el historial para controlar tiempos de ejecución y optimizar consumo de tokens.
• Listar modelos:
  • Deepseek Chat: Ideal para conversaciones rápidas.
  • Deepseek Reasoner: Perfecto para respuestas estructuradas o lógicas como soporte técnico.

Ejemplo de flujo de prueba

Configura los siguientes parámetros para obtener óptimos resultados:

• Max Tokens: 200
• Temperature: 0.4
• Recuerda activar la opción de historial si quieres mantener la continuidad de conversación.

Puedes crear un agente para simular conversaciones naturales y aplicar lineamientos personalizados, como tono de voz o restricciones temáticas.

Conecta tu cuenta de Facebook Business

Haz clic en el botón "Conectar Facebook Business". Autoriza el acceso a WikiChat y da clic en "Continuar". Al regresar, tu cuenta de Facebook Business ya estará conectada.

Desconectar tu cuenta de Facebook Business

Puedes desconectar la cuenta en cualquier momento desde el botón de desconexión.

Sincronizar el catálogo de productos de Facebook

Para sincronizar tu catálogo, haz clic en "listar catálogos de negocios" y aparecerán todos tus catálogos de productos de Facebook.

Después, selecciona "Facebook → Local" para transferir los productos al ecommerce de WikiChat.

• Nombre del producto
• Descripción
• Imagen
• Precio
• SKU
• Tipo de producto
• Vendedor

Asegúrate de que el valor SKU coincida con el Content ID de tu catálogo de Facebook para que funcione correctamente en el ecommerce y canal WhatsApp.

Cambiar la moneda

Si usas una moneda diferente en Facebook, actualiza la misma moneda en los ajustes de ecommerce de WikiChat para evitar errores.

Ventajas de la sincronización

• Permite mostrar productos en catálogos de WhatsApp y usar mensajería de producto.
• Puedes filtrar y mostrar productos dinámicamente usando variables JSON en los mensajes del canal WhatsApp.
• El trigger de consulta de producto en WhatsApp usa el SKU, mostrando datos automáticamente.
• Visualiza los detalles de productos sincronizados en la sección de órdenes del sistema ecommerce de WikiChat.