Saltar al contenido principal

Resumen

Una Organization agrupa contacts bajo una entidad única y jerárquica — una empresa con sus departamentos y personas. Las organizations son objetos de customer data de primera clase: sus attributes vienen de los Profiles adoptados, y llevan taxonomies, tags, relationships, workflows, ownership, jerarquía y archive. Para el panorama completo, consulta el overview de Customer Data.

Dónde encontrarlo

Las organizations están en Customer Data → Organizations.

Properties

PropertyTipoRequeridoDescripción
titlestringNombre visible.
slugstringIdentificador — único.
parent_idreferenceNoOrganization padre, para la jerarquía.
profilesarrayNoProfiles adoptados — definen los attributes de la organization.
taxonomiesarrayNoTaxonomies aplicadas a la organization.
tagsarrayNoTags aplicados a la organization.
Los campos personalizados de una organization vienen de los profiles que adopta; el ownership aplica como en cualquier objeto de customer data.

Contacts

Un contact pertenece a una organization a través de su organization_id. Una organization puede agrupar muchos contacts, y renombrar la organization actualiza el nombre de organization que se muestra en cada uno de sus contacts.

Jerarquía

Las organizations se anidan en un árbol padre/hijo — una empresa, sus divisiones, sus departamentos. Las consultas conscientes de la jerarquía resuelven una organization junto con todos sus descendientes. Consulta Hierarchies.

Comportamiento y reglas

  • No se puede eliminar una organization con contacts — primero reasigna o quita sus contacts.
  • Los attributes vienen de los profiles — una organization sin profile no tiene attributes personalizados; adopta un profile para darle un esquema.
  • Archiva, no elimines en duro — las organizations usan Archive y se pueden restaurar.

Seeds

Las organizations viajan entre entornos como Seeds estructurales. Una organization lleva su title, slug, valores de attributes, y referencias a taxonomies (resueltas con reference helpers):
[
  {
    "object_type": "organizations",
    "data": {
      "title": "Lehner PLC",
      "slug": "lehner-plc",
      "general": {
        "annual_revenue": 571815.45
      },
      "taxonomies_ids": [
        "{{getContentInstance('default-organizations', 'slug', 'automotive')}}",
        "{{getContentInstance('default-organizations', 'slug', 'electronics')}}"
      ]
    }
  }
]

Gobernanza y permisos

Un super admin o un Master puede gestionar cualquier organization. Las organizations llevan Ownership, así que un Journey Manager gestiona las organizations que posee.

Acceso por API

Las organizations tienen CRUD completo, más operaciones de restore y de quitar de la jerarquía, y bulk actions para attributes, taxonomies, tags, ownership, workflows y jerarquía. Consulta la API reference.

Relacionado

Contacts

Los contacts que agrupa una organization.

Profiles

El esquema de attributes que adopta una organization.

Hierarchies

Árboles de organizations padre/hijo.