business.profile_updated

EVENTObusiness.profile_updateddesde M12envelope v1

Perfil comercial alterado.

Quando é emitido

O perfil comercial da conta Business foi alterado pela API (PATCH /business/profile, painel ou MCP). Traz os campos alterados e o perfil lido de novo do WhatsApp. Mudanças feitas no celular não geram este evento.

Campos de `data`

Campo	Tipo	Descrição
`fields`	`array`	Campos alterados: description, address, email, websites, location, categories, hours.
`cleared`	`array`	Campos removidos com clear (quando houver).
`profile`	`object`	O perfil depois da alteração (mesmo formato do GET /business/profile).
`source`	`string`	api.

O envelope (id, type, version, instance_id, timestamp,data) está em Visão geral. Campos novos podem ser adicionados emdata sem mudar a versão: ignore os que não conhecer.

Exemplos

{
  "id": "evt_4c8e2a6b1d3f5079",
  "type": "business.profile_updated",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-20T15:00:00.000Z",
  "data": {
    "fields": [
      "description"
    ],
    "profile": {
      "jid": "[email protected]",
      "description": "Pizzas artesanais",
      "websites": [],
      "categories": [],
      "category_list": [],
      "hours": []
    },
    "source": "api",
    "timestamp": "2026-10-20T15:00:00Z"
  }
}

Entrega e ordem

Por webhook: pelo menos uma vez, com retry por até 24 horas. O mesmo evento pode chegar duas vezes: deduplique porX-LiteZap-Event-Id. Veja Entrega e retentativas.
A ordem entre eventos não é garantida (retentativas reordenam): use timestamp.
Por SSE: ao vivo, sem replay. Veja Tempo real com SSE.
Para assinar só este tipo: "events": ["business.profile_updated"] no webhook, ou?types=business.profile_updated no SSE.

Equivalente na Z-API: (sem equivalente).