MCP: Instagram
Contas, perfil, comentários e automações de DM do Instagram pelo MCP. 11 ferramentas.
Ferramentas desta área, geradas do código do servidor. As descrições vêm desse código, em português. Para conectar, veja o MCP da XBASE.
create-dm-automation-rule
Cria uma automação de DM numa conta do Instagram do workspace: quando um comentário tiver uma das palavras-chave, a pessoa recebe uma DM. Modo FIXED envia replyMessage; modo AGENT passa a conversa ao agente (agentId). scope SPECIFIC_POST exige postId.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | sim | ID da conta do Instagram conectada (veja list-instagram-connections) |
keywords | sim | 1 a 20 palavras-chave (até 100 caracteres cada) |
scope | sim | ANY_POST = qualquer post; SPECIFIC_POST = só o post de postId |
postId | não | ID do post (obrigatório com SPECIFIC_POST) |
mode | não | FIXED (padrão) = mensagem fixa; AGENT = o agente responde |
replyMessage | não | Mensagem da DM (modo FIXED, até 1000 caracteres) |
agentId | não | Agente que responde (modo AGENT) |
delete-dm-automation-rule
EXCLUI em definitivo uma automação de DM do workspace (não dá para desfazer). Para só pausar, use update-dm-automation-rule com active=false.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
ruleId | sim | ID da automação de DM (veja list-dm-automation-rules) |
get-dm-automation-rule
Detalhe de uma automação de DM do workspace: palavras-chave, escopo, modo, mensagem/agente e status.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
ruleId | sim | ID da automação de DM (veja list-dm-automation-rules) |
get-instagram-connection
Detalhe de uma conta do Instagram do workspace: perfil (nome, bio, site), agente e status.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
connectionId | sim | ID da conta do Instagram conectada (veja list-instagram-connections) |
get-instagram-messaging-profile
Ice Breakers (perguntas iniciais) e menu persistente da DM da conta, como estão na Meta.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
connectionId | sim | ID da conta do Instagram conectada (veja list-instagram-connections) |
list-dm-automation-rules
Lista as automações de DM do workspace: palavras-chave em comentários do Instagram que disparam uma DM (mensagem fixa ou agente), escopo (qualquer post ou um post) e se estão ativas.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | não | Opcional: só as automações desta conta do Instagram |
list-instagram-connections
Lista as contas do Instagram ativas do workspace: usuário, nome, bio e site (com os valores originais do Instagram), agente vinculado e acesso a mensagens.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
set-instagram-post-comments
Liga ou desliga os comentários de um post da conta do Instagram (vale direto no Instagram).
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
connectionId | sim | ID da conta do Instagram conectada (veja list-instagram-connections) |
mediaId | sim | ID numérico do post (mídia) no Instagram |
enabled | sim | true = comentários ligados; false = desligados |
update-dm-automation-rule
Edita uma automação de DM do workspace: palavras-chave (substitui a lista), escopo/post, modo (FIXED/AGENT), mensagem, agente ou liga/desliga (active). Só os campos enviados mudam.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
ruleId | sim | ID da automação de DM (veja list-dm-automation-rules) |
keywords | não | Lista completa de palavras-chave (substitui a atual) |
scope | não | — |
postId | não | — |
mode | não | — |
agentId | não | Agente que responde (modo AGENT) |
replyMessage | não | — |
active | não | true = ativa; false = pausada |
update-instagram-messaging-profile
SUBSTITUI os Ice Breakers (até 4 perguntas iniciais) e o menu persistente (até 5 botões) da DM na conta do Instagram. O que não for enviado é apagado: lista vazia remove tudo. Leia antes com get-instagram-messaging-profile. Botão "postback" vira DM com o texto do botão; "web_url" abre um link https.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
connectionId | sim | ID da conta do Instagram conectada (veja list-instagram-connections) |
iceBreakers | sim | Lista completa de perguntas iniciais (substitui as atuais) |
persistentMenu | sim | Lista completa de botões do menu (substitui os atuais) |
update-instagram-profile
Edita nome, bio e site da conta do Instagram na XBASE (o que agentes e telas usam). A Meta não deixa alterar o perfil real do Instagram. Só os campos enviados mudam; null volta ao valor do Instagram.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
connectionId | sim | ID da conta do Instagram conectada (veja list-instagram-connections) |
name | não | Nome exibido (até 64). null = volta ao do Instagram |
biography | não | Bio (até 1000). null = volta à do Instagram |
website | não | Site (http:// ou https://, até 300). null = volta ao do Instagram |