Como ligar a sua IA ao Agencify

Use o Agencify na conversa

Depois de ligar a sua IA ao Agencify, pode pedir-lhe que consulte clientes, mostre campanhas ou compare resultados. Por exemplo: “Quanto gastou o cliente Loja Exemplo em anúncios na última semana?”. MCP é o nome desta ligação.

Este guia explica como ligar a IA e fazer o primeiro pedido.

O que precisa

• Uma conta Agencify com acesso ao Espaço de Trabalho que pretende utilizar.
• Um assistente de IA que permita adicionar ligações externas. A opção depende da aplicação e do plano que utiliza.
• Para consultar anúncios, as contas Meta ou Google têm de estar ligadas ao Agencify e associadas ao cliente.

Como ligar

Escolha abaixo o assistente que utiliza. O endereço do Agencify é o mesmo em todos:

https://www.agencifyapp.com/api/mcp

Autorize a ligação iniciando sessão na sua conta Agencify. Não precisa de criar um token nem de acrescentar uma palavra-passe ao endereço.

ChatGPT

1. No ChatGPT pelo navegador, abra Plugins. Clique no botão de adicionar e escolha Add custom MCP server.
2. Use Agencify como nome e cole o endereço acima em Server URL. Em autenticação, escolha OAuth, a opção que abre o início de sessão do Agencify.
3. Leia o aviso apresentado e crie o plugin em Create as a plugin. Instale o plugin criado e conclua a ligação com a sua conta Agencify quando lhe for pedido.
4. Numa conversa, escreva @ e selecione Agencify antes de fazer o seu pedido.

Claude Desktop ou Claude pelo navegador

1. Abra Customize, depois Connectors. Clique em + Add e escolha Add custom connector.
2. Dê o nome Agencify e cole o endereço acima. Continue com a autenticação detectada e escolha Sign in now para entrar na sua conta Agencify.
3. Conclua a ligação. Na conversa, abra o botão + e ative Agencify em Connectors.

Em contas de equipa, o administrador pode precisar de adicionar o conector antes. Cada pessoa liga a sua própria conta.

Claude Code

Com o Claude Code instalado, execute este comando no terminal:

claude mcp add --transport http agencify https://www.agencifyapp.com/api/mcp

Depois, abra o Claude Code e escreva:

/mcp

Selecione Agencify e siga a opção de autenticação para entrar pelo navegador. Ao concluir, volte ao Claude Code e faça o seu pedido.

Cursor

No projeto em que deseja usar o Agencify, abra o ficheiro .cursor/mcp.json. Se ainda não existir, crie-o com este conteúdo:

{
  "mcpServers": {
    "agencify": {
      "url": "https://www.agencifyapp.com/api/mcp"
    }
  }
}

Se o ficheiro já tiver outras ligações, acrescente apenas a entrada agencify em mcpServers. Guarde e abra a ligação Agencify nas definições de MCP do Cursor para concluir o início de sessão pelo navegador.

Outros assistentes e conclusão do início de sessão

Use o mesmo endereço se o assistente aceitar uma ligação MCP com início de sessão pelo navegador. Se ele exigir uma chave fixa e não oferecer esse início de sessão, esse método de ligação ainda não é compatível com o Agencify.

Na página de autorização do Agencify, confirme o Espaço de Trabalho e escolha o acesso. Para começar a consultar dados, use leitura. Conclua e volte ao assistente. Se a opção de ligação não aparecer, confirme o plano e as permissões da sua equipa na aplicação utilizada.

Faça o primeiro pedido

Envie esta mensagem:

“Mostra o nome do Espaço de Trabalho do Agencify ligado e os clientes a que posso aceder.”

Confirme se a resposta apresenta o Espaço de Trabalho esperado. Depois, utilize o nome de um dos clientes nos pedidos seguintes. Se existirem nomes semelhantes, peça à IA que mostre as opções antes de continuar.

Exemplos para o dia a dia

Substitua Loja Exemplo pelo nome do seu cliente:

• “Mostra as campanhas ativas da Loja Exemplo.”
• “Compara os gastos e os resultados da Loja Exemplo nos últimos sete dias com o período anterior.”
• “Resume o último Raio-X da Loja Exemplo e explica as sugestões. Não apliques nenhuma alteração.”

