Webhooks Events

Message Updated

This event is triggered if the field of a message is updated (example: status, is_deleted).

Messages send via Partoo are created with the status Sending, and propagated to the messaging channel. If the message is sent successfully, the status is changed to Success. If the messaging channel fails to send the message, the status changed to Failed. A failed message can be retried using the /retry endpoint.

The event payload contains the event type, the content of the updated message and additional information about the conversation.

postWebhookmessageUpdated

Payload

type'message_updated'

Example payload

{
  "payload": {
    "message": {
      "date": "2023-01-31 16:22:17.327878+00:00",
      "sender_label": "Jane Doe"
    },
    "conversation": {
      "consumer_img": "https://www.example.com/profile-picture.jpg",
      "consumer_name": "John Doe",
      "consumer_phone_number": "+33612345678",
      "consumer_email": "john.doe@example.com",
      "last_message": {
        "date": "2023-01-31 16:22:17.327878+00:00",
        "sender_label": "Jane Doe"
      },
      "created_at": "2023-01-31 16:22:17.327878+00:00",
      "messaging_partner": "Facebook",
      "issues": [
        "facebook_no_page_linked"
      ],
      "last_message_date": "2023-01-31 16:22:17.327878+00:00",
      "assigned_user_id": "62d80fae74e8b11d700302b8"
    }
  }
}

Response

Return a 200 status to indicate that the event was properly received

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.