Essa é a lista completa do que um agente consegue pedir pra falatu. Ela é gerada a partir do próprio servidor, então está sempre igual ao que ele faz. Os nomes e as descrições dos parâmetros ficam em inglês, do jeito que o agente lê.
Ferramentas de leitura
Só olham. Funcionam com qualquer conexão, inclusive de membros e tokens “Só ver”.
get_account
A conta: nome, plano, idioma, seu papel, o Instagram conectado e se o envio está ligado.
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: Nenhum.
list_posts
Os posts recentes, com a palavra-chave detectada, a automação ligada e os comentários.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
filter | "all" | "suggested" | "automated" | "none" | opcional | all | suggested (keyword found, no automation) | automated | none (padrão: "all") |
limit | integer 1–50 | opcional | (padrão: 12) |
list_automations
Todas as automações, com status, palavras-chave, link e post.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
status | "draft" | "shadow" | "active" | "paused" | "ended" | opcional | Only automations with this status. |
get_automation
Uma automação completa: textos, link, pedir pra seguir, respostas e Votação.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
automation_id | id | obrigatório | The automation id (from a list_* tool). |
get_stats
Números por automação (padrão: 7 dias): comentários, pedidos, links entregues, seguidores novos, falhas.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
automation_id | id | opcional | One automation; omit for every automation that isn't a draft. |
days | integer 1–90 | opcional | (padrão: 7) |
list_needs_you
A lista do Precisa de você: perguntas, reclamações e posts esperando link.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
post_id | id | opcional | Only items on this post. |
limit | integer 1–100 | opcional | (padrão: 30) |
get_poll_results
O ranking da Votação de uma automação.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
automation_id | id | obrigatório | The automation id (from a list_* tool). |
limit | integer 1–100 | opcional | (padrão: 20) |
list_activity
O que aconteceu num post ou automação: quem comentou, o que a falatu decidiu e se mandou.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
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 | (padrão: 7) |
limit | integer 1–100 | opcional | (padrão: 30) |
search_docs
Busca na central de ajuda.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
query | string | obrigatório | |
language | "pt" | "en" | "es" | opcional | Defaults to the account language. |
limit | integer 1–10 | opcional | (padrão: 5) |
Ferramentas que mudam algo
Precisam de uma conexão com permissão pra mudar e de um papel de dono ou admin. Cada uma fica registrada em Atividade dos agentes.
create_automation
Cria uma automação num post (em modo sombra: não manda nada até alguém ativar).
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
post_id | id | obrigatório | The post id (from a list_* tool). |
keywords | string[] | obrigatório | 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). (padrão: "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 | (padrão: "shadow") |
update_automation
Muda campos de uma automação (o resto fica 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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
automation_id | id | obrigatório | 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
Troca o link que a automação entrega.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
automation_id | id | obrigatório | The automation id (from a list_* tool). |
link | url | obrigatório |
activate_automation
Liga a automação: a partir de agora a falatu responde os comentários novos de verdade.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
automation_id | id | obrigatório | 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 na hora: volta pro modo sombra e para de mandar.
Pauses an active automation at once: it goes back to shadow mode (keeps deciding, sends nothing). Changes what falatu sends.
Parâmetros:
| Nome | Tipo | Descrição | |
|---|---|---|---|
automation_id | id | obrigatório | The automation id (from a list_* tool). |
suggest_reply
Escreve uma sugestão de resposta pra um item do Precisa de você. Nunca envia.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
item_id | id | obrigatório | The item id from list_needs_you. |
mark_needs_you_done
Marca um item do Precisa de você como resolvido.
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:
| Nome | Tipo | Descrição | |
|---|---|---|---|
item_id | id | obrigatório | The item id from list_needs_you. |