Skip to content

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 ​

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. 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 nuloUn 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 cortaUn 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:

ClaveQué es
eventSiempre automation.run
sent_atCuándo salió la requisición, en ISO 8601
testtrue cuando el envío partió del botón Probar request, y no de una ronda de verdad
automationid y name de la automatización
accountid y name de la cuenta

💡 El test es lo que permite al otro lado ignorar tus pruebas sin crear registros duplicados. Vale tratarlo ya en la primera integración.


El cuerpo completo ​

json
{
  "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.

CampoTipoObservación
typestringstage_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_iduuidDisparadores de oportunidad. Viene con pipeline_name
payload.stage_iduuidDisparadores de etapa. Viene con stage_name
payload.from_stage_iduuid · nullEtapa de origen. null cuando la tarjeta nació en la etapa en vez de ser movida — es lo que separa "creada" de "movida"
payload.tag_iduuidSolo en tag_added y tag_removed
payload.channel_account_iduuidDisparadores de conversación
payload.sector_iduuidSolo en conversation_assigned
payload.sourcestringSolo en contact_created. El origen del contacto
payload.daysnumberSolo en opportunity_stalled. Viene con stalled_since
payload.labelstring · nullLa etiqueta legible de la ronda, como aparece en Ejecuciones
payload.depthnumberProfundidad 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.

CampoTipoObservación
iduuid
namestringNombre completo, como fue registrado
first_namestring · nullSolo cuando vino separado en el origen. No se deriva de name
last_namestring · null
emailstring · null
phonestring · nullSiempre E.164 con +
companystring · nullEl texto escrito en el contacto. Para la empresa registrada, usa el bloque company
titlestring · nullCargo
typestring · nulllead o client
sourcestring · nulllinkedin, import, instagram_captura, whatsapp_qr…
timezonestring · nullIANA, ej. America/Sao_Paulo
ownerobjeto · nullResponsable: id, name, email
sectorobjeto · nullid, name
tagsarrayCada ítem: id, name, color. En orden alfabético
custom_fieldsobjetoLa clave es el identificador del campo, no la etiqueta de la pantalla. {} cuando no hay ninguno
channelsarrayCada ítem: provider, identifier. Solo los canales activos
last_interaction_attimestamp · null
created_attimestamp
urlstringEnlace 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.

CampoTipoObservación
iduuid
namestring
domainstring · null
websitestring · null
industrystring · array · nullCuando vino del enriquecimiento, es un array de nombres en inglés. Cuando fue escrito, es texto
sizestring · nullRango, ej. 501-1000
headquartersstring · nullVacío en la mayor parte de la base
locationsobjeto · nullEstructura libre venida del enriquecimiento
icp_fitnumber · null0 a 100. null significa "no evalué", no "no encaja"
tiernumber · nullCapa de ABM
revenue_rangestring · nullVací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.

CampoTipoObservación
iduuid
titlestring
valuenumber · null
currencystringBRL cuando no fue definida
probabilitynumber0 a 100
statusstringopen, won o lost. Es derivado de won_at y lost_at; no existe columna de estado en la base
pipelineobjeto · nullid, name
stageobjeto · nullid, name, is_win, is_loss
ownerobjeto · nullid, name, email
expected_close_datedate · null
productsarrayCada ítem: id, name, quantity, price. El precio es el unitario
tagsarrayEtiquetas de la oportunidad, distintas de las del contacto
custom_fieldsobjeto
won_at / lost_attimestamp · null
loss_reasonstring · nullEl nombre del motivo, no el id
created_attimestamp
urlstringAbre 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.

CampoTipoObservación
iduuid
titlestring
pipelinestring · nullAquí es el nombre, no un objeto
stagestring · nullÍdem
valuenumber · null
currencystring
statusstringopen, 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.

CampoTipoObservación
iduuid
channelobjeto · nullid, provider, name, identifier. El proveedor es el tipo de canal: whatsapp, instagram, linkedin, email…
statusstringai_active, manual o closed
ai_activeboolean
manual_control_takenbooleantrue cuando un humano asumió. Es el freno que impide que la IA vuelva sola
assigned_userobjeto · nullQuién atiende
sectorobjeto · null
messages_countnumber · null
unread_countnumber
last_message_attimestamp · null
last_message_directionstring · nullinbound u outbound
last_message_previewstring · nullSolo el último, truncado. Es lo más cerca de contenido que el cuerpo lleva
summarystring · nullResumen escrito por la IA, cuando existe
campaignobjeto · nullLa campaña que originó la conversación
opened_attimestamp
urlstringAbre la conversación en el inbox

Tareas — tasks ​

Conteo, no lista. Solo las abiertas, de la oportunidad o, sin ella, del contacto.

CampoTipoObservación
opennumberTope de 50 en el conteo
overduenumberDe las abiertas, cuántas ya vencieron
nextobjeto · nullLa 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, no playbooks. La pantalla fue renombrada; el cuerpo de la requisición mantuvo el nombre antiguo para no romper a quien ya integró.

CampoTipoObservación
iduuidId de la ejecución, no del modelo
namestringNombre del playbook en el momento en que corrió
statusstringin_progress, completed o cancelled
progressstringTexto en el formato "3/8", no número
started_attimestamp

Calendario — calendar ​

Solo la próxima reunión confirmada del contacto o de la conversación. Un compromiso pasado o cancelado no entra.

CampoTipoObservación
next_eventobjeto · nullnull cuando no hay ninguna agendada
next_event.iduuid
next_event.titlestring
next_event.starts_at / ends_attimestamp
next_event.meet_urlstring · nullEnlace 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.

VariableDe dónde vieneEjemplo
{{contato.nome}}Nombre completo del contactoAna Ejemplo
{{contato.primeiro_nome}}Primer nombre; a falta de él, la primera palabra del nombreAna
{{contato.email}}Correo del contactoana@ejemplo.com
{{contato.telefone}}Teléfono, E.164 con ++5511900000000
{{contato.empresa}}Campo "empresa" del contacto, en textoEjemplo Salud
{{contato.cargo}}Cargo del contactoDirectora de Operaciones
{{oportunidade.titulo}}Título del negocio de la rondaImplantación Atención IA
{{oportunidade.valor}}Valor, sin símbolo ni separador de miles74500
{{etapa.nome}}Etapa del disparadorCalificado
{{pipeline.nome}}Embudo del disparadorVentas
{{usuario.nome}}Quién disparó, cuando hubo alguienBeto 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 ​

json
{
  "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 ​

GetRaze - AI-Powered Lead Generation