Conectar fontes: Instagram, TikTok, YouTube, Telegram, site
Como o agente lê as suas publicações e vídeos e cria um catálogo a partir deles. O que é necessário para cada fonte, quanto tempo demora e o que fazer em caso de erros.
O catálogo é o que o agente usa na conversa: nomes, preços, tamanhos, composição, fotos, link para a publicação original. Pode ser compilado a partir de cinco fontes, e estas coexistem perfeitamente: o site fornece os preços, o Instagram as fotos e descrições vívidas, o YouTube os detalhes que explica por voz.
Todas as fontes são conectadas num só local: «Definições» → «Fontes do Catálogo». O mesmo está disponível na página principal da área de cliente, nos blocos «Catálogo de».
Como funciona#
A mecânica é a mesma para todas as redes sociais. O serviço recolhe a lista das publicações mais recentes, descarrega as legendas e os ficheiros multimédia, entrega-os ao modelo e recebe cartões estruturados. O Gemini ouve adicionalmente os vídeos: ele transcreve a fala, lê as legendas no ecrã e memoriza os preços mencionados.
Em seguida, os cartões são adicionados ao catálogo. Uma análise repetida não cria duplicados: a publicação é identificada pelo seu ID, e o cartão antigo é atualizado.
Dois parâmetros controlam o processo:
- Número de publicações — 10, 25, 50 ou 100. Ao lado de cada número, encontra-se o tempo estimado: de um a doze minutos.
- Profundidade — «Rápido» lê legendas e capas, «Profundo» descarrega vídeos e entrega-os na íntegra ao Gemini. A análise profunda é mais cara em termos de limites, mas é ela que extrai os preços que menciona por voz.
Cada publicação analisada é deduzida do limite do plano. No período de teste, são 100 publicações e 60 minutos de vídeo; no plano «Tudo incluído», são 2000 publicações e 600 minutos por mês. O saldo é visível na página principal da área de cliente.
Site#
A fonte mais simples, se tiver uma loja online.
- Abra «Definições» → «Fontes do Catálogo».
- Introduza o endereço, como
https://shop.example, e clique em «Analisar». - Após um a cinco minutos, aparecerá um resumo: quantas páginas foram visitadas, quantos produtos foram encontrados.
A varredura lê os cartões de produto, preços, disponibilidade e características, determinando simultaneamente a moeda da loja e aplicando-a às definições. Ao mesmo tempo, o nome da loja, a saudação e a descrição da pré-visualização são preenchidos — estes podem ser corrigidos manualmente mais tarde.
Se o site estiver protegido por palavra-passe, fornecer conteúdo apenas via JavaScript ou bloquear robôs, a varredura retornará poucos itens. Nesse caso, é mais fiável carregar os produtos via ficheiro CSV na secção «Catálogo» ou adicioná-los manualmente.
Instagram#
O Instagram exige login: sem autenticação, a rede não fornece publicações. O nome de utilizador e a palavra-passe são inseridos na secção de fontes; a palavra-passe é armazenada de forma encriptada e usada apenas para ler o seu próprio feed.
A ordem é a seguinte:
- Introduza o nome de utilizador e a palavra-passe, clique em «Entrar».
- Se o Instagram solicitar um código de SMS, e-mail ou aplicação de autenticação, o campo para o código aparecerá imediatamente. Introduza-o no prazo de um minuto.
- Após a mensagem «conectado», selecione o número de publicações e a profundidade, clique em «Analisar».
O que é extraído de uma publicação: texto da legenda, foto, vídeo, preço, se mencionado, e o link para a publicação. Um carrossel é analisado na íntegra, Reels — como vídeo.
O Instagram não gosta de logins a partir de IPs desconhecidos. Se a conta estiver protegida por autenticação de dois fatores e aceder frequentemente a partir do telemóvel, o primeiro login a partir do servidor pode exigir confirmação. No campo «Proxy», pode especificar o seu endereço, como http://user:pass@host:port — assim, o login ocorrerá a partir de uma região familiar para a conta.
Pode desconectar a conta com o botão «Desconectar»: a palavra-passe é apagada, o catálogo compilado permanece.
TikTok#
Aqui não é necessária palavra-passe. Basta o nome de utilizador do perfil — com ou sem arroba, @shop e shop são equivalentes.
O serviço recolhe as descrições e os próprios vídeos; numa análise profunda, o Gemini ouve a fala e lê o texto no ecrã. O TikTok é um caso em que a profundidade compensa: os preços e a composição são mais frequentemente ditos em voz alta do que escritos na descrição.
A velocidade depende da duração dos vídeos. Cinquenta vídeos curtos são seis a oito minutos; cinquenta análises longas podem demorar meia hora.
YouTube#
Introduza o link do canal ou o @handle. Todas as formas funcionam: youtube.com/@channel, youtube.com/c/name, apenas @channel.
O Gemini lê os vídeos diretamente através do link — não descarregamos vídeos para o servidor nem acedemos à sua conta. Portanto, a questão «não seremos banidos?» resolve-se por si só: do lado do YouTube, isto parece uma visualização normal.
Restrições que deve conhecer:
- Vídeos com mais de 45 minutos são ignorados: a análise de um vídeo tão longo custa mais do que o benefício que proporciona. No relatório, aparecem na linha «ignorados».
- Uma única execução de análise funciona por no máximo três horas, depois para automaticamente. O restante é recuperado com o botão «Continuar com os mais antigos».
- Vídeos privados e com restrição de idade não estão disponíveis.
O YouTube é excelente para serviços e produtos complexos: num vídeo de trinta minutos, geralmente é dito tudo o que os clientes perguntam mais tarde.
Telegram-canal#
É necessário um canal público: @channel ou t.me/channel. Canais e grupos privados não são lidos.
Dos posts, são retirados texto, fotos e vídeos; dos vídeos, a fala e as legendas. O Telegram é conveniente porque é onde se escreve com mais frequência em detalhe: tamanhos, composição, condições. Tais posts transformam-se em cartões quase sem perdas.
Análise repetida e «Continuar com os mais antigos»#
O botão «Analisar» começa sempre pelas publicações mais recentes. Quando as novas publicações já foram analisadas, aparece um segundo botão — «Continuar com os mais antigos». Este move a janela mais para o fundo do feed e recolhe a próxima porção.
É assim que se constrói um grande arquivo: hoje 100 recentes, amanhã mais 100 antigos. Os limites do plano são consumidos gradualmente, e o catálogo cresce sem duplicados.
Se o catálogo não estiver bem#
Isto acontece, e a causa normalmente não é o modelo, mas sim as publicações de origem. Verifique por esta ordem:
- Descrições vazias. Abra o «Agente do Proprietário» e clique em «Auditoria de Qualidade do Catálogo» — ele mostrará os cartões sem preço, sem descrição e com nomes iguais.
- Preços nos comentários. Se escrever «preço por mensagem privada», o agente regista «preço sob consulta». É mais simples adicionar os preços aos cartões manualmente.
- Legendas demasiado curtas. Um emoji e hashtags não dão material ao modelo. Uma análise aprofundada ajuda: num vídeo, geralmente é dito mais do que na legenda.
- Publicações desnecessárias. Avaliações, memes e anúncios por vezes transformam-se em cartões. Remova-os no «Catálogo», uma nova análise não os trará de volta.
O catálogo também pode ser editado manualmente: na secção «Catálogo», pode alterar o nome, o preço, a descrição, adicionar ou remover um item. O Agente do Proprietário faz o mesmo a pedido: «aumenta o preço dos brincos em 10 %» ou «completa as descrições onde não existem».
Perguntas Frequentes#
É necessária uma chave Gemini para as redes sociais#
Para uma análise rápida — não, a chave Claude é suficiente. Para uma análise aprofundada, é necessária a Gemini: é ela que analisa os vídeos. No plano «Tudo Incluído», ambas as chaves são nossas, não precisa de introduzir nada.
A conta no Instagram será bloqueada#
Lemos o feed como um cliente normal e não publicamos nada em seu nome. O risco surge quando o acesso é feito a partir de uma região incomum: nesse caso, o Instagram pede uma confirmação. Um proxy nas definições da fonte resolve isto.
Quantas publicações analisar pela primeira vez#
Cinquenta — um começo razoável: são três a seis minutos e um catálogo suficiente para ver como o agente responde. Cem publicações fazem sentido quando o sortido é diversificado.
É possível ligar várias fontes em simultâneo#
Sim, e é uma prática normal: um site para preços, Instagram para fotografias, YouTube para detalhes. Os cartões de diferentes fontes vivem num único catálogo, cada um lembra-se de onde veio.
Com que frequência atualizar o catálogo#
À medida que surgem novas publicações. Uma vez por semana para uma conta ativa — um ritmo confortável. A análise de novas publicações leva um ou dois minutos, porque as antigas já foram analisadas.