Conectar intoCHAT con Zapier y Make
Usa intoCHAT en Zapier y Make: disparadores instantáneos para leads nuevos, formularios enviados, reservas, peticiones de devolución, traspasos y peticiones de chat en vivo, acciones para chatear con un agente y añadir conocimiento, y cómo conectar con una clave de API.
intoCHAT tiene apps para Zapier y Make. Inician un Zap o un escenario en el momento en que ocurre algo en tu agente, como un lead nuevo, y permiten que un Zap o un escenario envíe un mensaje a tu agente o añada algo a su conocimiento. Están construidas sobre la API REST y los webhooks, así que trabajan con los mismos datos y los mismos límites.
Qué planes incluyen las apps
Las apps usan la API REST, que está incluida en Starter, Pro y Enterprise. En Free no puedes crear la clave de API que necesitan. Si tu cuenta vuelve a Free, las apps dejan de funcionar hasta que vuelva a estar en Starter o superior. Consulta Qué planes incluyen la API.
Cada respuesta que el agente escribe para Send a message to an agent cuenta como un mensaje de tu plan, igual que en el widget del chat. Los disparadores y las demás acciones no gastan mensajes.
Qué hay disponible
Disparadores
| Disparador | Se inicia cuando | Evento |
|---|---|---|
| New lead | Un visitante deja sus datos de contacto, en el formulario de leads o en el chat. | lead.created |
| New form submission | Un visitante envía uno de tus formularios de chat. | form.submitted |
| New booking | Un visitante reserva una cita desde el chat. Consulta Reservas con Cal.com o Calendly. | booking.created |
| New return request | Un visitante pide devolver o cambiar artículos de un pedido verificado. Consulta Estado de pedidos y devoluciones. | return.requested |
| Hand-off requested | El agente envía una conversación a tu equipo por correo. Consulta Traspaso por correo. | handoff.requested |
| Live chat requested | El agente pide a tu equipo que se una a un chat. Consulta Chat en vivo. | live_chat.requested |
| New conversation | Empieza una conversación nueva con el agente. | conversation.created |
Los seis primeros son instantáneos: intoCHAT envía el evento en cuestión de segundos, igual que envía un webhook. New conversation no tiene webhook, así que la herramienta busca conversaciones nuevas según su propio calendario, por ejemplo cada pocos minutos en Zapier, según tu plan de Zapier o Make.
Cada disparador pide el Agent que vigila; la lista muestra todos los agentes de tu cuenta. La salida del disparador son los data del evento, con los campos descritos en Qué se envía, por ejemplo email, name y conversationId para un lead nuevo.
Acciones
| Acción | Qué hace |
|---|---|
| Send a message to an agent | Envía un mensaje y devuelve la respuesta del agente y el ID de la conversación. Indica un Session ID, como el correo del cliente, para continuar cada vez la misma conversación. Consulta Enviar un mensaje. |
| Add a Q&A pair | Añade una pregunta y su respuesta al conocimiento del agente e inicia el entrenamiento. Una pregunta que el agente ya tiene recibe la respuesta nueva. |
| Add a text snippet | Añade un texto con título al conocimiento del agente e inicia el entrenamiento. |
| Find conversation (una búsqueda en Zapier, Get a conversation en Make) | Busca una conversación por su ID, con su transcripción. Úsala después de un disparador para leer el chat entero. |
El conocimiento nuevo cuenta para los caracteres de entrenamiento del agente, y el agente lo usa en cuanto termina el entrenamiento. Consulta Texto y preguntas.
Conectar con una clave de API
- En intoCHAT, en la barra lateral, en Settings, haz clic en API keys.
- En Create a key, ponle a la clave un Name que reconozcas, por ejemplo
Zapier. - En Access, deja Every scope, including ones added later. Para limitar la clave, elige Only the scopes I choose y marca los ámbitos de la tabla de abajo.
- Haz clic en Create key y después en Copy.
- En Zapier o Make, añade un paso de intoCHAT, elige conectar una cuenta nueva y pega la clave en API key.
Usa una clave por herramienta, para poder revocar una sin detener la otra. Consulta Crear una clave de API.
| Ámbito | Necesario para |
|---|---|
agents:read | Conectar, y la lista Agent |
webhooks:write | Los disparadores instantáneos |
leads:read | Los datos de ejemplo de New lead, New form submission, New booking y New return request en Zapier |
conversations:read | New conversation, Find conversation, y los datos de ejemplo de Hand-off requested y Live chat requested en Zapier |
chat | Send a message to an agent |
sources:write | Add a Q&A pair y Add a text snippet |
Cómo funcionan los disparadores instantáneos
Cuando activas un Zap, o añades un disparador instantáneo a un escenario de Make, la herramienta pide a intoCHAT que envíe ese evento a una dirección propia. intoCHAT lo guarda como un webhook del agente:
- Aparece en la pestaña Leads del agente, en Webhooks, marcado via Zapier o via Make. Consulta Webhooks creados por integraciones.
- Se envía, se reintenta y se registra como cualquier webhook, así que Recent deliveries muestra lo que se envió a la herramienta.
- Cuando desactivas el Zap, o eliminas el disparador o el escenario en Make, la herramienta vuelve a eliminar el webhook.
El webhook de cada evento va firmado, pero Zapier y Make no pueden comprobar la firma, así que las apps no usan el secreto de firma. La dirección que la herramienta da a intoCHAT es privada de tu Zap o escenario.
Datos de ejemplo
Cuando pruebas un disparador, Zapier carga hasta tres de los últimos eventos reales de ese tipo del agente. Si todavía no hay ninguno, por ejemplo antes de tu primera reserva, muestra un ejemplo con los mismos campos, para que puedas asignarlos igualmente. En Make, el ejemplo viene con el módulo; ejecuta el escenario una vez y provoca un evento real para ver datos reales.
Revocar una clave
Revocar una clave en Settings, API keys detiene las apps que la usan desde su siguiente petición, y elimina los webhooks que esa clave creó para Zapier o Make, con su historial de envíos. Los Zaps y los escenarios siguen activos, pero no reciben más eventos. Para volver a conectar, crea una clave nueva, actualiza la conexión en Zapier o Make y desactiva y vuelve a activar el Zap (en Make, vuelve a crear el webhook del disparador), para que se cree un webhook nuevo.
Límites
- Se aplican los límites de la API REST: 60 peticiones por minuto por clave, y los mensajes del plan para Send a message to an agent. Consulta Límites de frecuencia.
- Un agente puede tener hasta 25 webhooks de integraciones, aparte de los 5 que añades tú. Desactivar los Zaps que ya no usas los libera.
- Los disparadores no incluyen los cambios posteriores, como una reserva cancelada o una petición de devolución resuelta.
- Los datos de ejemplo de Hand-off requested reconstruidos a partir de traspasos pasados no tienen
summary(no se guarda); los eventos en directo sí lo tienen.
Solución de problemas
- La conexión falla. Comprueba que la clave empieza por
ic_live_, que no se ha revocado y que tu cuenta está en Starter o superior. - Un disparador dice que a la clave le falta un ámbito. Crea una clave con Every scope, o con los ámbitos de la tabla de arriba, y vuelve a conectar.
- Un Zap ha dejado de recibir eventos. Mira la pestaña Leads del agente: si su webhook via Zapier ya no está, se eliminó en intoCHAT o se revocó su clave. Desactiva y vuelve a activar el Zap para suscribirlo de nuevo. Si el webhook está en Paused, vuelve a activarlo.
- Demasiados webhooks. Desactiva los Zaps o elimina los disparadores de Make que ya no usas, o elimina sus webhooks en la pestaña Leads.
Siguientes pasos
- Qué contiene cada evento: Webhooks.
- Todos los endpoints que usan las apps: API REST.
- Publica los mismos eventos en un canal de Slack sin ninguna herramienta: Avisos en Slack.