Ir para o conteúdo

Referência das ferramentas

Upwork

Upwork. 19 ferramentas, com seus parâmetros e exemplos de chamada.

Ferramentas do agente Upwork: vagas públicas lidas, pontuadas e respondidas a partir da base de conhecimento do workspace. Nada é enviado ao Upwork.

Cada chamada é uma requisição POST com a chave em Authorization: Bearer. O corpo JSON é a entrada da ferramenta, e a resposta tem o formato { "tool": "nom", "output": … }. Os exemplos trazem apenas os parâmetros obrigatórios. As descrições dos parâmetros são as que os agentes leem.

searchUpworkJobs#

Lê uma página de resultados públicos (cerca de dez vagas) e pontua cada vaga em relação à base de conhecimento. As vagas são adicionadas ao pipeline do workspace.

POSThttps://piqline.com/api/v1/tools/searchUpworkJobs

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
qstringSimKeywords as a client would write them in a job post, e.g. 'next.js developer'
jobTypeany | hourly | fixedNão
hourlyMinintegerNãoHourly rate floor in USD
hourlyMaxintegerNão
fixedMinintegerNãoFixed-price budget floor in USD
fixedMaxintegerNão
experiencearray<entry | intermediate | expert>Não
proposalsarray<0-4 | 5-9 | 10-14 | 15-19 | 20-49>NãoKeep only jobs with this many proposals so far (less competition)
clientHiresarray<0 | 1-9 | 10+>Não
pageintegerNão
scorebooleanNãoScore each job against the knowledge base (judge capped at 12 per call)
persistbooleanNãoAdd the jobs to the workspace pipeline (upwork_pipeline)
curl -s https://piqline.com/api/v1/tools/searchUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"levée de fonds"}'

getUpworkJob#

Lê uma vaga: descrição, habilidades, orçamento, atividade, cliente. Adiciona um instantâneo datado ao pipeline.

POSThttps://piqline.com/api/v1/tools/getUpworkJob

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
urlstringSim
scorebooleanNão
curl -s https://piqline.com/api/v1/tools/getUpworkJob \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'

scoreUpworkJobs#

Pontua de novo as vagas do pipeline após uma mudança na base de conhecimento. Nenhuma página é lida.

POSThttps://piqline.com/api/v1/tools/scoreUpworkJobs

Tipo: Escrita. Scopes: write.

ParâmetroTipoObrigatórioDescrição
jobIdsarray<string>Sim
curl -s https://piqline.com/api/v1/tools/scoreUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobIds":["texte"]}'

getUpworkRadar#

Radar de mercado: volume por dia, quartis de valor por hora e de orçamento, habilidades, concorrência, países dos clientes.

POSThttps://piqline.com/api/v1/tools/getUpworkRadar

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
searchobjectNão
curl -s https://piqline.com/api/v1/tools/getUpworkRadar \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkLeads#

Pipeline do Upwork: contagem por status, melhores vagas primeiro, desfecho de cada uma.

POSThttps://piqline.com/api/v1/tools/listUpworkLeads

Tipo: Leitura. Scopes: read.

ParâmetroTipoObrigatórioDescrição
statusarray<new | shortlisted | drafted | submitted | viewed | replied | interview | won | …>Não
minScoreintegerNão
limitintegerNão
curl -s https://piqline.com/api/v1/tools/listUpworkLeads \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

updateUpworkLead#

Altera o status de uma vaga do pipeline (enviada, resposta, entrevista, ganha, perdida, ignorada) e guarda uma nota.

POSThttps://piqline.com/api/v1/tools/updateUpworkLead

Tipo: Escrita. Scopes: write.

ParâmetroTipoObrigatórioDescrição
jobIdstringSim
statusnew | shortlisted | drafted | submitted | viewed | replied | interview | won | …Sim
notestringNão
curl -s https://piqline.com/api/v1/tools/updateUpworkLead \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","status":"new"}'

getUpworkKnowledge#

Base de conhecimento Upwork do workspace: serviços, ferramentas, projetos a evitar, valores mínimos, estudos de caso, tom, assinatura.

POSThttps://piqline.com/api/v1/tools/getUpworkKnowledge

Tipo: Leitura. Scopes: read.

Esta ferramenta não recebe parâmetros: envie um corpo vazio, {}.

curl -s https://piqline.com/api/v1/tools/getUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

updateUpworkKnowledge#

Atualiza a base de conhecimento. As listas que você envia substituem as listas armazenadas.

POSThttps://piqline.com/api/v1/tools/updateUpworkKnowledge

Tipo: Escrita. Scopes: write.

ParâmetroTipoObrigatórioDescrição
namestringNão
headlinestringNão
servicesarray<string>Não
toolsarray<string>Não
avoidarray<string>NãoKinds of projects to never bid on, as short phrases or keywords
languagesarray<string>Não
hourlyMinnumberNãoLowest acceptable hourly rate, USD
fixedMinnumberNãoLowest acceptable fixed budget, USD
freelancerCountrystringNão
caseStudiesarray<object>Não
examplesarray<object>Não
tonestringNão
signaturestringNão
curl -s https://piqline.com/api/v1/tools/updateUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkTemplates#

Modelos de proposta salvos, com seus slots e suas regras de perguntas.

