Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Ligue o seu site

Leia páginas, produtos e encomendas diretamente da sua plataforma

Abrir a janela de ligação
Planos Standard, Pro e Enterprise

Visão Geral

Ligar o seu site dá à IA uma chave de leitura apenas para a sua plataforma. Em vez de rastrear as suas páginas por fora, pedimo-las diretamente à plataforma.

Assim chegamos a conteúdo que um rastreador não alcança. Passam as páginas atrás de um início de sessão, as páginas profundas para as quais nada aponta e os sites atrás de uma barreira antibots. Os preços e o stock mantêm-se atuais, porque voltamos a lê-los em vez de confiar no que a página dizia no dia do rastreio.

Apenas leitura. Nada no seu site é criado, alterado ou eliminado. Cada chamada que fazemos é de leitura.

Os três tipos de dados

É você que escolhe o que partilha. Cada escolha corresponde a algo a que o assistente poderá responder.

Escolha O que traz A que o assistente pode responder
Páginas O conteúdo do seu site, sincronizado automaticamente. Perguntas sobre as suas políticas, serviços, cursos, guias e qualquer outra página escrita.
Produtos Preços atuais, stock, links e imagens. O que vende, quanto custa, se há stock, e uma ligação para comprar.
Encomendas Consulta do estado das encomendas para os seus clientes. Onde está a encomenda de um cliente, quando foi enviada e o que continha.

Que plataformas funcionam

Todas. Seja qual for a base do seu site, o assistente pode responder a partir das suas páginas, dos seus produtos e das suas encomendas.

Algumas plataformas podem ser lidas diretamente com uma chave API. Nas restantes, os mesmos dados chegam por um rastreio, um feed de produtos, o contexto do utilizador ou as suas próprias ferramentas. Não precisa de descobrir qual é o seu caso: abra a janela, escolha a plataforma, marque o que quer partilhar e verá os passos indicados para si.

Ver os passos da sua plataforma

Criou o seu site de raiz? Escolha Personalizado / sem CMS na janela. Um site feito à mão, uma configuração headless ou qualquer plataforma que não nomeamos funcionam da mesma forma.
Duas credenciais numa loja WooCommerce. O WooCommerce lê produtos e encomendas. As páginas vêm do WordPress por baixo, que precisa da sua própria palavra-passe de aplicação. A janela avisa quando é necessária uma segunda chave.

Como ligar

  1. Abra o seu painel e encontre Ligue o seu site, ao lado de Adicionar à base de conhecimento.
  2. Escolha a sua plataforma na lista. Selecione Personalizado / sem CMS se criou o site de raiz.
  3. Marque o que quer partilhar: páginas, produtos, encomendas ou qualquer combinação.
  4. Prima Continuar. Verá agora os passos de configuração escritos para a sua plataforma e as suas escolhas.
  5. Siga os passos na administração da sua plataforma para criar a chave.
  6. Cole a chave nos campos na parte inferior da mesma janela e prima Ligar.

O que acontece quando prime Ligar

Verificamos a credencial antes de a guardar. Uma chave errada nunca é guardada.

  1. Fazemos uma chamada real à sua plataforma com a credencial que colou.
  2. Se falhar, o erro aparece por baixo do botão e os campos continuam editáveis para que possa corrigir.
  3. Se resultar, guardamos a ligação e começamos a ler o seu conteúdo.
  4. A janela comunica então o resultado: quantos itens entraram, ou exatamente o que correu mal.
A primeira leitura corre em segundo plano. Pode fechar a janela e termina sozinha.

Manter-se sincronizado

Voltamos a ler o seu conteúdo de forma periódica, para que uma alteração de preço ou uma página nova cheguem ao assistente sem que faça nada.

Só é reindexado o que mudou. Comparamos o conteúdo de cada item com o que já temos, por isso uma página inalterada não custa nada. Também pode premir Sincronizar agora na página de definições da plataforma a qualquer momento.

Permissões e acesso

O que uma chave consegue ver depende da plataforma, e a diferença importa.

O Magento, o Shopify, o WooCommerce e o BigCommerce concedem permissões por recurso. Se marcar apenas produtos, a chave chega mesmo só aos produtos.

O WordPress e o Moodle não funcionam assim. Uma palavra-passe de aplicação do WordPress herda as permissões da conta que a criou, e um token do Moodle vê o que o seu utilizador vê. Não há lista de âmbitos para marcar. Use uma conta sem mais acesso do que o conteúdo que quer ver respondido, e lembre-se de que as publicações privadas e protegidas por palavra-passe também entram.

Do nosso lado lemos apenas rotas de conteúdo, e só com GET. Nunca escrevemos.

Ligar sem chave API

Cada escolha tem também um caminho que não precisa de chave nenhuma. Funcionam em qualquer plataforma e a janela apresenta-os ao lado dos passos.

Em vez de Usar O que faz
Páginas Rastrear Lemos o seu site inteiro e guardamos o conteúdo na base de conhecimento.
Produtos Feed de dados em tempo real Indique-nos o URL de um feed de produtos público. A partir daí, os preços e o stock mantêm-se sincronizados.
Encomendas Contexto do usuário ou Ferramentas personalizadas Envie os dados do cliente com sessão iniciada a partir do seu site, ou ligue um endpoint próprio que o assistente possa chamar.

Desligar

Abra a página de definições da plataforma a partir da janela e prima Desligar. Isto remove a credencial guardada e elimina tudo o que essa chave trouxe para a sua base de conhecimento. O conteúdo de outras fontes fica intacto.

Também pode revogar a chave na sua plataforma. A sincronização seguinte falha então com um erro de autenticação e nada de novo é lido.

Solução de Problemas

O que vê O que costuma significar
Falha na autenticação A chave está errada, expirou ou foi revogada. No WordPress isto também acontece quando se cola a palavra-passe normal de início de sessão em vez de uma palavra-passe de aplicação.
Concluído, mas não encontrámos nada para ler A credencial funciona, mas a conta por trás dela não vê qualquer conteúdo. Escolha uma conta com acesso às páginas ou produtos que quer ver respondidos.
Ligado, mas não conseguimos ler o seu conteúdo A chave foi aceite e depois a leitura falhou. O erro exato da sua plataforma é mostrado junto com a mensagem.
Falta uma permissão A chave foi criada sem um dos recursos indicados nos passos. Crie-a novamente com todas as permissões que a janela nomeou.