Indique o cliente e o período quando pedir uma análise. Se precisar de dados mais recentes, peça para atualizar os dados desse cliente antes de responder. A atualização depende da ligação à Meta ou ao Google.

O que pode fazer

Peça as tarefas abaixo pelo nome do cliente. As opções dependem do acesso autorizado, do seu plano e das contas de anúncios ligadas. Meta e Google podem oferecer ações diferentes.

Clientes e metas

• Procurar clientes e consultar detalhes, contas associadas e pessoas com acesso.
• Criar, editar ou eliminar clientes. Associar ou desassociar contas de anúncios e gerir colaboradores.
• Definir ou remover metas de custo por aquisição, custo por lead ou retorno sobre anúncios.
• Escolher se a IA apenas recomenda ou pode ajustar orçamentos, conforme o modo disponível para o cliente.

Equipa e Espaço de Trabalho

• Conferir o Espaço de Trabalho ligado, a sua função e permissões.
• Consultar membros e convites pendentes. Convidar pessoas ou reenviar um convite.
• Alterar funções ou remover membros, com acesso administrativo.

Contas e integrações

• Listar contas Meta e Google e verificar problemas na ligação.
• Pedir o link para ligar Meta ou Google e terminar a autorização no navegador. Renovar a ligação Google ou sincronizar a lista de contas.
• Importar recursos de um cliente quando o solicitar e retomar uma importação parcial.
• Desligar uma integração com confirmação e acesso administrativo. Isso interrompe a sincronização das contas associadas para todos os clientes.

Campanhas e anúncios em veiculação

• Listar e filtrar campanhas. Consultar conjuntos e anúncios com métricas por período, incluindo pré-visualizações de textos Google ou imagens e vídeos Meta.
• Consultar as opções permitidas e criar campanhas Meta ou Google com recursos guardados. Preparar uma duplicação a partir de uma campanha existente.
• Editar a segmentação e a estrutura dos conjuntos, incluindo os nomes. Alterar anúncios, parâmetros de rastreio dos links e orçamento diário.
• Ativar ou colocar em pausa campanhas, conjuntos e anúncios. Colocar em pausa ou ativar várias campanhas em simultâneo e eliminar campanhas.
• Atualizar os dados guardados de campanhas e anúncios, incluindo métricas e pré-visualizações Google.

Experimentos

• Consultar grupos, combinações testadas e resultados por período.
• Conferir combinações e orçamento antes de publicar. Criar grupos de experimentos com os recursos guardados.
• Renomear grupos e ajustar o orçamento por plataforma. Ativar ou colocar em pausa grupos e experimentos, ou eliminar um grupo.

Públicos e recursos guardados

• Consultar públicos, anúncios guardados, listas de palavras-chave e zonas de conversão, com detalhes e resultados. Ver onde cada recurso é usado.
• Criar ou editar esses recursos, visualizar as ficheiros multimédia e criar públicos na Meta. O envio de contactos para públicos de lista continua na aplicação.
• Ativar, colocar em pausa ou eliminar recursos, conferindo antes o efeito nos experimentos associados. Editar um anúncio já publicado pode alterar o anúncio na Meta.
• Consultar, atualizar ou criar listas de palavras-chave negativas do Google. Ver as campanhas associadas e conferir o impacto antes de desassociar e eliminar uma lista.

Imagens, vídeos e recursos da Meta

• Consultar Páginas, perfis Instagram e empresas. Encontrar pixels, eventos de conversão, conversões personalizadas e formulários de leads.
• Consultar públicos e contas WhatsApp. Verificar se uma Página pode anunciar no WhatsApp. O teste completo cria e remove uma campanha temporária.
• Verificar o endereço de destino de um anúncio e atualizar as conversões personalizadas.
• Enviar imagens ou vídeos por link para a conta Meta. Para uma imagem do computador, pedir a página de seleção e conferir o envio. Vídeos locais são enviados pela aplicação.

Resultados, Raio-X e recomendações

• Comparar métricas com o período anterior e atualizar séries de resultados por dia, semana, mês ou ano.
• Consultar o Raio-X guardado, os problemas encontrados e os itens envolvidos. Gerar um novo Raio-X para um cliente ou para os clientes acessíveis, dentro dos limites diários, e retomar a geração pendente.
• Pedir uma proposta de experimento ou a pré-visualização de uma correção. Aplicar uma ação do Raio-X após confirmação e registar o que foi visto, descartado ou resolvido.
• Consultar recomendações da IA e decisões pendentes. Aplicar uma recomendação ou um conjunto delas, ou dispensar uma sugestão.
• Executar ou retomar a análise de IA do Agencify. Ela pode ajustar orçamentos conforme o modo de IA do cliente. Gerar apenas o Raio-X não aplica as sugestões.

