Crear un evento en el calendario
El robot «Crear un evento en el calendario» añade un evento al calendario del empleado elegido en los procesos de negocio y robots de Bitrix24 (Alaio). Acepta un título, la fecha y hora de inicio, la duración en minutos, una descripción, un lugar, participantes y un recordatorio; el evento también puede ser de todo el día. Devuelve un indicador «Correcto» Y/N, el ID del nuevo evento y un texto de error.
El robot pone una reunión o un recordatorio directamente en el calendario de un empleado, sin abrir el calendario a mano. El propietario del calendario es cualquier empleado, por ejemplo el responsable de la negociación. El inicio es una fecha y hora, también tomada de un campo de la ficha o de una expresión como «ahora más un día»; la duración va en minutos, una hora por defecto. El evento puede ser de todo el día y llevar descripción y lugar. Si se indican participantes, el evento pasa a ser una reunión y ellos reciben una invitación. El recordatorio es un número de minutos antes del inicio. La hora se lee igual que en el diseñador de procesos. Casos de uso típicos: programar al gestor una llamada al cliente para mañana; fijar una reunión con el cliente cuando la negociación llega a la etapa «Presentación»; marcar en el calendario la fecha de fin del contrato. Devuelve «Correcto» Y/N, el ID del evento — sirve para encontrarlo o eliminarlo — y un texto de error.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| Calendario de | user | sí | |
| Título del evento | string | sí | |
| Inicio | datetime | sí | |
| Duración, minutos (60 por defecto) | int | — | 60 |
| Todo el día | bool | — | N |
| Descripción | text | — | |
| Participantes (invitaciones) | user | — | |
| Lugar | string | — | |
| Recordar antes, minutos | int | — |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Correcto (Y/N) | string |
| ID del evento | int |
| Error | string |
¿Qué errores puede devolver el robot?
El robot escribe estos mensajes en el registro del proceso de negocio cuando no puede completar un paso. El texto indica qué corregir en la configuración o en los datos.
- Error: no se seleccionó el propietario del calendario (departamentos y grupos no se admiten)
- Error: el título del evento está vacío
- Error: no se pudo leer la fecha de inicio «{value}»
- Error del calendario: {message}
Escenario: una reunión tras la calificación
- Una negociación pasa a la etapa «Reunión programada» y la ficha tiene la fecha de la reunión
- El robot crea en el calendario del responsable un evento de 90 minutos en esa fecha e invita al jefe
- Ambos reciben un recordatorio 30 minutos antes del inicio