Ringostat
Entrar

Pedidos y leads: KeyCRM

~8 min · El agente encuentra los pedidos del cliente en KeyCRM, los confirma o cancela, deja una nota al gestor y convierte las llamadas entrantes en leads.
Qué obtendrás:
por el número del cliente, el agente ve sus pedidos en KeyCRM: estado, productos, importe, entrega y número de seguimiento. Tras la conversación pone al pedido el estado «confirmado», «rechazado» o «volver a llamar» y añade un resumen para el gestor. Para una consulta entrante sin pedido crea una tarjeta en el embudo. Comprueba el stock por SKU.
Antes de empezar:
una cuenta de KeyCRM en la que veas la clave API (se muestra al propietario de la cuenta), derechos de administrador del proyecto en Voice Agent y una campaña «Voice Agent».

1. Copia la clave API en KeyCRM

En KeyCRM abre «Ajustes» → «Generales» y copia la clave de la fila «Clave API». Si todavía no hay clave, pulsa «Generar clave API».

2. Conecta la integración

  1. 1
    Menú izquierdo → «Integrations» → «Ready-made» → pestaña «CRM» → tarjeta «KeyCRM» → «Connect».
  2. 2
    Pega la clave en «API key» y pulsa «Save».
  3. 3
    Pulsa «Test connection». Si todo está bien, aparecerá «Connection works: the API key reads your order statuses.» y los estados y embudos se cargarán en el formulario de abajo.
La clave se guarda cifrada y no se muestra después de guardarla. Para sustituirla, escribe una nueva; un campo vacío conserva la guardada. Tras escribir una clave nueva, guárdala primero y solo después carga los estados: las listas se leen con la clave guardada.

3. Asocia los resultados de la llamada a estados de pedido

En el bloque «Orders after the call» pulsa «Load statuses from KeyCRM»: los campos se convierten en listas con los estados de tu cuenta. Hasta entonces puedes escribir los ID de los estados a mano.

Let the agent change order statusesEl interruptor principal. Desactivado: el agente solo lee pedidos y deja comentarios, y la asociación de abajo se conserva. Activado por defecto.
Customer confirmedEl estado que pone el agente cuando el cliente confirma el pedido.
Customer declinedEl estado para un rechazo o una cancelación.
Asked to call backEl estado cuando el cliente pide que lo llamen más tarde.
No answerEl estado para una llamada en la que el cliente no llegó a hablar. Solo lo pone una herramienta tras la llamada (ver abajo).
Statuses the agent may changeLos pedidos en otros estados (ya enviados, pagados) no se tocan. Vacío: cualquier estado. Normalmente solo «Nuevo» y «Pendiente de confirmación».
Un resultado sin estado no está disponible para el agente: no cambiará un pedido si no hay un estado para ese resultado. Los estados cambian en la base real de la tienda, así que haz las primeras llamadas de prueba con el interruptor desactivado o con pedidos de prueba.

4. Leads y límite de solicitudes

Let the agent create leadsDesactivado: el agente no crea tarjetas en el embudo, y el embudo elegido se conserva.
Pipeline for new leadsDónde crea el agente una tarjeta para una consulta sin pedido. Vacío: el agente no crea leads.
Lead sourceOpcional. La fuente de KeyCRM que se pone en las tarjetas nuevas.
Daily API request limitKeyCRM permite 20 solicitudes por minuto por clave, compartidas con tu web y los marketplaces. El agente usa como máximo 15 por minuto y como máximo este número al día (5000 por defecto).

Guarda los ajustes.

5. Añádela a una campaña

  1. 1
    Editor de la campaña → tarjeta «AI tools» → elige KeyCRM: todas sus herramientas o solo las marcadas.
    Herramientas de IA
    Herramientas de IA
  2. 2
    Guarda la campaña.
search_entities_by_phoneEl comprador y sus últimos pedidos por el número del cliente: estado, productos, importe, entrega, número de seguimiento. El agente la llama primero.
get_orderLos detalles de un pedido del cliente. El agente trata el comentario del gestor como nota interna y nunca lo lee al cliente.
update_order_statusPone el estado del pedido según el resultado de la llamada: confirmed, declined, callback o no_answer, solo los que tienen estado asignado.
add_order_commentAñade para el gestor una nota con fecha y la marca Voice Agent. El comentario existente se conserva.
create_lead, update_leadUna tarjeta en el embudo con el teléfono del cliente, nombre, comentario y productos por SKU; cambiar su estado, la hora de volver a llamar, una nota.
list_order_statuses, list_stagesLos estados de pedido y los estados del embudo, para que el agente nunca invente un ID.
check_stockSi un producto está en stock por SKU: nombre, precio y cantidad libre.
El agente solo trabaja con pedidos cuyo teléfono de comprador o destinatario coincide con el número del cliente. El pedido de otra persona no está disponible ni con su número exacto. KeyCRM no permite buscar tarjetas del embudo por teléfono, así que el agente solo cambia la tarjeta creada en esta llamada o aquella cuyo ID llegó en el número como lead_id.