Relatórios e partilha

• Consultar relatórios guardados por período e rede, ou atualizar os dados para gerar um novo retrato dos resultados.
• Gerar links de relatórios de resultados ou do histórico de ações. Consultar e abrir relatórios já partilhados, respeitando a proteção de acesso.
• Obter os links de exportação em PDF que um agendamento tiver gerado.

Envios agendados

• Consultar agendamentos e histórico de entregas. Criar ou editar envios por email ou WhatsApp, escolhendo destinatários e frequência.
• Ver a pré-visualização do email sem enviar, ou pedir um envio de teste para os destinatários escolhidos.
• Colocar em pausa, reativar ou eliminar agendamentos. Executar agora um agendamento guardado de histórico de alterações.

Saldos e alertas

• Consultar e atualizar saldos, despesas do mês e limites das contas de anúncios. Ver os dados de pagamento disponíveis.
• Configurar, colocar em pausa ou eliminar alertas de saldo baixo. Enviar um alerta de teste e acompanhar o resultado.
• Ajustar os dados de faturação Google usados pelos alertas.

Histórico, acompanhamento e ajuda

• Consultar alterações recentes ou de um período e identificar ações feitas por pessoas ou pela IA.
• Acompanhar importações, criação de campanhas e experimentos, sincronizações, edição de anúncios e testes de alerta. Conferir o que terminou e o que falhou.
• Quando a operação permitir, cancelar ou retomar um trabalho e desfazer itens publicados por uma criação de campanha que falhou. Isso não é um desfazer geral de qualquer alteração.
• Procurar artigos da Central de Ajuda, consultar guias e ler instruções de tutoriais pela conversa.

Escolha o que a IA pode fazer

• Acesso de leitura: para consultar informações e compreender resultados.
• Acesso de escrita: permite também fazer alterações, como editar campanhas. Utilize-o quando quiser executar tarefas na conversa.
• Acesso administrativo: permite também gerir a equipa e desligar integrações. Escolha-o apenas se precisar destas tarefas.

A IA continua limitada ao que a sua conta pode aceder no Agencify. Autorizar a ligação não dá acesso a clientes que não pode ver. Inicie sessão na página do Agencify, sem enviar a palavra-passe na conversa.

Antes de pedir uma alteração

Um pedido de execução pode alterar a sua conta. Criar uma campanha pode iniciar gastos, e mudar um orçamento afeta a apresentação dos anúncios. Nem todas as alterações pedem uma segunda confirmação.

Se quiser apenas uma sugestão, diga-o no pedido. Por exemplo:

“Quero avaliar uma mudança de orçamento na campanha de Natal da Loja Exemplo. Mostra a proposta, sem alterar nada.”

Quando decidir executar, confirme o cliente e a campanha. Reveja também o valor, quando existir. Se a IA apresentar uma confirmação, leia o resumo antes de aprovar.

Se algo não funcionar

• A IA pede para entrar novamente: abra a ligação do Agencify no assistente e volte a iniciar sessão.
• Um cliente não aparece: confirme o Espaço de Trabalho ligado e se a sua conta tem acesso a esse cliente.
• A IA consulta, mas não consegue alterar: pode ter autorizado apenas leitura. Confirme também as suas permissões no Agencify antes de autorizar mais acesso.
• Os números parecem antigos: confirme o período e peça para atualizar os dados. Se a atualização falhar, verifique a ligação da conta em Integrações no Agencify.
• A resposta parou durante uma alteração: peça “Verifica se o pedido anterior foi concluído antes de tentar novamente”. Isto ajuda a evitar repetir uma ação já executada.

Como confirmar o resultado

Depois de uma alteração, peça à IA que indique o que foi concluído e o que ficou pendente. Abra o mesmo cliente no Agencify e confirme a campanha ou o recurso alterado. “Em curso” ainda não significa concluído.

Se precisar de ajuda, utilize o apoio desta página. Explique o que tentou fazer e a mensagem apresentada. Não envie palavras-passe nem dados privados de clientes.