Conectar Contala con Claude, ChatGPT, Gemini, Make y n8n

Preguntale a Claude, ChatGPT o Gemini por los datos del estudio en lenguaje natural, o armá automatizaciones en Make y n8n con la API y los avisos automáticos (webhooks). Todo es de solo lectura.

Contala se puede conectar con otras herramientas para consultar los datos del estudio sin entrar a la app: empresas, empleados, vencimientos, la Ventanilla de ARCA, la documentación pendiente de los clientes y las liquidaciones. Las conexiones solo leen: ninguna puede liquidar, facturar ni modificar nada. Todo se maneja desde Configuración › Integraciones, que ven solo los administradores del estudio.

1. Claude, ChatGPT o Gemini, sin código

Es la forma más simple: agregás Contala como conector y después le preguntás en un chat, por ejemplo «¿qué clientes tienen vencimientos esta semana?» o «¿qué documentación me falta de los clientes?». También le podés preguntar cómo se hace algo en Contala, como «¿cómo cargo una licencia?»: contesta con las guías de esta ayuda y te pasa el link.

  1. En Claude, Contala está en el directorio de conectores: entrá a claude.ai/directory/contala (o buscá Contala en Directorio) y tocá Conectar.
  2. En ChatGPT (hace falta un plan pago), Complementos › Agregar › Crear servidor MCP personalizado. En Gemini (plan pago, desde la pestaña Spark, que está en beta), Apps conectadas › Apps personalizadas para Spark. En los dos: nombre Contala y URL https://www.contala.com.ar/api/mcp. En ChatGPT, la autenticación es OAuth y hay que tildar Entiendo y quiero continuar.
  3. Al conectar te lleva a Contala: iniciás sesión y, si trabajás en más de un estudio, elegís cuál conectar.
  4. En Autorizar acceso revisá que el sitio al que volvés sea el de la app que estás conectando (claude.ai, chatgpt.com o un sitio de Google) y tocá Autorizar.
  5. En un chat nuevo, activá Contala desde el + o el menú de herramientas y preguntá. La primera vez puede pedirte permiso para usarla.
La app conectada ve las mismas empresas que vos. Si tu usuario está limitado a algunas empresas, la conexión también.

Cada persona del estudio conecta su propia app, con su usuario. Para cortarle el acceso a la tuya: Mi cuenta › Mis apps conectadas › Quitar acceso. Los administradores ven las de todos en Integraciones › Apps conectadas y pueden quitar cualquiera; al dar de baja a alguien del estudio, sus conexiones se quitan solas. En todos los casos deja de funcionar en el momento.

2. Token de API: Make, n8n o Claude Code

Para herramientas que llaman a una API, creá un token en Integraciones › Tokens de API con un nombre que lo identifique (por ejemplo, n8n). El token completo se muestra una sola vez: copialo en ese momento.

Se manda en cada pedido en el encabezado Authorization: Bearer ctl_…. Las consultas disponibles, todas con GET sobre https://www.contala.com.ar/api/v1:

  • /empresas — los clientes del estudio.
  • /empleados?empresa=… — los empleados, de todas las empresas o de una.
  • /vencimientos?desde=AAAA-MM-DD&hasta=AAAA-MM-DD&estado=pendientes — los vencimientos impositivos (sin fechas: los próximos 30 días).
  • /ventanilla — las comunicaciones de ARCA pendientes, sin abrirlas.
  • /requerimientos?vencidos=si — la documentación que falta de los clientes.
  • /liquidaciones?periodo=AAAA-MM y /liquidaciones/<id>/recibos — las liquidaciones y los totales de cada recibo.

En Claude Code, el mismo token sirve para el conector: claude mcp add --transport http contala https://www.contala.com.ar/api/mcp --header "Authorization: Bearer ctl_…".

El token da acceso a los datos del estudio: guardalo como una contraseña. Si se filtra, revocalo desde Tokens de API y creá otro.

3. Avisos automáticos (webhooks)

Con un webhook, Contala le avisa a una URL tuya cuando pasa algo, y Make o n8n arrancan el flujo solos. En Integraciones › Webhooks pegás la URL que te da el disparador de Make o n8n y elegís los eventos:

  • Comunicaciones nuevas en la Ventanilla de ARCA.
  • Vencimientos de los próximos 3 días que siguen pendientes (un aviso por día, a la mañana).
  • Liquidación de sueldos cerrada.
  • Un cliente marcó como enviada la documentación o subió un archivo desde el portal.

Con Probar Contala manda un aviso de prueba en el momento, así ves que la URL responde. Si la URL no contesta, Contala reintenta varias veces durante unas horas; el estado del último aviso queda a la vista en la lista.

Cada aviso va firmado. Al crear el webhook se muestra una sola vez un secreto (whsec_…): con él se verifica que el aviso lo mandó Contala. La firma viaja en el encabezado X-Contala-Firma y es el HMAC-SHA256 de <X-Contala-Timestamp>.<cuerpo>. Si no la verificás, el flujo igual funciona, pero cualquiera que conozca la URL podría mandarle avisos falsos.
¿Todavía no usás Contala?

Sueldos, facturación y contabilidad del estudio en un solo sistema. 30 días gratis, sin tarjeta.