Referencia: eventos, condiciones y acciones de las Automatizaciones
Este artículo es la referencia completa de los tres bloques de una automatización. Para el paso a paso de creación, mira Creando una automatización.
Eventos (Cuándo se ejecuta)
El evento es lo que llama a la automatización. Al elegir uno, sus campos de configuración aparecen justo debajo.
Grupo Embudo
| Evento | Cuándo se dispara | Campos |
|---|---|---|
| Oportunidad creada | La oportunidad no existía y fue creada | Embudo (específico o todos) · Etapa (específica o cualquiera) |
| Oportunidad entró en la etapa | La oportunidad ya existía y entró en la etapa | Embudo · A la etapa (en blanco = cualquiera) · Solo una vez por oportunidad |
| Oportunidad detenida en la etapa hace N días | La oportunidad cumplió N días detenida en la etapa | Embudo · Etapa (en blanco = cualquiera) · Detenida hace (días) · Solo una vez por oportunidad |
| Oportunidad ganada | La oportunidad fue marcada/arrastrada a Ganada | Embudo (específico o cualquiera) · Solo una vez por oportunidad |
| Oportunidad perdida | La oportunidad fue marcada/arrastrada a Perdida | Embudo (específico o cualquiera) · Solo una vez por oportunidad |
Sobre Solo una vez por oportunidad: activado, la tarjeta que vuelva a la misma etapa no se dispara de nuevo; desactivado, cada paso por la etapa la dispara.
Sobre detenida en la etapa hace N días:
- El conteo empieza cuando la oportunidad entra en la etapa (una tarjeta creada en ella cuenta desde la creación);
- La verificación corre cada hora — el disparo ocurre en la primera verificación después del plazo;
- Cada tarjeta se dispara una vez por paso por la etapa: si sale y vuelve, puede dispararse de nuevo (a menos que Solo una vez por oportunidad esté activado).
Grupo Contacto
| Evento | Cuándo se dispara | Campos |
|---|---|---|
| Contacto creado | Se creó un contacto nuevo | — |
| Etiqueta añadida al contacto | Se aplicó la etiqueta elegida | Etiqueta · Solo una vez por oportunidad |
| Etiqueta quitada del contacto | Se quitó la etiqueta elegida | Etiqueta · Solo una vez por oportunidad |
Grupo Conversación
| Evento | Cuándo se dispara | Campos |
|---|---|---|
| Nueva conversación | Se creó una conversación | Canal (en blanco = todos) |
| Conversación asignada | Una conversación fue asignada a alguien | Canal · Sector |
| Conversación cerrada | Una conversación fue cerrada | Canal (opcional) |
| Conversación reabierta | Una conversación cerrada fue reabierta | Canal (opcional) |
| La IA pasó a un humano | El agente de IA transfirió la conversación a un humano | Canal (opcional) |
Condiciones (Solo si)
Sin condiciones, la automatización se ejecuta siempre que la llamen. Con condiciones, elige el modo:
- Todas las condiciones — conector Y: todas deben ser verdaderas;
- Cualquiera de ellas — conector O: basta con que una sea verdadera.
Ejemplo: etiqueta tiene "cliente activo" + sector es "General" → en Todas las condiciones, solo se ejecuta con las dos verdaderas; en Cualquiera de ellas, se ejecuta con cualquiera de las dos.
Campos disponibles
| Grupo | Campos |
|---|---|
| Contacto | Etiqueta · Origen · Tipo · Sector · Correo · Empresa |
| Oportunidad | Embudo · Etapa · Valor de la oportunidad (mayor, igual o menor que X) · Responsable · Título |
| Conversación | Canal · Sector · Responsable · IA activa · Estado |
| Disparador | Etapa de origen — la etapa de donde vino la oportunidad |
| Campos personalizados | Todos los campos personalizados del contacto y de la oportunidad de tu cuenta |
💡 Los campos personalizados varían de cuenta a cuenta — la lista que ves refleja los campos que creó tu operación (datos de Instagram, ciudad, categoría, lo que sea).
Acciones (Qué hace)
Las acciones se ejecutan en orden, una después de otra. Catálogo completo:
Asignación
- Definir responsable — define el responsable de la oportunidad;
- Transferir a sector — la mueve a un sector específico.
Contacto
- Añadir etiqueta — acepta varias etiquetas a la vez;
- Quitar etiqueta — igual, varias a la vez;
- Cambiar campo — cambia un campo del contacto (del sistema o personalizado), definiendo el nuevo valor;
- Añadir nota — registra una nota en el contacto;
- Añadir a la lista — incluye el contacto en una de tus listas de envío;
- Quitar de la lista — saca el contacto de una lista.
Oportunidad
- Crear oportunidad;
- Mover a etapa — mueve la oportunidad a la etapa elegida;
- Cambiar campo de la oportunidad — del sistema o personalizado;
- Marcar como ganada;
- Marcar como perdida;
- Añadir comentario — en la oportunidad;
- Iniciar playbook — inicia un playbook en la oportunidad, creando las tareas del proceso automáticamente.
Conversación
- Enviar mensaje — eliges el destino del mensaje y puedes enviar archivos;
- Nota privada — añade una nota interna a la conversación;
- Activar o pausar la IA — activa o pausa el agente de IA en esa conversación;
- Cerrar conversación.
Tareas y equipo
- Crear tarea — crea una tarea específica;
- Notificar — notifica sobre la tarea.
Ritmo
- Esperar — pausa la secuencia los minutos que definas, antes de ejecutar la siguiente acción.
Integraciones
- HTTP Request — llama a una API externa desde la automatización. Es la única acción con editor propio; está detallada en la sección de abajo.
La acción HTTP Request
Llama a una API externa en medio de la automatización — para avisar a un sistema, crear un registro del otro lado o buscar un dato y usarlo en las acciones siguientes.
Método y URL
Elige el método e informa la URL. La URL admite variables, por ejemplo /contacts/{{contato.email}}.
Cuerpo (JSON)
Hay dos modos, y elegir entre ellos es la decisión más importante de la acción.
Datos de GetRaze
GetRaze arma el cuerpo por ti. Son 124 campos en nueve bloques, y cuatro reglas explican el comportamiento:
📖 Campo a campo: esta sección resume. La referencia completa — cada campo con tipo y advertencias, más el JSON de ejemplo entero — está en Cuerpo del HTTP Request.
| Regla | Qué significa |
|---|---|
| Formato fijo | El cuerpo es el mismo para todo disparador. Lo que cambia es el bloque trigger y lo que viene vacío — quien recibe no necesita un tratamiento por evento |
| Sin mensajes | El historial de la conversación nunca sale. Van canal, estado, responsable, sector, conteos, fecha y dirección del último mensaje, su vista previa y el resumen de la IA |
| Ausente es nulo | Un bloque sin datos se vuelve null, nunca desaparece. Una lista vacía se vuelve []. Un disparador de contacto, sin oportunidad, envía "opportunity": null |
| Desmarcar quita | Un bloque desmarcado en la pantalla sale del JSON — la clave ni aparece. Es distinto de venir nulo, y sirve para aligerar el cuerpo cuando la API del otro lado no necesita todo |
Los nueve bloques, cada uno con su casilla:
| Bloque | Clave en el JSON | Qué lleva |
|---|---|---|
| Disparador | trigger | El tipo de evento y su alcance — embudo, etapa, etiqueta, canal, según el caso. Es el único bloque cuyo formato cambia |
| Contacto | contact | La persona: nombre, correo, teléfono, cargo, tipo, origen, responsable, sector, etiquetas, campos personalizados, canales y el enlace al contacto |
| Empresa | company | La empresa registrada: dominio, sitio web, rubro, tamaño, sede, fit de ICP y nivel |
| Oportunidad | opportunity | El negocio: título, valor, moneda, probabilidad, embudo, etapa, responsable, productos, etiquetas, campos personalizados y fechas de ganada/perdida |
| Otras oportunidades | other_opportunities | Los demás negocios del mismo contacto, en cualquier embudo, en versión reducida. Tope de 20 |
| Conversación (resumen) | conversation | Canal, estado, quién atiende, conteos, la vista previa del último mensaje y el resumen de la IA |
| Tareas | tasks | Conteo, no lista: cuántas abiertas, cuántas vencidas y cuál es la próxima |
| Playbooks | roadmaps | Las ejecuciones de playbook del negocio o del contacto, de la más nueva a la más antigua. Tope de 10 |
| Calendario | calendar | Solo la próxima reunión confirmada. Un compromiso pasado o cancelado no entra |
⚠️ La clave del bloque de Playbooks sigue siendo
roadmapsen el JSON. La pantalla cambió de nombre, pero el cuerpo mantuvo el nombre antiguo para no romper integraciones que ya existían.
Cinco claves van siempre, en cualquier modo, y no tienen casilla en la pantalla: event, sent_at, test, automation y account. test viene true cuando el envío partió del botón Probar request y no de una ejecución real — útil para que el otro lado ignore las pruebas.
Escribir el mío
Armas el JSON a mano, en el formato que espera la API del otro lado, y GetRaze sustituye las variables antes de enviar.
- Dónde valen las variables: en el cuerpo, en la URL, en los headers y en los parámetros de la URL — las mismas en los cuatro lugares;
- Cómo sustituye: siempre como texto. Un valor ausente o nulo se vuelve string vacío, nunca la palabra
null; - Si el JSON no es válido después de la sustitución, el cuerpo se envía como texto plano en lugar de objeto. Conviene revisar las comillas alrededor de cada variable.
Las variables disponibles (los nombres son fijos y quedan en portugués):
| Variable | De dónde viene |
|---|---|
{{contato.nome}} | Nombre completo del contacto |
{{contato.primeiro_nome}} | Primer nombre; si falta, la primera palabra del nombre |
{{contato.email}} | Correo del contacto |
{{contato.telefone}} | Teléfono, en formato internacional con + |
{{contato.empresa}} | El campo "empresa" del contacto, en texto |
{{contato.cargo}} | Cargo del contacto |
{{oportunidade.titulo}} | Título del negocio de la ejecución |
{{oportunidade.valor}} | Valor, sin símbolo ni separador de miles |
{{etapa.nome}} | Etapa del disparador |
{{pipeline.nome}} | Embudo del disparador |
{{usuario.nome}} | Quién lo disparó, cuando hubo alguien |
{{resposta.nome_do_campo}} | Un campo guardado de la respuesta de un HTTP Request anterior en la misma automatización |
⚠️ Son 11 variables, frente a los 124 campos del cuerpo listo. Quien necesite empresa, etiquetas, productos, campos personalizados o datos de la conversación no puede armar eso a mano — en esos casos, usa Datos de GetRaze y trata el cuerpo del otro lado.
Autenticación
Cuatro opciones: Ninguna, Bearer token, Basic (usuario y contraseña) y API Key en header.
Headers y Parámetros en la URL
Añade los que necesites. Los dos admiten las mismas variables del cuerpo.
Guardar de la respuesta
Informa la ruta en la respuesta y el nombre de la variable. Cada campo guardado queda disponible para las acciones siguientes de la automatización, como {{resposta.rd_uuid}}.
💡 Después de usar Probar request, la plataforma lista los campos de la respuesta — haz clic en uno para guardarlo, en lugar de escribir la ruta a mano.
Tiempo límite
Cuántos segundos esperar la respuesta antes de desistir.
Si falla
Qué hacer cuando la llamada no sale bien:
| Opción | Cuándo usarla |
|---|---|
| Reintentar hasta 5 veces | Solo cuando la API acepta la misma llamada dos veces sin duplicar nada |
| Seguir con la acción siguiente | Cuando la llamada es un aviso y la automatización debe continuar de todos modos |
| Detener la automatización | Cuando las acciones siguientes dependen del resultado de esta |
⚠️ Cuidado con Reintentar: además de exigir una API que acepte la repetición, las acciones que usan la respuesta quedan esperando a que terminen los intentos.
Secreto (opcional)
Firma el cuerpo con HMAC-SHA256 en la cabecera X-Getraze-Signature. Es lo que permite a quien recibe un cuerpo genérico confirmar que la solicitud vino realmente de tu cuenta.
Probar request
Llama a la API de verdad, en el momento, y muestra la respuesta — a diferencia del Ensayo, que simula todo pero no envía el request.
Próximos pasos
- Arma tu primera automatización con la guía Creando una automatización;
- Prueba todo en simulación con el Ensayo antes de activarla;
- Sigue cada ejecución en la pestaña Ejecuciones.