Site Comments

All webhooks related to site comments are listed below.

New Conversation

A notification is sent when a new conversation is created on a site. A publish can be triggered inside the Duda editor or via the publish API endpoint. Event type: NEW_CONVERSATION

{
  "data": {
    "comment": {
      "text": "Please change this font to match our logo",
      "uuid": "5bfa1f6b-0426-4893-9f20-363efd20abb6"
    },
    "conversation_context": {
      "page_uuid": "88848a7e884147729b9f7b5c62c88377",
      "device": "DESKTOP",
      "conversation_number": 2
    },
    "conversation_uuid": "94320b30-96b1-40ad-a8f6-75eea204e255"
  },
  "source": {
    "type": "EDITOR",
    "account_name": "[email protected]"
  },
  "resource_data": {
    "site_name": "8a8ed8f4d2a34032b5cdc10feb483527"
  },
  "event_timestamp": 1547849546045,
  "event_type": "NEW_CONVERSATION"
}

Name	Type	Description
data.comment.text	string	The text of the initial comment in the new conversation
data.comment.uuid	string	UUID of the comment
data.conversation_context.page_uuid	string	UUID of the page the comment was created on
data.conversation_context.device	string	The device view in use when the comment was entered. Possible values are `DESKTOP`, `TABLET`, or `MOBILE`
data.conversation_context.conversation_number	int	Tracks the total number of conversations across a site. A conversation_number of 3 means this conversation is the 3rd conversation added to the site (regardless of page)
data.conversation_uuid	string	UUID of the conversation
source.type	string	The location of the source for the event. Possible values are `EDITOR` or `API`
source.account_name	string	Account name of the user who authored the comment.

New Comment

A notification is sent when a new comment is added to an existing conversation. Event type: NEW_COMMENT

{
  "data": {
    "comment": {
      "text": "Font family has been updated. Please confirm.",
      "uuid": "eafb2b72-2845-4d49-baf4-36f38ecc32a1"
    },
    "conversation_uuid": "0abab363-5b95-4f4e-a5d2-c7e39f993094"
  },
  "source": {
    "type": "EDITOR",
    "account_name": "[email protected]"
  },
  "resource_data": {
    "site_name": "8a8b556ad2a34032b5cdc10feb483527"
  },
  "event_timestamp": 1547849618170,
  "event_type": "NEW_COMMENT"
}

Name	Type	Description
data.comment.text	string	The text of the new comment
data.comment.uuid	string	UUID of the comment
data.conversaton_uuid	string	UUID of the conversation
source.type	string	The location of the source of the event. Possible values are `Editor` or `API`
source.account_name	string	The account who authored the new comment

Conversation Update

A notification is sent when the status of a conversation has changed. A conversation can be resolved by a Team Member which will fire this webhook. Additionally a resolved conversation can be reopened which will fire a status of unresolved. Event type: CONVERSATION_UPDATED

{
  "data": {
    "conversation_properties": {
      "status": "resolved",
      "deleted": false
    },
    "conversation_uuid": "e0fa2c71-c8a4-4cb7-b3f4-2040609a439b"
  },
  "source": {
    "type": "EDITOR",
    "account_name": "[email protected]"
  },
  "resource_data": {
    "site_name": "8a8b556ad2a34032b5cdc10feb483527"
  },
  "event_timestamp": 1547849670851,
  "event_type": "CONVERSATION_UPDATED"
}

Name	Type	Description
data. conversation_properties.status	string	The current status of the conversation. Possible values are "resolved, unresolved"
data. conversation_properties.deleted	boolean	Boolean value depicting if conversation is deleted or not
data.conversation_uuid	string	UUID of the conversation
source.type	string	The location of the source for the event. Possible values are `EDITOR` or `API`
source.account_name	string	The account who initiated the status change

Comment Edited

A notification is sent when a comment is edited. The webhook includes the complete comment object as shown below. Event type: COMMENT_EDITED

{
  "data": {
    "comment": {
      "text": "Please update with this image https://irp-cdn.multiscreensite.com/md/dmip/dms3rep/multi/woman-nature-smiling-green.jpg",
      "uuid": "abcbebdd-c430-444e-8ebb-ydaf78482bfc"
    },
    "conversation_uuid": "c4w79464-ed20-427e-9cb8-e1b89bab272b"
  },
  "source": {
    "type": "EDITOR",
    "account_name": "[email protected]"
  },
  "resource_data": {
    "site_name": "je4ec1c6"
  },
  "event_timestamp": 1550081354524,
  "event_type": "COMMENT_EDITED"
}

Name	Type	Description
data.comment.text	string	The text of the comment
data.comment.uuid	string	UUID of the comment
data.conversation_uuid	string	UUID of the conversation
source.type	string	The location of the source for the event. Possible values are `EDITOR` or `API`
source.account_name	string	The account that initiated the edit

Comment Deleted

A notification is sent when a comment is deleted. Event type: COMMENT_DELETED

{
  "data": {
    "comment": {
      "uuid": "adcaddb0-8674-4f0f-be5e-c926d58e2053"
    },
    "conversation_uuid": "de6c0840-94d1-4e7c-a6ac-41360a42b98a"
  },
  "source": {
    "type": "EDITOR",
    "account_name": "[email protected]"
  },
  "resource_data": {
    "site_name": "je4ec1c6"
  },
  "event_timestamp": 1550081783440,
  "event_type": "COMMENT_DELETED"
}

Name	Type	Description
data.comment.uuid	string	UUID of the comment
data.conversaton_uuid	string	UUID of the conversation
source.type	string	The location of the source for the event. Possible values are `EDITOR` or `API`
source.account_name	string	The account that initiated the delete