Extrair valor de JSON por caminho
O robô «Extrair valor de JSON por caminho» analisa uma string JSON e retorna o valor no caminho com notação de pontos, por exemplo data.user.email ou items.0.name. Recebe o JSON e o caminho e retorna o valor como string, objetos e arrays como JSON, além de um indicador «Caminho encontrado» (Y/N). Funciona em processos de negócios e robôs do Bitrix24.
O robô analisa uma string JSON e extrai dela o valor no caminho com notação de pontos: chaves de objetos e índices numéricos de arrays, por exemplo data.result.0.id. Casos típicos: extrair o campo necessário da resposta do robô «Requisição HTTP GET/POST» ou de um JSON enviado por um sistema externo para um campo do negócio. Retorna o valor como string, objetos e arrays como JSON para análise posterior, além do indicador «Caminho encontrado» (Y/N). Se o JSON for inválido ou o caminho não existir, o robô retorna N — crie uma condição com ele no designer de processos e trate o erro em um ramo separado. Use o resultado em campos do CRM ou passe-o aos próximos robôs do processo de negócios.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| String JSON | string | sim | |
| Caminho com notação de pontos (ex.: data.result.0.id) | string | sim |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Valor extraído (string) | string |
| Valor extraído (JSON, se objeto/array) | string |
| Caminho encontrado (Y/N) | string |
Cenário: obter o e-mail do cliente da resposta de uma API externa
- O robô «Requisição HTTP» recebe uma resposta JSON de um sistema externo
- O robô extrai o valor no caminho data.user.email
- Se o caminho for encontrado, o e-mail é gravado em um campo do contato