Skip to content
StartupBuilderby Startups.Studio
Business
Changelog
Events

Conversation.answered

Emitted each time a Conversation is answered.

Conversation.answer emits Conversation.answered when it completes on a Conversation.

PropertyValue
Emitted byConversation.answer
NounConversation
MovesConversation open to waiting
WakesNone.

Payload

Each delivery is an Event record. data holds what Conversation.answer returns.

FieldTypeRequiredDescription
namestringrequiredConversation.answered.
atdatetimerequiredWhen it happened.
seqintegerIts position in the namespace, one more than the Event before; any seq is a cursor into the history.
datajsonrequiredThe Thing as the Action left it.
data.conversationConversationrequiredThe answered Conversation.
data.conversation.subjectstringWhat the Thread is about.
data.conversation.answeredAtdatetimeWhen a Worker last answered.
data.conversation.firstAnsweredAtdatetimeWhen a Worker first answered; set once, never overwritten. answeredAt keeps the last answer.
data.conversation.respondBydatetimeWhen the first answer is due: Setting support.firstResponseWithin per Offer, default 4 business hours.
data.conversation.statusstringOpen, waiting on the Customer, or resolved; computed from its answers, closes and reopens.
data.conversation.resolvedAtdatetimeWhen it was resolved; empty again when the resolution reverses.
data.conversation.resolutionstringHow it was resolved: the Customer said so, or 72 hours passed after an answer with no reply.

Example

JSON
{
  "$id": "https://api.sb/shiftnote.app/events/event_1",
  "$type": "Event",
  "name": "Conversation.answered",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "conversation": {
      "$id": "https://api.sb/shiftnote.app/conversations/conversation_1",
      "$type": "Conversation",
      "subject": "Example subject",
      "answeredAt": "2026-10-22T12:00:00Z",
      "firstAnsweredAt": "2026-10-22T12:00:00Z",
      "respondBy": "2026-10-22T12:00:00Z",
      "status": "open",
      "resolvedAt": "2026-10-22T12:00:00Z",
      "resolution": "confirmed"
    }
  },
  "seq": 1
}