Cuerpo del HTTP Request: referencia completa
Esta página detalla lo que la acción HTTP Request envía cuando el modo del cuerpo es Datos de GetRaze. Son 124 campos en nueve bloques, campo a campo, con el tipo de cada uno y las advertencias que evitan sorpresas del otro lado.
Para el paso a paso de la acción — autenticación, headers, tiempo límite, qué hacer si falla — mira la sección HTTP Request de la referencia.
Las cuatro reglas
| 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. Del bloque conversation 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 dato se vuelve null, nunca desaparece. Una lista vacía se vuelve []. Un disparador de contacto, sin oportunidad, envía "opportunity": null |
| Desmarcar corta | Un bloque desmarcado en la pantalla sale del JSON — la clave ni aparece. Es distinto de venir nula, y sirve para aliviar el cuerpo cuando la API del otro lado no necesita todo |
Las cinco claves fijas
No tienen casilla en la pantalla y van siempre, en cualquier modo:
| Clave | Qué es |
|---|---|
event | Siempre automation.run |
sent_at | Cuándo salió la requisición, en ISO 8601 |
test | true cuando el envío partió del botón Probar request, y no de una ronda de verdad |
automation | id y name de la automatización |
account | id y name de la cuenta |
💡 El
testes lo que permite al otro lado ignorar tus pruebas sin crear registros duplicados. Vale tratarlo ya en la primera integración.
El cuerpo completo
{
"event": "automation.run",
"sent_at": "2026-10-13T20:42:39.650Z",
"test": false,
"automation": { "id": "a3f1c8d2-…", "name": "Bienvenida al lead calificado" },
"account": { "id": "298ea01f-…", "name": "Empresa Ejemplo" },
"trigger": {
"type": "stage_entered",
"payload": {
"pipeline_id": "05807b60-…",
"pipeline_name": "Ventas",
"stage_id": "fcb99a5a-…",
"stage_name": "Calificado",
"from_stage_id": null,
"label": "Ventas › Calificado",
"depth": 0
}
},
"contact": {
"id": "be295e44-…",
"name": "Ana Ejemplo",
"first_name": "Ana",
"last_name": "Ejemplo",
"email": "ana@ejemplo.com",
"phone": "+5511900000000",
"company": "Ejemplo Salud",
"title": "Directora de Operaciones",
"type": "lead",
"source": "linkedin",
"timezone": "America/Sao_Paulo",
"owner": { "id": "2d19889d-…", "name": "Beto Ejemplo", "email": "beto@empresaejemplo.com" },
"sector": { "id": "2c41d458-…", "name": "Comercial" },
"tags": [
{ "id": "14ad536a-…", "name": "Cliente", "color": "#b05efe" },
{ "id": "20e97cec-…", "name": "Caliente", "color": "#dc2626" }
],
"custom_fields": { "cnpj": "00.000.000/0001-00", "segmento": "Retail" },
"channels": [
{ "provider": "whatsapp", "identifier": "+5511900000000" },
{ "provider": "linkedin", "identifier": "ana-ejemplo" }
],
"last_interaction_at": "2026-10-13 18:42:05",
"created_at": "2026-08-07 22:33:41",
"url": "https://app.getraze.co/contacts/be295e44-…"
},
"company": {
"id": "79c675f5-…",
"name": "Ejemplo Salud",
"domain": "ejemplosalud.com",
"website": "https://ejemplosalud.com",
"industry": "Operadora de plan de salud",
"size": "501-1000",
"headquarters": "Campinas, São Paulo, Brasil",
"locations": null,
"icp_fit": 82,
"tier": 3,
"revenue_range": null
},
"opportunity": {
"id": "6e7e688e-…",
"title": "Implantación Atención IA",
"value": 74500,
"currency": "BRL",
"probability": 40,
"status": "open",
"pipeline": { "id": "05807b60-…", "name": "Ventas" },
"stage": { "id": "fcb99a5a-…", "name": "Calificado", "is_win": false, "is_loss": false },
"owner": { "id": "2d19889d-…", "name": "Beto Ejemplo", "email": "beto@empresaejemplo.com" },
"expected_close_date": "2026-10-28T03:00:00.000Z",
"products": [
{ "id": "7bedaac8-…", "name": "Licencia mensual", "quantity": 1, "price": 26500 },
{ "id": "8af067bf-…", "name": "Implantación", "quantity": 1, "price": 48000 }
],
"tags": [ { "id": "14ad536a-…", "name": "Cliente", "color": "#b05efe" } ],
"custom_fields": { "origen_campana": "Google Ads" },
"won_at": null,
"lost_at": null,
"loss_reason": null,
"created_at": "2026-08-07 22:33:44",
"url": "https://app.getraze.co/pipelines/05807b60-…?opp=6e7e688e-…"
},
"other_opportunities": [
{
"id": "ce246c25-…",
"title": "Ejemplo Salud — Consultoría",
"pipeline": "Servicios",
"stage": "Identificación",
"value": 4500,
"currency": "BRL",
"status": "open"
}
],
"conversation": {
"id": "45e96d72-…",
"channel": { "id": "1b9c3c00-…", "provider": "whatsapp", "name": "WhatsApp Comercial", "identifier": "+5511900000001" },
"status": "manual",
"ai_active": false,
"manual_control_taken": true,
"assigned_user": { "id": "2d19889d-…", "name": "Beto Ejemplo", "email": "beto@empresaejemplo.com" },
"sector": { "id": "2c41d458-…", "name": "Comercial" },
"messages_count": 14,
"unread_count": 0,
"last_message_at": "2026-10-13 20:22:05",
"last_message_direction": "inbound",
"last_message_preview": "¿Me puedes enviar la propuesta?",
"summary": "Interesada en el plan; pidió propuesta con descuento anual.",
"campaign": null,
"opened_at": "2026-10-08 14:10:41",
"url": "https://app.getraze.co/inbox/45e96d72-…"
},
"tasks": {
"open": 2,
"overdue": 1,
"next": { "id": "80f0a145-…", "title": "Enviar propuesta", "due_at": "2026-10-14 20:00:00", "assignee": "Beto Ejemplo" }
},
"roadmaps": [
{
"id": "8039b4ce-…",
"name": "Onboarding comercial",
"status": "in_progress",
"progress": "3/8",
"started_at": "2026-10-10 11:20:05"
}
],
"calendar": {
"next_event": {
"id": "2411a6b4-…",
"title": "Demo Ejemplo Salud",
"starts_at": "2026-10-16 17:00:00",
"ends_at": "2026-10-16 18:00:00",
"meet_url": "https://meet.google.com/abc-defg-hij"
}
}
}Disparador — trigger
El único bloque cuyo formato cambia. type es siempre el nombre interno del disparador; payload lleva el recorte de aquel evento.
| Campo | Tipo | Observación |
|---|---|---|
type | string | stage_entered, opportunity_created, opportunity_won, opportunity_lost, opportunity_stalled, contact_created, tag_added, tag_removed, conversation_created, conversation_assigned, conversation_closed, conversation_reopened, ai_handoff |
payload.pipeline_id | uuid | Disparadores de oportunidad. Viene con pipeline_name |
payload.stage_id | uuid | Disparadores de etapa. Viene con stage_name |
payload.from_stage_id | uuid · null | Etapa de origen. null cuando la tarjeta nació en la etapa en vez de ser movida — es lo que separa "creada" de "movida" |
payload.tag_id | uuid | Solo en tag_added y tag_removed |
payload.channel_account_id | uuid | Disparadores de conversación |
payload.sector_id | uuid | Solo en conversation_assigned |
payload.source | string | Solo en contact_created. El origen del contacto |
payload.days | number | Solo en opportunity_stalled. Viene con stalled_since |
payload.label | string · null | La etiqueta legible de la ronda, como aparece en Ejecuciones |
payload.depth | number | Profundidad de encadenamiento. 0 cuando el evento vino de una persona o del sistema |
Contacto — contact
La persona. null cuando la ronda no tiene contacto — raro, porque casi todo disparador parte de uno.
| Campo | Tipo | Observación |
|---|---|---|
id | uuid | |
name | string | Nombre completo, como fue registrado |
first_name | string · null | Solo cuando vino separado en el origen. No se deriva de name |
last_name | string · null | |
email | string · null | |
phone | string · null | Siempre E.164 con + |
company | string · null | El texto escrito en el contacto. Para la empresa registrada, usa el bloque company |
title | string · null | Cargo |
type | string · null | lead o client |
source | string · null | linkedin, import, instagram_captura, whatsapp_qr… |
timezone | string · null | IANA, ej. America/Sao_Paulo |
owner | objeto · null | Responsable: id, name, email |
sector | objeto · null | id, name |
tags | array | Cada ítem: id, name, color. En orden alfabético |
custom_fields | objeto | La clave es el identificador del campo, no la etiqueta de la pantalla. {} cuando no hay ninguno |
channels | array | Cada ítem: provider, identifier. Solo los canales activos |
last_interaction_at | timestamp · null | |
created_at | timestamp | |
url | string | Enlace directo al contacto en GetRaze |
Empresa — company
La empresa registrada, venida del vínculo de la oportunidad y, a falta de él, del contacto. null cuando el contacto no está ligado a ninguna.
| Campo | Tipo | Observación |
|---|---|---|
id | uuid | |
name | string | |
domain | string · null | |
website | string · null | |
industry | string · array · null | Cuando vino del enriquecimiento, es un array de nombres en inglés. Cuando fue escrito, es texto |
size | string · null | Rango, ej. 501-1000 |
headquarters | string · null | Vacío en la mayor parte de la base |
locations | objeto · null | Estructura libre venida del enriquecimiento |
icp_fit | number · null | 0 a 100. null significa "no evalué", no "no encaja" |
tier | number · null | Capa de ABM |
revenue_range | string · null | Vacío en la mayor parte de la base |
Oportunidad — opportunity
El negocio de la ronda. null en disparadores que no tienen uno — contacto creado, etiqueta, conversación.
| Campo | Tipo | Observación |
|---|---|---|
id | uuid | |
title | string | |
value | number · null | |
currency | string | BRL cuando no fue definida |
probability | number | 0 a 100 |
status | string | open, won o lost. Es derivado de won_at y lost_at; no existe columna de estado en la base |
pipeline | objeto · null | id, name |
stage | objeto · null | id, name, is_win, is_loss |
owner | objeto · null | id, name, email |
expected_close_date | date · null | |
products | array | Cada ítem: id, name, quantity, price. El precio es el unitario |
tags | array | Etiquetas de la oportunidad, distintas de las del contacto |
custom_fields | objeto | |
won_at / lost_at | timestamp · null | |
loss_reason | string · null | El nombre del motivo, no el id |
created_at | timestamp | |
url | string | Abre la tarjeta en el embudo |
Otras oportunidades — other_opportunities
Los demás negocios del mismo contacto, en cualquier embudo, del más nuevo al más antiguo. Tope de 20. Versión reducida a propósito: para el negocio completo existe el bloque de arriba.
| Campo | Tipo | Observación |
|---|---|---|
id | uuid | |
title | string | |
pipeline | string · null | Aquí es el nombre, no un objeto |
stage | string · null | Ídem |
value | number · null | |
currency | string | |
status | string | open, won o lost |
Conversación (resumen) — conversation
La conversación de la ronda o, a falta de ella, la última abierta del contacto. null cuando no hay ninguna abierta — GetRaze nunca inventa una.
| Campo | Tipo | Observación |
|---|---|---|
id | uuid | |
channel | objeto · null | id, provider, name, identifier. El proveedor es el tipo de canal: whatsapp, instagram, linkedin, email… |
status | string | ai_active, manual o closed |
ai_active | boolean | |
manual_control_taken | boolean | true cuando un humano asumió. Es el freno que impide que la IA vuelva sola |
assigned_user | objeto · null | Quién atiende |
sector | objeto · null | |
messages_count | number · null | |
unread_count | number | |
last_message_at | timestamp · null | |
last_message_direction | string · null | inbound u outbound |
last_message_preview | string · null | Solo el último, truncado. Es lo más cerca de contenido que el cuerpo lleva |
summary | string · null | Resumen escrito por la IA, cuando existe |
campaign | objeto · null | La campaña que originó la conversación |
opened_at | timestamp | |
url | string | Abre la conversación en el inbox |
Tareas — tasks
Conteo, no lista. Solo las abiertas, de la oportunidad o, sin ella, del contacto.
| Campo | Tipo | Observación |
|---|---|---|
open | number | Tope de 50 en el conteo |
overdue | number | De las abiertas, cuántas ya vencieron |
next | objeto · null | La de plazo más próximo: id, title, due_at, assignee (el nombre, no el id) |
Playbooks — roadmaps
Las ejecuciones de playbook del negocio o del contacto, de la más nueva a la más antigua. Tope de 10.
⚠️ La clave del JSON es
roadmaps, noplaybooks. La pantalla fue renombrada; el cuerpo de la requisición mantuvo el nombre antiguo para no romper a quien ya integró.
| Campo | Tipo | Observación |
|---|---|---|
id | uuid | Id de la ejecución, no del modelo |
name | string | Nombre del playbook en el momento en que corrió |
status | string | in_progress, completed o cancelled |
progress | string | Texto en el formato "3/8", no número |
started_at | timestamp |
Calendario — calendar
Solo la próxima reunión confirmada del contacto o de la conversación. Un compromiso pasado o cancelado no entra.
| Campo | Tipo | Observación |
|---|---|---|
next_event | objeto · null | null cuando no hay ninguna agendada |
next_event.id | uuid | |
next_event.title | string | |
next_event.starts_at / ends_at | timestamp | |
next_event.meet_url | string · null | Enlace de Meet; a falta de él, el enlace del evento en Google Calendar |
Escribir el mío
En el modo Escribir el mío, armas el JSON a mano en el formato que la API del otro lado espera. GetRaze sustituye las variables y envía el resultado.
- Dónde vale: en el cuerpo, en la URL, en los headers y en los parámetros de la URL. Las mismas variables en los cuatro;
- Cómo sustituye: siempre por texto. Un valor ausente o nulo se vuelve string vacía, nunca la palabra
null; - Si el JSON no es válido después de la sustitución, el cuerpo se envía como texto puro en vez de objeto. Vale revisar las comillas alrededor de cada variable.
⚠️ Son 11 variables, contra los 124 campos del cuerpo listo. Quien necesita empresa, etiquetas, productos, campos personalizados o datos de la conversación no consigue armar eso a mano — para esos casos, el camino es usar Datos de GetRaze y tratar el cuerpo del otro lado.
| Variable | De dónde viene | Ejemplo |
|---|---|---|
{{contato.nome}} | Nombre completo del contacto | Ana Ejemplo |
{{contato.primeiro_nome}} | Primer nombre; a falta de él, la primera palabra del nombre | Ana |
{{contato.email}} | Correo del contacto | ana@ejemplo.com |
{{contato.telefone}} | Teléfono, E.164 con + | +5511900000000 |
{{contato.empresa}} | Campo "empresa" del contacto, en texto | Ejemplo Salud |
{{contato.cargo}} | Cargo del contacto | Directora de Operaciones |
{{oportunidade.titulo}} | Título del negocio de la ronda | Implantación Atención IA |
{{oportunidade.valor}} | Valor, sin símbolo ni separador de miles | 74500 |
{{etapa.nome}} | Etapa del disparador | Calificado |
{{pipeline.nome}} | Embudo del disparador | Ventas |
{{usuario.nome}} | Quién disparó, cuando hubo alguien | Beto Ejemplo |
{{resposta.nome_do_campo}} | Campo guardado de la respuesta de un HTTP Request anterior en la misma automatización | {{resposta.rd_uuid}} |
💡 Los nombres de las variables están en portugués en todos los idiomas — son identificadores que la plataforma resuelve, no texto de pantalla.
Ejemplo de cuerpo propio
{
"nombre": "{{contato.nome}}",
"correo": "{{contato.email}}",
"telefono": "{{contato.telefone}}",
"empresa": "{{contato.empresa}}",
"negocio": {
"titulo": "{{oportunidade.titulo}}",
"valor": "{{oportunidade.valor}}",
"embudo": "{{pipeline.nome}}",
"etapa": "{{etapa.nome}}"
},
"origen": "getraze"
}"valor" sale como texto, porque la sustitución es textual. Para número, el otro lado convierte — o usa Datos de GetRaze, donde opportunity.value ya es numérico.
Próximos pasos
- Vuelve a la acción HTTP Request para los demás campos — autenticación, headers, tiempo límite y qué hacer si falla;
- Arma la automatización que va a disparar la llamada en Creando una automatización.