Los Webhooks de Spark son una nueva función que le permite sincronizar de manera unidireccional la información de sus contactos con la plataforma externa compatible de su preferencia.
Esta guía explicará cómo agregar un webhook utilizando la plataforma GoHighLevel (GHL) como ejemplo.
📣 Nota: El webhook únicamente enviará contactos que tengan una póliza activa o pendiente.
Añadir un webhook
Nuestro webhook es compatible con cualquier plataforma que admita integración mediante webhooks.
Las activaciones de webhook suelen producirse en unos segundos, aunque en casos excepcionales puede haber un ligero retraso de unos minutos.
Configure su webhook navegando a Back Office y seleccionando Manage platform data.
Haga clic en Add Webhook URL y pegue el URL del endpoint de su webhook en el cuadro.
Haga clic en Test URL para enviar una carga útil de prueba y asegurarse de que la conexión funciona.
💡 Consejo: si desea enviar varias URL de prueba, simplemente elimine y vuelva a pegar la misma URL, y podrá hacer clic en el botón Test más de una vez.
Si usted es un LOA Agency Principal (AP), deberá invitar a todos sus agentes a la plataforma LOA para garantizar que el webhook funcione correctamente en toda su agencia. Para obtener más información, consulte Cartera de negocios de la agencia.
📣 Nota: Ya no enviamos información basada en el estado de la búsqueda de beneficiarios. Sin embargo, antes del AEP, enviaremos actualizaciones del estado de las solicitudes que nos lleguen a través de los datos de la aseguradora.
Puntos clave a tener en cuenta
Si su CRM no ofrece compatibilidad nativa con webhooks entrantes, no puede simplemente dirigir un webhook hacia él y esperar que funcione correctamente. En su lugar, necesitará una capa de integración que pueda recibir el webhook y luego transferir los datos a su CRM utilizando un método compatible.
Zapier no se puede utilizar para esta integración, ya que no cumple con la normativa HIPAA.
Carga útil
Carga útil
Aquí está la carga útil completa del webhook de Spark. A continuación, indicaremos los campos de selección múltiple. Actualmente admitimos 4 pólizas para cada una de las categorías Active (Activo), Pending (Pendiente), y Plan exit (Salida del plan).
{
"unique_id": "bd65600d-8669-4903-8a14-af88203add38",
"metadata": {"event_type": "CONTACT_CREATED"},
"timestamp": "2025-11-25 16:47:00 +00:00",
"details": {
"id": 1234,
"first_name": "Anthony",
"middle_name": "John",
"last_name": "Soprano",
"preferred_name": "Tony",
"full_name": "Anthony Soprano",
"full_preferred_name": "Tony Soprano",
"home_phone": "201-555-1234",
"mobile_phone": "201-555-5678",
"email": "[email protected]",
"home_address": "14 Aspen Drive, North Caldwell, NJ 07006",
"shipping_address": "241 Calcutta Street, Newark, NJ 07114",
"sex": "Male",
"gender": "Male",
"point_of_contact": {
"full_name": "Carmela Soprano",
"relationship": "Spouse",
"home_phone": "201-555-1234",
"mobile_phone": "201-555-2468",
"email": "[email protected]"
},
"agent": {
"first_name": "Dwight",
"last_name": "Harris",
"full_name": "Dwight Harris",
"office_phone": "201-555-5555",
"email": "[email protected]",
"npn": "123456789"
},
"soa_is_signed": true,
"soa_signed_at": "2007-06-10 3:00:00",
"veteran_status": "Not a veteran",
"primary_contact": "Beneficiary",
"preferred_language": "en",
"external_id": "M4D0N",
"needs_assessment_link": "https://example.com/needs-assessment"
},
"phi": {
"dob": "1959-08-22",
"mbi": "T0NY-S0PR4N0",
"has_medicaid": false,
"has_lis": true,
"lis_certification_date": "2000-01-01",
"drug_subsidy": "ZERO",
"has_ssi": false,
"part_a_enrollment_date": "2000-01-01",
"part_b_enrollment_date": "2000-01-01",
"policies": {
"active": {
"policy_1": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_2": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_3": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_4": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
}
},
"pending": {
"policy_1": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_2": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_3": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_4": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
}
},
"plan_exits": {
"policy_1": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_2": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_3": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_4": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
},
"plan_crosswalk": {
"policy_1": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_2": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_3": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_4": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
},
"pcp_out_of_network": {
"policy_1": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_2": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_3": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_4": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
},
"prescription_removed_from_formulary": {
"policy_1": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_2": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_3": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_4": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
},
"drug_tier_change": {
"policy_1": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_2": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_3": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_4": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
},
"major_cost_change": {
"policy_1": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_2": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_3": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
},
"policy_4": {
"name": "AARP Medicare Advantage from UHC NJ-0004 (PPO)",
"bid_id": "H8768-022",
"carrier": "UnitedHealthcare",
"effective_date": "1999-01-10",
"expiration_date": "2007-06-10",
"submitted_date": "1997-08-01",
"product_type": "MAPD",
"beq_status": "Accreted App"
}
}
}
}
Interrupciones en la carga útil
Interrupciones en la carga útil
Las siguientes interrupciones están presentes en la carga útil:
Nota: El relleno de los datos sobre interrupciones se realizó el viernes 17 de octubre, tras enviar un correo electrónico a todos los usuarios de Webhook el 13 de octubre.
"major_cost_change": {
"drug_tier_change": {
"prescription_removed_from_formulary": {
"pcp_out_of_network": {
"plan_crosswalk": {
"plan_exits": {
Tipos de productos
Tipos de productos
class ProductTypes(models.TextChoices):
MA_ONLY = "MA", "Medicare Advantage (MA)"
MAPD = "MAPD", "Medicare Advantage with a Drug Plan (MAPD)"
PDP_ONLY = "PDP", "Prescription Drug Plan (PDP)"
MEDSUPP_ONLY = "MedSup", "Medicare Supplemental (MedSupp)"
HI = "HI", "Hospital Indemnity (HI)"
FE = "FE", "Final Expense (FE)"
DVH = "DVH", "Dental, Vision, Hearing (DVH)"
CHAS = "CHAS", "Cancer, Heart Attack, Stroke (CHAS)"
HOME_HEALTH = "Home Health", "Home Health Services"
SHORT_TERM = "Short Term", "Short Term Care"
LIFE_INSURANCE = "Life Insurance", "Life Insurance"
OTHER = "Other", "Other"
Tipos de eventos
Tipos de eventos
CONTACT_CREATED
CONTACT_UPDATED
NEEDS_ASSESSMENT_COMPLETED
POLICY_CREATED
POLICY_UPDATED
SOA_CREATED
SOA_UPDATED
Estados de Veterano
Estados de Veterano
if contact.is_veteran:
veteran_status = "Veteran"
elif contact.is_spouse_of_veteran:
veteran_status = "Spouse of veteran"
Valores de Contacto Principal
Valores de Contacto Principal
class PrimaryContacts(models.TextChoices):
BENEFICIARY = "BENEFICIARY"
AGENT = "AGENT"
POC = "POC", "Point of contact"
SPOUSE = "SPOUSE"
Ejemplo: GoHighLevel (GHL)
El ejemplo siguiente muestra cómo agregar un webhook en GoHighLevel; sin embargo, los pasos son generalmente similares en otros sistemas.
Primero, navegue a su cuenta en GHL.
En el lado izquierdo, haga clic en Automation.
Luego, haga clic en +Create Workflow y seleccione Start from Scratch.
Se le mostrará la página de New Workflow.
Si lo desea, puede nombrar su workflow utilizando el ícono de lápiz en la parte superior. A continuación, haga clic en +Add new Trigger.
Añadiremos un activador de webhook entrante. Selecciónelo de la lista.
Tome nota del campo URL. Copie la URL y diríjase a la plataforma Spark.
En la plataforma Spark, haga clic en Back Office y seleccione Platform data.
Su pantalla debería incluir una sección de Webhook. Haga clic en Add webhook URL.
Aparecerá una ventana emergente solicitando la URL que hemos copiado de GHL. Pégala en el cuadro.
Lea el aviso legal y marque la casilla para poder enviar la URL de su webhook.
Una vez enviado, la URL de su webhook aparecerá en la página principal.
Podemos enviar un payload de prueba a GHL para mapear los datos entre los sistemas. Haga clic en Test URL.
Si la configuración es correcta, se le avisará de que la prueba se ha realizado correctamente. Aparecerá una insignia de Verified (Verificado) junto al subtítulo Webhook.
De vuelta en GHL, haga clic en el botón “Fetch Sample Requests” en la parte inferior.
Seleccione la carga útil de prueba que hemos enviado.
Debería ver la carga útil de referencia con información de muestra. Esta será nuestra referencia de mapeo.
Si todo parece estar en orden, haga clic en “Save Trigger” en la esquina inferior derecha.
A continuación, se le dirigirá a la página de creación de Action. Crearemos una acción de Create Update Contact (Crear actualización de contacto).
Haga clic en el botón Add field y comience a asignar los campos de su plataforma GHL con los campos proporcionados por la carga útil de muestra. Puede seleccionar los campos del carga útil haciendo clic en el botón que se encuentra a la izquierda del ícono de Trash.
Una vez que haya terminado de asignar todos los campos, haga clic en Save Action.
¡Y ya está!
Haga clic en Save en la esquina superior derecha y active el interruptor Draft a Publish para activar su workflow. Ahora, cada vez que un contacto o sus pólizas se actualicen en Spark, también se actualizarán en su plataforma externa.
Creating New Fields in GHL
La carga útil del webhook de Spark incluye muchos campos que no están configurados de forma predeterminada en plataformas como GHL. Para crear nuevos campos en GHL, haga clic en Contacts (Contactos) en la parte izquierda de la página de la plataforma y, a continuación, en el icono de engranaje situado en la parte superior central. Haga clic en Add field (Añadir campo).