Escenario 1. Confirmar pedidos nuevos

Una campaña saliente llama a los compradores de pedidos nuevos. Sube los números en un CSV con las columnas phone y order_id (puedes añadir name, total) o por la API con customFields. El agente ve estos datos automáticamente en los datos del cliente. Ejemplo de instrucciones:

Llamas a un comprador para confirmar su pedido en la tienda online.
1. Primero llama a search_entities_by_phone y busca el pedido con el order_id del cliente.
2. Di los productos, el importe y la forma de entrega. Nunca leas el comentario interno.
3. Confirmó → update_order_status con outcome=confirmed y un comentario
   breve (dirección, preferencias de entrega).
4. Rechazó → pregunta el motivo, update_order_status con outcome=declined
   y el motivo en el comentario.
5. Pide que le llamen más tarde → acuerda una hora, update_order_status
   con outcome=callback y la hora en el comentario.
No cambies el estado hasta que el cliente responda con claridad.

Escenario 2. Rechazos y «llámame más tarde»

La misma campaña gestiona las objeciones: si el cliente duda por un producto, el agente comprueba un sustituto con check_stock y lo ofrece. Si aun así rechaza, el agente pone «Customer declined» y escribe el motivo en el comentario para que el gestor lo vea en el pedido. Ejemplo para añadir a las instrucciones:

Si el cliente quiere otra talla o color, usa check_stock con el SKU
del pedido y di qué hay en stock. No hagas tú el cambio: añade
el deseo con add_order_comment, un gestor volverá a llamar.
Escribe siempre el motivo del rechazo en el comentario, en una frase.
Voice Agent no marca en KeyCRM las llamadas que nadie contestó. Se ven en las estadísticas de la campaña y puedes enviarlas a tu sistema por webhook.

Escenario 3. Llamadas entrantes → leads

Una campaña entrante en el número de la tienda. Si el cliente tiene un pedido, el agente responde sobre su estado y su número de seguimiento. Si no hay pedido y le interesa un producto, el agente crea una tarjeta en el embudo. Ejemplo de instrucciones:

Primero llama a search_entities_by_phone.
- Hay pedido → responde sobre su estado, la entrega y el número de seguimiento.
- No hay pedido y quiere comprar → pregunta su nombre, el producto (SKU,
  si lo sabe) y una buena hora para la llamada del gestor. Crea un lead con
  create_lead: un título breve, un comentario con sus deseos, los productos en items.
- Pide una llamada a una hora concreta → update_lead
  con callback_at para la tarjeta que acabas de crear.

Tras la llamada en lugar del agente

El estado puede ponerse no durante la conversación, sino automáticamente después, a partir del informe de IA. Así el agente no se distrae con el CRM y el estado se pone aunque el cliente cuelgue antes.

  1. 1
    Editor de la campaña → tarjeta «Data extraction» → «+ Add Field»: añade un campo order_outcome con la descripción «confirmed si el cliente confirmó el pedido; declined si lo rechazó; callback si pidió que le llamaran; no_answer si no hubo conversación real» y un campo summary para el resumen.
  2. 2
    Configura las herramientas de KeyCRM para «After call» con parámetros-plantilla. El editor de la campaña aún no tiene campos para parámetros, así que se hace desde el servidor MCP de Voice Agent (voiceagent_set_campaign_integration_tools) o la API.
{ "projectID": 123, "campaignID": 456, "integrationId": "keycrm",
  "tools": [ "search_entities_by_phone", "get_order", "check_stock", "add_order_comment",
  { "name": "update_order_status", "usageTiming": "afterCall",
    "parameters": { "order_id": "${custom_fields.order_id}",
                    "outcome": "${report.detailed.order_outcome}",
                    "comment": "${report.detailed.summary|}" } } ] }

Sustituye 123 y 456 por los ID de tu proyecto y tu campaña. En tools enumera todas las herramientas de KeyCRM que la campaña debe conservar: las que no estén en la lista se desconectan. Un nombre sin ajustes (como search_entities_by_phone) mantiene la herramienta disponible durante la conversación. Si el número no tiene order_id o el informe no tiene order_outcome, la herramienta no se ejecuta y el pedido no cambia. Una segunda ejecución para la misma llamada no duplica el estado ni el comentario.

Resultados en el webhook

En la plantilla del cuerpo del webhook de la campaña puedes pasar resultados de herramientas: {{tools.keycrm_create_lead.lead_id?}} — el ID de la tarjeta creada, {{tools.keycrm_update_order_status.status_id?}} — el estado puesto. El ? significa que el campo será null si la herramienta no se llamó en la conversación.

Qué sigue