Acciones de Tinkay AI

Una acción es un endpoint tuyo que Tinkay AI puede llamar mientras conversa. Sirve para responder cosas que no están en la base de conocimiento porque viven en tu base de datos: el estado de una suscripción, un envío, un turno.

La IA decide cuándo llamarla a partir del nombre y la descripción que le des, así que escribilas pensando en cuándo querés que se use.

Configurarla

1. Entrá a Tinkay AI, Acciones y tocá Nueva acción.
2. Poné un nombre claro (Consultar suscripción) y una descripción que explique cuándo usarla.
3. Elegí el método y la URL. Podés usar {parametro} en la ruta.
4. Definí los parámetros con nombre, descripción y si son obligatorios.
5. Activá la acción y probala en el Test Lab.

Contrato de la llamada

Tinkay llama a tu endpoint con los parámetros que la IA extrajo de la conversación.

GET https://api.tuempresa.com/tinkay/subscription/kipuAuthorization: Bearer <el secreto que definas en la acción>X-Tinkay-Workspace: ws_tinkayX-Tinkay-Conversation: cv_1790

Implementar el endpoint

app.MapGet("/tinkay/subscription/{workspace}", (string workspace, HttpRequest req, IConfiguration cfg) =>{    var token = req.Headers.Authorization.ToString().Replace("Bearer ", "");    if (token != cfg["Tinkay:ActionSecret"]) return Results.Unauthorized();    var sub = db.Subscriptions.FirstOrDefault(s => s.WorkspaceSlug == workspace);    if (sub is null) return Results.NotFound(new { message = "No encontramos esa cuenta." });    return Results.Ok(new    {        plan = sub.Plan,        seats = sub.Seats,        next_invoice_at = sub.NextInvoiceAt.ToString("yyyy-MM-dd"),        amount_usd = sub.AmountUsd,        status = sub.Status    });});

Qué pasa si falla

• Timeout de 5 segundos: si tardás más, Tinkay AI responde con lo que sabe y deriva a una persona.
• Error 4xx o 5xx: la IA no inventa el dato; avisa que no pudo consultarlo y deriva.
• 404 con `message`: la IA usa ese mensaje para responder con naturalidad.