Criar um evento no calendário
O robô «Criar um evento no calendário» adiciona um evento ao calendário do funcionário escolhido em processos de negócios e robôs do Bitrix24 (Alaio). Aceita um título, a data e hora de início, a duração em minutos, uma descrição, um local, participantes e um lembrete; o evento também pode ser de dia inteiro. Retorna um indicador «Sucesso» Y/N, o ID do novo evento e um texto de erro.
O robô coloca uma reunião ou um lembrete direto no calendário de um funcionário, sem abrir o calendário à mão. O dono do calendário é qualquer funcionário, por exemplo o responsável pelo negócio. O início é uma data e hora, inclusive de um campo do cartão ou de uma expressão como «agora mais um dia»; a duração é em minutos, uma hora por padrão. O evento pode ser de dia inteiro e ter descrição e local. Quando há participantes, o evento vira uma reunião e eles recebem um convite. O lembrete é um número de minutos antes do início. O horário é lido da mesma forma que no designer de processos. Casos típicos de uso: agendar para o gestor uma ligação ao cliente amanhã; marcar uma reunião com o cliente quando o negócio chega à etapa «Apresentação»; marcar no calendário a data de fim do contrato. Retorna «Sucesso» Y/N, o ID do evento — serve para encontrá-lo ou excluí-lo — e um texto de erro.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Calendário de | user | sim | |
| Título do evento | string | sim | |
| Início | datetime | sim | |
| Duração, minutos (60 por padrão) | int | — | 60 |
| Dia inteiro | bool | — | N |
| Descrição | text | — | |
| Participantes (convites) | user | — | |
| Local | string | — | |
| Lembrar antes, minutos | int | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Sucesso (Y/N) | string |
| ID do evento | int |
| 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.
- Erro: nenhum dono do calendário selecionado (departamentos e grupos não são aceitos)
- Erro: o título do evento está vazio
- Erro: não foi possível ler a data de início «{value}»
- Erro do calendário: {message}
Cenário: uma reunião após a qualificação
- Um negócio passa para a etapa «Reunião agendada» e o cartão tem a data da reunião
- O robô cria no calendário do responsável um evento de 90 minutos nessa data e convida o gestor
- Ambos recebem um lembrete 30 minutos antes do início