Esta es la lista completa de lo que un agente puede pedirle a falatu. Se genera desde el propio servidor, así que siempre coincide con lo que hace. Los nombres y las descripciones de los parámetros quedan en inglés, como los lee el agente.
Herramientas de lectura
Solo miran. Funcionan con cualquier conexión, incluso de miembros y tokens “Solo ver”.
get_account
La cuenta: nombre, plan, idioma, tu rol, el Instagram conectado y si el envío está activo.
The falatu account this connection acts on: name, plan, language, your role and whether you can change things, the connected Instagram account(s) with their status and sending switches, and the account defaults. Read-only. Call this first.
Parámetros: Ninguno.
list_posts
Las publicaciones recientes, con la palabra clave detectada, la automatización y los comentarios.
Recent Instagram posts and reels, newest first: caption, the keyword falatu detected in it ("Comenta X"), the link it found, the automation listening on it (id, status, link) and the comment count. Read-only. Use filter "suggested" for posts with a keyword and no automation yet.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
filter | "all" | "suggested" | "automated" | "none" | opcional | all | suggested (keyword found, no automation) | automated | none (por defecto: "all") |
limit | integer 1–50 | opcional | (por defecto: 12) |
list_automations
Todas las automatizaciones, con estado, palabras clave, enlace y publicación.
Every automation: id, name, status (draft, shadow = decides but never sends, active = sends, paused, ended), keywords, link and the post it listens on. Read-only.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
status | "draft" | "shadow" | "active" | "paused" | "ended" | opcional | Only automations with this status. |
get_automation
Una automatización completa: textos, enlace, follow gate, respuestas y Votación.
One automation in full: keywords and variants, the DM text, button label and link, the follow gate, public replies, Votação (comment poll), dates and status. Blank texts mean the account default is used. Read-only.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
automation_id | id | obligatorio | The automation id (from a list_* tool). |
get_stats
Números por automatización (7 días por defecto): comentarios, pedidos, enlaces entregados, seguidores nuevos, fallos.
Numbers per automation for the last N days (default 7): comments received on its post, follow asks sent, links delivered, new followers after an ask, failed sends and items that needed a person. Only live (active) sends count; shadow automations report what they would have done. Read-only.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
automation_id | id | opcional | One automation; omit for every automation that isn't a draft. |
days | integer 1–90 | opcional | (por defecto: 7) |
list_needs_you
La lista de Te necesita: preguntas, quejas y publicaciones esperando enlace.
The "Precisa de você" (needs you) list: comments and DMs the robot did not answer because a person should (a question, a complaint, a help request, a long text), plus posts set up automatically that still wait for a link. Each item has an id for suggest_reply and mark_needs_you_done, the text, who wrote it, the reason, whether the 24h DM window is open, and an app link where a person can answer. Read-only.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
post_id | id | opcional | Only items on this post. |
limit | integer 1–100 | opcional | (por defecto: 30) |
get_poll_results
El ranking de la Votación de una automatización.
The Votação (comment poll) ranking of an automation: each answer (grouped without accents or case) with its vote count and share, plus how many people voted. One vote per person, the latest wins. Read-only.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
automation_id | id | obligatorio | The automation id (from a list_* tool). |
limit | integer 1–100 | opcional | (por defecto: 20) |
list_activity
Lo que pasó en una publicación o automatización: quién comentó, qué decidió falatu y si envió.
What happened recently on a post or automation (or the whole account): each comment, DM or button tap, who sent it, what falatu decided (reply, ask to follow, deliver the link, needs a person, ignore) and why, and whether it was really sent ("sent") or only decided in shadow mode. Use it to see who asked for the link this week. Read-only.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
post_id | id | opcional | The post id (from a list_* tool). |
automation_id | id | opcional | The automation id (from a list_* tool). |
days | integer 1–30 | opcional | (por defecto: 7) |
limit | integer 1–100 | opcional | (por defecto: 30) |
search_docs
Busca en el centro de ayuda.
Searches the falatu help center (docs.falatu.ai) and returns the best pages with a short excerpt and their URL. Use it to answer how-to questions about falatu. Read-only.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
query | string | obligatorio | |
language | "pt" | "en" | "es" | opcional | Defaults to the account language. |
limit | integer 1–10 | opcional | (por defecto: 5) |
Herramientas que cambian algo
Necesitan una conexión con permiso para cambiar y un rol de dueño o admin. Cada una queda registrada en Actividad de los agentes.
create_automation
Crea una automatización en una publicación (en modo sombra: no envía nada hasta que alguien la active).
Creates an automation on a post: when someone comments one of the keywords, falatu replies under the comment and sends the link by DM. It is created in "shadow" (decides, never sends) unless you pass status "draft"; it never starts sending by itself: call activate_automation after the person confirms. Blank texts use the account defaults. Fails if the post already has an automation. Changes falatu data; nothing is sent to anyone.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
post_id | id | obligatorio | The post id (from a list_* tool). |
keywords | string[] | obligatorio | The words people comment, e.g. ["CINEMA"]. Case and accents are ignored. |
link | url | opcional | The link the DM delivers. Without it the automation can't be activated. |
gate | "soft" | "strict" | "off" | "default" | opcional | Follow gate: "soft" (Suave: asks to follow, sends the link anyway), "strict" (Rígido: link only after they follow), "off" (link straight away), "default" (the account default). (por defecto: "default") |
name | string | opcional | Defaults to the first keyword. |
dm_text | string | opcional | The DM text; blank = the account default. |
button_label | string | opcional | |
public_replies | string[] | opcional | Public replies under the comment, rotated; blank = the account defaults. |
poll_label | string | opcional | Turns on Votação (comments also count as votes); the label names what is voted on, e.g. "nicho". |
status | "shadow" | "draft" | opcional | (por defecto: "shadow") |
update_automation
Cambia campos de una automatización (el resto queda igual).
Changes some fields of an automation; anything you leave out stays as it is. An active automation stays active. Pass an empty string to clear a text back to the account default. Changes falatu data; nothing is sent to anyone.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
automation_id | id | obligatorio | The automation id (from a list_* tool). |
name | string | opcional | |
keywords | string[] | opcional | |
link | url | string | opcional | |
gate | "soft" | "strict" | "off" | "default" | opcional | Follow gate: "soft" (Suave: asks to follow, sends the link anyway), "strict" (Rígido: link only after they follow), "off" (link straight away), "default" (the account default). |
dm_text | string | opcional | |
button_label | string | opcional | |
public_replies | string[] | opcional | Replaces the public replies; [] = back to the account defaults. |
poll_enabled | boolean | opcional | |
poll_label | string | opcional | |
starts_at | date-time | null | opcional | ISO date-time; null = no start date. |
ends_at | date-time | null | opcional | ISO date-time; null = no end date. |
set_automation_link
Cambia el enlace que entrega la automatización.
Sets (or replaces) the link an automation delivers by DM. On an active automation the new link is used from the next comment on. Changes falatu data; nothing is sent to anyone.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
automation_id | id | obligatorio | The automation id (from a list_* tool). |
link | url | obligatorio |
activate_automation
Activa la automatización: desde ahora falatu responde los comentarios nuevos de verdad.
Turns an automation on: from now on falatu answers new comments on its post for real (public reply + DM with the link). With answer_earlier, comments that arrived before (up to 7 days old, never answered) are answered too, oldest first; it defaults to true for automations falatu set up by itself on a new post and false otherwise. Needs a link and an Instagram account with sending allowed. Ask the person before calling it. Changes what falatu sends.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
automation_id | id | obligatorio | The automation id (from a list_* tool). |
answer_earlier | boolean | opcional | Also answer the comments that arrived before (under 7 days old). Tell the person how many first (get_automation shows held_comments). |
pause_automation
Pausa al instante: vuelve al modo sombra y deja de enviar.
Pauses an active automation at once: it goes back to shadow mode (keeps deciding, sends nothing). Changes what falatu sends.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
automation_id | id | obligatorio | The automation id (from a list_* tool). |
suggest_reply
Escribe una sugerencia de respuesta para un elemento de Te necesita. Nunca envía.
Drafts a reply for a "Precisa de você" item in the owner's tone (AI). It NEVER sends: return the draft to the person and give them the app link, where they can edit it and click Send. Nothing changes in falatu.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
item_id | id | obligatorio | The item id from list_needs_you. |
mark_needs_you_done
Marca un elemento de Te necesita como resuelto.
Marks a "Precisa de você" item as resolved, so it leaves the list. Use it only when the person says it was handled. Changes falatu data; nothing is sent to anyone.
Parámetros:
| Nombre | Tipo | Descripción | |
|---|---|---|---|
item_id | id | obligatorio | The item id from list_needs_you. |