POSThttps://piqline.com/api/v1/tools/listUpworkTemplates

Tipo: Leitura. Scopes: read.

Esta ferramenta não recebe parâmetros: envie um corpo vazio, {}.

curl -s https://piqline.com/api/v1/tools/listUpworkTemplates \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

upsertUpworkTemplate#

Cria ou atualiza um modelo de proposta.

POSThttps://piqline.com/api/v1/tools/upsertUpworkTemplate

Tipo: Escrita. Scopes: write.

ParâmetroTipoObrigatórioDescrição
idstringSimStable slug; reuse it to update
namestringSim
bodystringSimLiteral text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code.
questionRulesarray<object>Não
curl -s https://piqline.com/api/v1/tools/upsertUpworkTemplate \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","name":"texte","body":"texte"}'

draftUpworkProposal#

Redige uma proposta para uma vaga a partir de um modelo. Você mesmo cola o texto no Upwork.

POSThttps://piqline.com/api/v1/tools/draftUpworkProposal

Tipo: Escrita. Scopes: write, explore.

ParâmetroTipoObrigatórioDescrição
urlstringNãoUpwork job URL
jobIdstringNãoJob id already in the pipeline, e.g. ~022113077029286601014
templateIdstringNãoTemplate id or name; default = first saved template, else the built-in one
screeningQuestionsarray<string>NãoScreening questions copied verbatim from the job
extraInstructionsstringNão
curl -s https://piqline.com/api/v1/tools/draftUpworkProposal \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkCampaigns#

Campanhas salvas: pesquisa, pontuação mínima, status, última atualização, saúde das fontes.

POSThttps://piqline.com/api/v1/tools/listUpworkCampaigns

Tipo: Leitura. Scopes: read.

Esta ferramenta não recebe parâmetros: envie um corpo vazio, {}.

curl -s https://piqline.com/api/v1/tools/listUpworkCampaigns \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

saveUpworkCampaign#

Cria ou atualiza uma campanha: nome, pesquisa, pontuação mínima, modelo.

POSThttps://piqline.com/api/v1/tools/saveUpworkCampaign

Tipo: Escrita. Scopes: write.

ParâmetroTipoObrigatórioDescrição
idstringNãoStable slug; reuse it to update an existing campaign
namestringSim
searchobjectSim
minScoreintegerNão
templateIdstringNão
curl -s https://piqline.com/api/v1/tools/saveUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"texte","search":{"q":"levée de fonds"}}'

simulateUpworkCampaign#

Simula uma campanha em vagas reais antes de acompanhá-la. Nada é salvo.

POSThttps://piqline.com/api/v1/tools/simulateUpworkCampaign

Tipo: Leitura ao vivo. Scopes: explore.

ParâmetroTipoObrigatórioDescrição
campaignIdstringNão
campaignobjectNão
pagesintegerNão
curl -s https://piqline.com/api/v1/tools/simulateUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

followUpworkCampaign#

Pede ao Motor que acompanhe uma campanha salva, no ritmo de coleta dela.

POSThttps://piqline.com/api/v1/tools/followUpworkCampaign

Tipo: Ação. Scopes: act.

ParâmetroTipoObrigatórioDescrição
campaignIdstringSim
namestringNãoNom de la campagne, pour la carte de confirmation.
curl -s https://piqline.com/api/v1/tools/followUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'

pauseUpworkCampaign#

Faz o Motor parar de acompanhar uma campanha. As vagas já vistas permanecem no pipeline.

POSThttps://piqline.com/api/v1/tools/pauseUpworkCampaign

Tipo: Ação. Scopes: act.

ParâmetroTipoObrigatórioDescrição
campaignIdstringSim
namestringNãoNom de la campagne, pour la carte de confirmation.
curl -s https://piqline.com/api/v1/tools/pauseUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'

refreshUpworkCampaigns#

Atualiza as campanhas acompanhadas: mescla as vagas coletadas pelo Motor, lê de novo a primeira página ao vivo, pontua as novas vagas.

POSThttps://piqline.com/api/v1/tools/refreshUpworkCampaigns

Tipo: Escrita. Scopes: write, explore.

ParâmetroTipoObrigatórioDescrição
campaignIdstringNão
livebooleanNão
curl -s https://piqline.com/api/v1/tools/refreshUpworkCampaigns \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

checkUpworkOutcomes#

Lê de novo as páginas das candidaturas em andamento para datar o desfecho: encerrada, entrevistas iniciadas, sem resposta.

POSThttps://piqline.com/api/v1/tools/checkUpworkOutcomes

Tipo: Escrita. Scopes: write, explore.

ParâmetroTipoObrigatórioDescrição
jobIdsarray<string>Não
limitintegerNão
curl -s https://piqline.com/api/v1/tools/checkUpworkOutcomes \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

syncUpworkReplies#

Lê os e-mails de notificação do Upwork nas caixas de entrada conectadas do criador da chave e avança o status das vagas do pipeline.

POSThttps://piqline.com/api/v1/tools/syncUpworkReplies

Tipo: Escrita. Scopes: write.

ParâmetroTipoObrigatórioDescrição
accountIdstringNão
limitintegerNão
curl -s https://piqline.com/api/v1/tools/syncUpworkReplies \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Uma dúvida sobre a API, ou um erro nesta página? Escreva para nós.