Pular para o conteúdo principal
Atualizado em Nov 1, 2026

Pesquisar Dados da Empresa

Use esta ação quando precisar de uma lista de registros correspondentes em vez de um registro específico.

Melhor para​

  • Procurar contatos, serviços, eventos ou workflows por filtros
  • Encontrar o registro correspondente mais recente ou mais antigo
  • Direcionar passos posteriores com base na existência ou não de correspondências

Campos principais​

CampoO que faz
Dynadata Item TypeEscolhe que tipo de registros pesquisar
filter (CEL -> Mongo filter)Define quais registros devem corresponder. Não use $regex aqui — é rejeitado com um erro 400; use Busca + Campos de busca para correspondência de texto parcial
BuscaTermo de substring ("contém") sem distinção de maiúsculas e minúsculas, comparado literalmente contra os campos listados em Campos de busca
Campos de buscaOs nomes de campo contra os quais o termo de Busca é comparado, p. ex. ["name","email"]
sort (CEL -> sort object)Controla a ordem com um mapa de um campo ou pares [field, direction] ordenados
LimiteControla quantos registros retornar. Se deixar vazio, o padrão é 50
PularPermite paginar os resultados

Ordem de classificação​

Para um campo, um mapa é aceito:

{'createdAt': -1}

Para vários campos, use uma lista ordenada de pares. O primeiro par tem a maior prioridade: este exemplo ordena por priority decrescente e depois por createdAt crescente quando as prioridades são iguais.

[['priority', -1], ['createdAt', 1]]

1 significa crescente e -1 significa decrescente. Mapas CEL não têm ordem, por isso uma ordenação composta em mapa é rejeitada. Informe no máximo 32 campos, sem nomes de campo duplicados; pares malformados são rejeitados.

O que passos posteriores podem usar​

Os registros correspondentes estão disponíveis em:

  • workflow.step(N).data
  • workflow.step(N).data[0]

Dicas​

  • Use ordenação junto com um limite baixo quando precisar apenas da primeira correspondência relevante.
  • Verifique se workflow.step(N).data está vazio antes de assumir que um resultado existe.
  • Este é frequentemente o primeiro passo correto antes de uma ação posterior de atualização ou notificação.
  • Para correspondência de texto parcial / "contém", use Busca + Campos de busca em vez de um filtro $regex (que é rejeitado com um erro 400).