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.

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.

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

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.

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.

¿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 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

Configuración de perfil SMTP

Para agregar un perfil SMTP ve a Integraciones > SMTP y crea uno nuevo. Completa los campos solicitados: nombre del remitente, correo, servidor SMTP, puerto, encriptación, usuario y contraseña. Al guardar, recibirás un mensaje indicando si la verificación fue exitosa.

Cómo conectar Gmail por SMTP

1. Activa la autenticación en dos pasos en tu cuenta de Google (configurar aquí).
2. Genera una contraseña de aplicación desde Seguridad > Contraseñas de aplicaciones. Selecciona Dispositivo: Otro, nombra "WikiChat" y genera la contraseña.
3. Copia esa contraseña y pégala en tu perfil SMTP creado en WikiChat junto con el resto de los datos requeridos.
4. Guarda los cambios y verifica que tu cuenta quede registrada y verificada en WikiChat.

Integración SMTP con Office365

1. Ingresa a tu cuenta de Office365 y ve a Información de seguridad.
2. Agrega un método de inicio de sesión, selecciona Contraseña de aplicación, sigue el flujo y copia la contraseña generada.
3. En WikiChat crea tu perfil SMTP:
   • Servidor: smtp.office365.com
   • Puerto: 587
   • Encriptación: TLS
   • Usuario: tu correo
   • Contraseña: la contraseña de aplicación generada
4. Guarda y verifica tu conexión. Ya puedes seleccionar este perfil al enviar correos desde cualquier canal en WikiChat.

Enviar notificaciones por email

Después de agregar tu integración SMTP, podrás elegir tu perfil de envío dentro de los pasos de email en los flujos de WikiChat.

1. Añade un paso de Enviar Email desde el botón de pasos o haciendo clic derecho en el espacio de trabajo.
2. Configura remitente, destinatario, asunto, mensaje y adjunto si aplica.

Para depuración puedes usar herramientas externas como GMass SMTP Tester. Si tu SMTP funciona ahí pero falla en WikiChat, por favor contacta soporte con tus datos de acceso temporales para ayuda.

Cómo conectar Google Spreadsheet

1. Desde el panel principal, haz clic en Integraciones en el menú lateral.
2. Selecciona Google Spreadsheet de la lista de integraciones disponibles.

Desconectar integración previa

Si ya tienes una cuenta conectada, haz clic en Desconectar para eliminar la integración anterior y realizar una nueva conexión.

Iniciar sesión con Google

1. Haz clic en Iniciar sesión con Google.
2. Elige la cuenta de Google que quieres vincular.
3. Completa el proceso de autenticación. Serás redirigido de nuevo a WikiChat.

Agregar tus hojas de cálculo

Puedes vincular tus hojas de cálculo de dos formas:

• Agregar por URL: Pega el enlace de la hoja de Google y asígnale un nombre para identificarla fácilmente.
• Agregar directamente: Haz clic en Agregar hoja y selecciona entre tus hojas disponibles desde Google.

Las hojas que agregues estarán disponibles para usar en tus flujos automáticos.

Acciones disponibles en flujos

Dentro del constructor de flujos, podrás usar las siguientes acciones sobre Google Spreadsheet:

• Insertar fila
• Buscar fila por valor
• Obtener varias filas
• Actualizar fila

Estas funciones te permiten manipular y consultar fácilmente tu información en Google Sheets desde WikiChat.