Encontrar negócio por condição
O robô «Encontrar negócio por condição» procura negócios no CRM do Bitrix24 por filtro: ID do contato ou da empresa, etapa, responsável ou um filtro JSON personalizado. Suporta ordenação e limite de resultados (até 50). Retorna o ID e o título do primeiro negócio encontrado, a lista de todos os IDs, a quantidade e um indicador «Encontrado» (Y/N). Funciona em processos de negócios e robôs do Bitrix24.
O robô procura negócios no CRM do Bitrix24 pelas condições definidas: ID do contato, ID da empresa, etapa (ex.: WON ou C1:NEW), responsável e, para condições fora do padrão, um filtro JSON personalizado que é combinado com os demais campos. Há ordenação por data de criação, data de modificação ou ID e limite de resultados de 1 a 50 (padrão 5). Casos típicos: encontrar o negócio aberto de um contato para não criar um duplicado em uma nova solicitação, ou obter o último negócio de uma empresa antes de mudar a etapa. Retorna o ID e o título do primeiro negócio, a lista de todos os IDs encontrados, a quantidade e o indicador «Encontrado» (Y/N) — use-o em uma condição no designer de processos e passe os IDs aos próximos robôs.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| ID do contato | int | — | |
| ID da empresa | int | — | |
| Etapa (ex.: WON, LOSE, C1:NEW) | string | — | |
| ID do responsável | int | — | |
| Filtro personalizado (JSON, ex.: {"CLOSED":"N"}) | string | — | |
| Ordenação: CREATED_DATE / DATE_MODIFY / ID (padrão DATE_MODIFY DESC) | string | — | |
| Máximo de resultados (padrão 5) | int | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| ID do primeiro negócio encontrado | int |
| Título do primeiro negócio | string |
| Todos os IDs encontrados | int |
| Quantidade de negócios encontrados | int |
| Encontrado (Y/N) | string |
Cenário: evitar negócios duplicados para um contato
- Uma nova solicitação do site inicia um processo de negócios no contato
- O robô procura negócios abertos desse contato com o filtro CLOSED=N
- Se um negócio for encontrado, a solicitação é adicionada a ele; caso contrário, um novo é criado