Busca na web: como usar o bloco | Conecta-se

O que faz

Pesquise na web com a ferramenta de busca. Cada pesquisa custa US$ 0,01.

Quando usar: Use quando o seu fluxo precisar pesquisar informações atuais na web e devolver fontes para o fluxo.

Exemplo de situação: Buscar informação atual antes de formular a resposta.

Antes de começar

Conexão necessária: Sem conexão externa obrigatória.

Nenhuma conta externa é obrigatória para usar este bloco.

Passo a passo

Adicione Busca na web ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
Nenhuma conta externa é obrigatória para usar este bloco.
Revise a ação principal descrita no cartão do bloco.
Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
Só publique depois de conferir o resultado da execução de teste.

Campos

Consulta
Obrigatório
Informa a consulta usada para localizar ou transformar dados.
Exemplo:
SELECT * FROM clientes WHERE status = 'ativo'

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <buscanaweb.results>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Referência	Tipo	O que contém
`<buscanaweb.results>`	json	Resultados da busca.
`<buscanaweb.query>`	string	Termo pesquisado.
`<buscanaweb.totalResults>`	number	Número total de resultados.
`<buscanaweb.source>`	string	Fonte da busca (exa).
`<buscanaweb.cost>`	json	Informações de custo (US$ 0,01).

Exemplo de uso

Objetivo: Buscar informação atual antes de formular a resposta.

InícioBusca na webpróxima etapa

Consulta: SELECT * FROM clientes WHERE status = 'ativo'

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa: Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal: Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte: Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <buscanaweb.results>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.