Encontrar negócios com um produto
O robô «Encontrar negócios com um produto» encontra no Bitrix24 (Alaio) os negócios cujos produtos incluem um produto dado, com filtro por contato, empresa e negócios abertos, e retorna seus IDs, a quantidade e o ID do mais recente.
O robô busca negócios por um produto do catálogo. Um processo de negócios não tem uma forma padrão de saber em quais negócios um produto específico é vendido: o filtro da lista de negócios por produtos não está disponível para robôs. O robô recebe um ID de produto e, opcionalmente, um ID de contato, um ID de empresa e a marca «apenas negócios abertos» (fora de uma etapa final), verifica os negócios que atendem ao filtro do mais novo ao mais antigo e retorna os IDs daqueles que têm o produto entre seus produtos, a quantidade e o ID do mais recente. O número de negócios retornados é limitado por uma configuração (50 por padrão) e a verificação aos 500 mais recentes pelo filtro, para que o robô não sobrecarregue a conta. Se não houver negócios, a quantidade é zero e o processo pode seguir outro ramo.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| ID do produto | int | sim | |
| ID do contato (opcional) | string | — | |
| ID da empresa (opcional) | string | — | |
| Apenas negócios abertos | bool | — | N |
| Quantos negócios retornar (50 por padrão; são verificados os 500 mais recentes pelo filtro) | int | — | 50 |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| IDs dos negócios encontrados | int |
| Número de negócios encontrados | int |
| ID do primeiro (mais recente) negócio | int |
| Sucesso | bool |
| Erro | string |
Quais erros o robô pode retornar?
O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.
- Informe o ID do produto.
- Erro de API ao buscar negócios.
Cenário: avisar os gerentes sobre o recall de um produto
- O processo é iniciado manualmente com o ID do produto
- O robô retorna os IDs dos negócios abertos que contêm esse produto
- Um laço sobre a lista cria uma tarefa para o responsável de cada negócio