Skip to main content

​
Quando ocorre

Este evento é disparado quando qualquer campo de um contato é atualizado — seja pelo painel, por outro membro da equipe ou por uma integração via API. Isso inclui alterações de nome, e-mail, telefone, responsável, empresa, tags e campos personalizados.

​
Casos de uso comuns

  • Manter o cadastro do contato sincronizado entre sistemas
  • Detectar quando um responsável muda para reatribuir na sua ferramenta
  • Reagir à adição de tags específicas (ex: tag qualificado adicionada → criar negócio no seu sistema)
  • Atualizar segmentos de e-mail marketing quando o perfil muda

​
Payload completo

{
  "id": "evt_01jx9la4n5o6p7q8r9s0t1u2v",
  "event": "contact.updated",
  "organization_id": "664a1b2c3d4e5f6789012345",
  "created_at": "2026-06-10T16:30:00.000Z",
  "data": {
    "id": "664f1a2b3c4d5e6f78901234",
    "name": "João Silva",
    "email": "joao.silva@empresa.com.br",
    "phone": "+5511999999999",
    "whatsapp_jid": "5511999999999@s.whatsapp.net",
    "instagram_username": null,
    "source": "whatsapp",
    "assigned_to": {
      "id": "664a1b2c3d4e5f6789012345",
      "name": "Maria Santos"
    },
    "company": {
      "id": "664b1c2d3e4f5a6789012346",
      "name": "Empresa ABC"
    },
    "tags": ["cliente", "qualificado"],
    "custom_fields": {
      "origem_lead": "Site"
    },
    "notes_count": 1,
    "deals_count": 2,
    "created_at": "2026-06-10T15:00:00.000Z",
    "updated_at": "2026-06-10T16:30:00.000Z"
  }
}

​
Referência de campos

O payload de contact.updated contém o estado completo e atual do contato após a atualização — não apenas os campos que mudaram.
CampoTipoDescrição
data.idstringID do contato
data.assigned_toobject|nullResponsável atual após a atualização
data.tagsstring[]Lista completa de tags atual
data.custom_fieldsobjectTodos os campos personalizados com valores atuais
data.updated_atstringTimestamp da última atualização
O evento não indica quais campos específicos mudaram — contém o objeto completo. Compare com o estado que você armazenou anteriormente para identificar as diferenças.

​
Exemplo de handler

if (event === 'contact.updated') {
  const stored = await db.contacts.findOne({ externalId: data.id });
  
  // Detectar mudança de responsável
  if (stored?.assignedTo !== data.assigned_to?.id) {
    await notifyTeam(`Contato ${data.name} reatribuído para ${data.assigned_to?.name}`);
  }

  // Detectar adição de tag específica
  const wasQualified = stored?.tags?.includes('qualificado');
  const isNowQualified = data.tags.includes('qualificado');
  if (!wasQualified && isNowQualified) {
    await createDealInCRM(data);
  }

  // Atualizar estado local
  await db.contacts.upsert({ externalId: data.id, ...data });
}