Integración · Cobrar y administrar
Alegra + agentes de IA de Meteor
Conecta Alegra con Meteor: un Met cotiza, consulta stock y precios y revisa cartera desde WhatsApp. 18 herramientas reales.
¿Cómo se conecta Alegra con Meteor?
Meteor se conecta con Alegra a través de su API y le da a tu Met 18 herramientas para operar el frente comercial: consultar productos, precios por lista y stock por bodega, identificar al cliente por su teléfono o NIT, crear cotizaciones, listar y abrir facturas para revisar cartera, y repartir la cola de cotizaciones pendientes por vendedor. Todo eso funciona desde una conversación de WhatsApp. Crear borradores de factura de venta, registrar pagos y gastos, y leer cuentas bancarias, impuestos y la ficha de la empresa quedan reservados al operador por web: el conector rechaza esas seis herramientas cuando quien las pide es un Met de canal, y no es una opción que se pueda activar. Solo necesitas un token de API de Alegra, sin desarrollo a la medida.
Dónde aplica: Colombia, México, Argentina. La API identifica el país y la moneda configurados en la cuenta. Este conector solo crea el borrador de la factura de venta; no presenta, timbra ni emite el documento ante la autoridad tributaria de ningún país. Las herramientas contables sensibles solo corren desde el escritorio: el conector las rechaza cuando la petición llega por un canal.
Qué automatiza
Lo que un agente de Meteor hace con Alegra
Cotizar por WhatsApp sin abrir Alegra
El cliente pregunta por un producto. Tu Met lo busca en el inventario, confirma precio y stock por bodega, identifica al cliente por su número de teléfono y genera la cotización con su enlace al PDF, todo dentro de la misma conversación.
Preparar un borrador de factura desde el escritorio
El operador parte de un cliente y productos existentes, revisa fechas, cantidades, precios antes de impuestos y el total esperado, y aprueba el resumen en un mensaje nuevo. Solo entonces el Met crea el borrador con status draft y reporta el estado y el total que devuelve Alegra. El Met de canal no puede ejecutar esa escritura.
Perseguir la cartera vencida por WhatsApp
Tu Met lista las facturas por estado y fecha, arma el listado de quién debe y desde cuándo y escribe por WhatsApp. Cuando el dinero entra, el pago se registra desde el escritorio: esa herramienta está fuera del alcance de un Met de canal.
Repetir el pedido de un cliente recurrente
Un cliente pide «lo mismo del mes pasado». Tu Met abre su última factura, que vuelve con cada línea y el identificador del producto, confirma precio y stock actuales y arma la cotización nueva sin que nadie transcriba una lista.
Repartir la cola de cotizaciones por vendedor
Cada comercial pregunta por sus pendientes y el Met le devuelve solo sus cotizaciones sin atender, con número, total, cliente y enlace al PDF.
18 herramientas
Todo lo que el agente puede pedirle a Alegra
Cada una es una acción real del conector. Puedes desactivar las que no quieras que use.
| Herramienta | Qué hace |
|---|---|
consultar_producto | Busca un producto o servicio por nombre o referencia (SKU) y devuelve su id, categoría y estado. |
consultar_precio | Devuelve las listas de precios y los impuestos configurados del producto, con sus ids, porcentaje y estado. |
consultar_stock | Devuelve la disponibilidad actual de un producto, por bodega, con su costo unitario. |
listar_inventario | Lista o busca productos y trae en un solo llamado nombre, referencia, stock por bodega y precios. |
buscar_cliente | Identifica a un cliente por nombre, NIT, correo o teléfono, y devuelve sus últimas facturas. |
crear_cliente | Registra un cliente nuevo cuando la búsqueda no lo encuentra, antes de cotizar o facturar. |
crear_cotizacion | Crea una cotización (pre-factura) a nombre de un cliente. No factura ni afecta la DIAN. Exige que el cliente ya exista: cotizar no lo da de alta, para no dejar fichas duplicadas. |
consultar_cotizacion | Devuelve el detalle de una cotización con su enlace al PDF formal para enviárselo al cliente. |
listar_cotizaciones | Lista la cola de cotizaciones pendientes, filtrable por vendedor, situación, cliente y fechas. |
crear_pedido | Crea un borrador de factura de venta para un cliente existente, con productos, cantidades, precios antes de impuestos e ids de impuestos aprobados. Exige aprobar un resumen y enviar confirmar:true como booleano literal. Solo desde el escritorio; no emite facturación electrónica, registra pagos, envía correo ni genera PDF. |
alegra_list_invoices | Lista facturas filtrando por estado, cliente y rango de fechas. Sirve para cartera y reportes. |
alegra_get_invoice | Devuelve el detalle completo de una factura por su id, con sus líneas y el identificador de producto de cada una. Es lo que permite repetir el pedido de un cliente recurrente. |
alegra_register_payment | Registra un pago recibido contra una o varias facturas. Solo desde el escritorio: el conector la rechaza si quien la pide es un Met de canal. |
alegra_create_expense | Registra un gasto o una factura de compra. Solo desde el escritorio: el conector la rechaza si quien la pide es un Met de canal. |
alegra_list_bank_accounts | Lista las cuentas bancarias configuradas con su saldo actual. Aunque solo lee, está en el grupo fiscal: solo desde el escritorio, nunca desde un Met de canal. |
alegra_list_taxes | Lista los impuestos configurados en la cuenta (IVA, INC y demás). Aunque solo lee, está en el grupo fiscal: solo desde el escritorio, nunca desde un Met de canal. |
alegra_get_company | Devuelve los datos de la empresa (nombre, NIT, régimen, zona horaria). Sirve para verificar credenciales. Aunque solo lee, está en el grupo fiscal: solo desde el escritorio. |
listar_vendedores | Lista los vendedores con su id, para asignar el comercial de ruta a una cotización. |
Los límites
Qué NO hace la integración con Alegra
Preferimos decirlo aquí que descubrirlo en la implementación.
-
No crea borradores de factura, registra pagos ni registra gastos desde un Met de canal. No es una opción configurable: el conector rechaza esas herramientas cuando la petición llega por WhatsApp, Instagram, Messenger o chat web. Un operador en la plataforma web sí las tiene, y crear el borrador exige confirmar:true como booleano literal después de aprobar el resumen.
-
No emite, presenta, timbra ni anula facturación electrónica. La herramienta de nombre histórico crear_pedido fija status draft; no llama a la autoridad tributaria de ningún país. Tampoco registra un pago, envía un correo ni devuelve un PDF.
-
No consulta cuentas bancarias, impuestos ni la ficha de la empresa desde un canal. Aunque las tres solo leen, están en el mismo grupo fiscal que las escrituras y el bloqueo las alcanza igual: son datos de la contabilidad, no del catálogo.
-
No da de alta al cliente al cotizar. Si quien escribe no existe todavía en Alegra, hay que crearlo primero y reintentar; es a propósito, para no llenar el maestro de fichas duplicadas.
-
No concilia bancos ni importa extractos. Lista cuentas y saldos, y registra pagos contra facturas.
-
No hace cierres contables, no genera balances ni declaraciones tributarias.
-
No reemplaza a tu contador. Es una ventana operativa a Alegra, no un criterio contable.
-
No sincroniza el catálogo con tu tienda. Si necesitas que el stock de Alegra y el de WooCommerce se espejen, ese trabajo lo hace la integración de la tienda.
Antes de empezar
Qué necesitas para conectar Alegra
- 1
Token de API de Alegra en Base64
En Alegra, en Configuración → Integraciones → API. El token se guarda como Base64 de "tu-correo@empresa.com:tu-token", cifrado por espacio de trabajo.
- 2
Una cuenta de Alegra activa con el inventario cargado
El Met lee lo que ya está en tu Alegra. Si los precios o el stock no están al día ahí, tampoco lo estarán en la conversación.
Preguntas frecuentes
Preguntas sobre Alegra y Meteor
No. El conector rechaza crear_pedido, registrar pagos y registrar gastos cuando la petición viene de un canal, aunque la herramienta esté habilitada. Un operador en la plataforma web puede crear un borrador después de aprobar el resumen y pasar confirmar:true como booleano literal. El bloqueo y la aprobación viven en el código, no solo en el prompt.
Alegra ofrece su API en varios países y el conector puede leer el país y la moneda de la cuenta. Esta herramienta solo crea un borrador con la configuración existente: no valida el contrato fiscal de cada país ni emite el documento. La emisión se resuelve en Alegra.
La herramienta de búsqueda de clientes acepta teléfono además de nombre, NIT y correo, y normaliza el número colombiano antes de comparar. Si aun así no aparece, el Met lo crea con los datos que le dé el cliente antes de cotizar.
Sí. La consulta de stock devuelve la disponibilidad por bodega y el costo unitario, y el listado de inventario trae stock y precios de varios productos en un solo llamado, para no tener que preguntar producto por producto.
Paso a paso
Automatizaciones que usan Alegra
Tareas completas, con los pasos y las herramientas que se ejecutan en cada uno.
Cobros y cartera
Cobrar la cartera vencida por WhatsApp, sin perseguir a nadie a mano
¿Cómo cobro las facturas vencidas por WhatsApp sin revisar la cartera a mano?
Administración
- Arranca:
- a una hora fija
- Pasos:
- 5, con 8 herramientas reales
- Necesita:
- CRM de Meteor
Ventas y cotización
Cotizar por WhatsApp con el inventario de Alegra
¿Cómo cotizo por WhatsApp sin tener que abrir Alegra?
Administración
- Arranca:
- cuando el cliente escribe
- Pasos:
- 5, con 12 herramientas reales
- Necesita:
- CRM de Meteor
Cobros y cartera
Crear un borrador de factura de venta en Alegra con aprobación humana
¿Cómo creo un borrador de factura de venta en Alegra después de revisarlo?
Administración
- Arranca:
- cuando alguien lo pide
- Pasos:
- 6, con 8 herramientas reales
Operaciones documentadas
Casos que usan Alegra
Cada caso explica qué se hacía a mano, qué hace hoy el agente, qué conectores lo respaldan y cuáles son sus límites.
Cobrar y administrar
Otras integraciones de la misma familia
¿Quieres ver a un agente operando Alegra?
Te lo mostramos con tu propia cuenta conectada, no con una demostración enlatada.