Interaction events (`interaction.*`)

Records from the customer contact timeline (calls, emails, notes). data is the full interaction with the summarized person, user (who logged it) and charge.

interactionType values: call · email · whatsapp · meeting · note. direction: inbound · outbound. outcome: promise_to_pay · negotiation · dispute · no_contact · callback_requested · payment_confirmed.

`interaction.created`

Fires when an interaction is logged on the timeline.

{
  "event": "interaction.created",
  "timestamp": "2026-07-23T12:00:00.000Z",
  "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
  "data": {
    "id": "0b2d4f6a-8c1e-4a3c-9e5f-7a9b1d3f5c7e",
    "public_id": "e1f2a3b4-c5d6-4e7f-8091-021324354657",
    "organization_id": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
    "workspace_id": "5e8d1c4b-7a2f-4c9e-b3d6-0a1f2e3d4c5b",
    "company_id": null,
    "business_unit_id": null,
    "person_id": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
    "charge_id": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
    "user_id": "3e5a7c9b-2d4f-4a6c-8e0b-7f9d1b3e5a7c",
    "interaction_type": "call",
    "direction": "outbound",
    "summary": "Cliente prometeu pagar até sexta-feira.",
    "outcome": "promise_to_pay",
    "promise_date": "2026-07-25T00:00:00.000Z",
    "promised_amount": 1500.00,
    "contacted_at": "2026-07-23T11:40:00.000Z",
    "duration_seconds": 320,
    "metadata": null,
    "custom_metadata": null,
    "external_id": null,
    "custom_data": null,
    "tags": [],
    "deleted_at": null,
    "created_at": "2026-07-23T12:00:00.000Z",
    "updated_at": "2026-07-23T12:00:00.000Z",
    "person": {
      "id": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
      "name": "Padaria Pão Quente Ltda",
      "document_number": "12345678000190"
    },
    "user": {
      "id": "3e5a7c9b-2d4f-4a6c-8e0b-7f9d1b3e5a7c",
      "name": "Ana Souza",
      "email": "ana@empresa.com.br",
      "avatar_url": null
    },
    "charge": {
      "id": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
      "document_number": "NF-2026-0451",
      "original_amount": 1500.00,
      "due_date": "2026-07-31T00:00:00.000Z",
      "status": "overdue"
    }
  }
}

user is null in interactions logged automatically (e.g. a note created by a failed-payment webhook).

interaction.created​

`interaction.created`