Obter os comentários do item
O robô «Obter os comentários do item» lê os comentários da linha do tempo de um lead, negócio, contato, empresa, proposta, fatura ou item de processo inteligente no Bitrix24 (Alaio) e os devolve ao processo de negócio: como uma cadeia com autor e data, como lista para percorrer, como matriz JSON e como campos separados do último comentário. Permite filtrar por autor, por período de criação e por quantidade de registros mais recentes.
O robô lê os comentários da linha do tempo e os repassa adiante no processo. A origem é definida por tipo e ID; um ID vazio significa o item atual, então dá para reunir os comentários do próprio cartão ou de um relacionado. A saída vem em quatro formas de uma vez porque o uso seguinte varia bastante: a cadeia com autor e data cabe em um campo ou em um e-mail, o valor múltiplo é percorrido por um laço do processo, o JSON vai para um sistema externo por HTTP, e os campos do último comentário resolvem a pergunta mais comum de todas, o que foi escrito da última vez. O filtro funciona por autor, por período de criação e por quantidade de registros recentes; o limite de quantidade é aplicado por último, sobre o que já passou pelos demais filtros. Cada execução percorre até 1000 comentários e devolve até 200.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Origem: tipo | select | sim | current |
| Origem: ID (vazio = atual) | int | — | |
| Origem: ID do tipo de processo inteligente | int | — | |
| Filtro: autor (vazio = todos) | user | — | |
| Filtro: a partir da data | date | — | |
| Filtro: até a data | date | — | |
| Filtro: apenas os últimos N comentários | int | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Sucesso (Y/N) | string |
| Comentários encontrados | int |
| Comentários em uma cadeia | string |
| Comentários como lista | string |
| Comentários em JSON | string |
| Último comentário: texto | string |
| Último comentário: autor | string |
| Último comentário: data | string |
| 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.
- Faltam o tipo, o ID do item ou o ID do tipo de processo inteligente
- Não foi possível determinar o item atual: execute o robô em um processo de um item de CRM ou de processo inteligente
- Item não encontrado ou sem permissão de leitura
- Erro do Bitrix24 ao ler os comentários, detalhes no registro
Cenário: enviar ao gestor os últimos comentários de um negócio
- Adicione o robô «Obter os comentários do item» à automação do negócio
- Origem: Item atual, «apenas os últimos N comentários» — 5
- Na etapa seguinte envie uma notificação usando o resultado «Comentários em uma cadeia»
- A notificação levará os cinco últimos comentários com autores e datas