Skip to content

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 ​

EventoCuándo se disparaCampos
Oportunidad creadaLa oportunidad no existía y fue creadaEmbudo (específico o todos) · Etapa (específica o cualquiera)
Oportunidad entró en la etapaLa oportunidad ya existía y entró en la etapaEmbudo · A la etapa (en blanco = cualquiera) · Solo una vez por oportunidad
Oportunidad detenida en la etapa hace N díasLa oportunidad cumplió N días detenida en la etapaEmbudo · Etapa (en blanco = cualquiera) · Detenida hace (días) · Solo una vez por oportunidad
Oportunidad ganadaLa oportunidad fue marcada/arrastrada a GanadaEmbudo (específico o cualquiera) · Solo una vez por oportunidad
Oportunidad perdidaLa oportunidad fue marcada/arrastrada a PerdidaEmbudo (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 ​

EventoCuándo se disparaCampos
Contacto creadoSe creó un contacto nuevo—
Etiqueta añadida al contactoSe aplicó la etiqueta elegidaEtiqueta · Solo una vez por oportunidad
Etiqueta quitada del contactoSe quitó la etiqueta elegidaEtiqueta · Solo una vez por oportunidad

Grupo Conversación ​

EventoCuándo se disparaCampos
Nueva conversaciónSe creó una conversaciónCanal (en blanco = todos)
Conversación asignadaUna conversación fue asignada a alguienCanal · Sector
Conversación cerradaUna conversación fue cerradaCanal (opcional)
Conversación reabiertaUna conversación cerrada fue reabiertaCanal (opcional)
La IA pasó a un humanoEl agente de IA transfirió la conversación a un humanoCanal (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 ​

GrupoCampos
ContactoEtiqueta · Origen · Tipo · Sector · Correo · Empresa
OportunidadEmbudo · Etapa · Valor de la oportunidad (mayor, igual o menor que X) · Responsable · Título
ConversaciónCanal · Sector · Responsable · IA activa · Estado
DisparadorEtapa de origen — la etapa de donde vino la oportunidad
Campos personalizadosTodos 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.

ReglaQué significa
Formato fijoEl 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 mensajesEl 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 nuloUn 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 quitaUn 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:

BloqueClave en el JSONQué lleva
DisparadortriggerEl tipo de evento y su alcance — embudo, etapa, etiqueta, canal, según el caso. Es el único bloque cuyo formato cambia
ContactocontactLa persona: nombre, correo, teléfono, cargo, tipo, origen, responsable, sector, etiquetas, campos personalizados, canales y el enlace al contacto
EmpresacompanyLa empresa registrada: dominio, sitio web, rubro, tamaño, sede, fit de ICP y nivel
OportunidadopportunityEl negocio: título, valor, moneda, probabilidad, embudo, etapa, responsable, productos, etiquetas, campos personalizados y fechas de ganada/perdida
Otras oportunidadesother_opportunitiesLos demás negocios del mismo contacto, en cualquier embudo, en versión reducida. Tope de 20
Conversación (resumen)conversationCanal, estado, quién atiende, conteos, la vista previa del último mensaje y el resumen de la IA
TareastasksConteo, no lista: cuántas abiertas, cuántas vencidas y cuál es la próxima
PlaybooksroadmapsLas ejecuciones de playbook del negocio o del contacto, de la más nueva a la más antigua. Tope de 10
CalendariocalendarSolo la próxima reunión confirmada. Un compromiso pasado o cancelado no entra

⚠️ La clave del bloque de Playbooks sigue siendo roadmaps en 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):

VariableDe 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ónCuándo usarla
Reintentar hasta 5 vecesSolo cuando la API acepta la misma llamada dos veces sin duplicar nada
Seguir con la acción siguienteCuando la llamada es un aviso y la automatización debe continuar de todos modos
Detener la automatizaciónCuando 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 ​

GetRaze - AI-Powered Lead Generation