Snoozing a conversation

Snooze a conversation

$ curl 'https://api.intercom.io/conversations/11055118659/reply' \
-X POST \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json' \
-H 'Content-Type:application/json' -d'
{
  "admin_id": "724860",
  "message_type":"snoozed",
  "snoozed_until":"1501512795"
}'
{
    "type": "conversation",
    "id": "11055118659",
    "created_at": 1501496012,
    "updated_at": 1501508752,
    "waiting_since": 1501498931,
    "snoozed_until": null,
    "conversation_message": {
        "type": "conversation_message",
        "id": "55951247",
        "subject": "",
        "body": "<p>Hi \ud83d\ude00 We hope you enjoy the example app. To get started just copy and paste some code into the JS editor. Let us know if you think this is useful? <br></p>",
        "author": {
            "type": "admin",
            "id": "724865"
        },
        "attachments": [],
        "url": null
    },
    "user": {
        "type": "lead",
        "id": "597f02cb22f4bb37597e0b7d"
    },
    "customers": [
        {
            "type": "lead",
            "id": "597f02cb22f4bb37597e0b7d"
        },
        {
            "type": "user",
            "id": "58ff3f670f14ab4f1aa83750"
        }
    ],
    "assignee": {
        "type": "admin",
        "id": "724860"
    },
    "conversation_parts": {
        "type": "conversation_part.list",
        "conversation_parts": [
            {
                "type": "conversation_part",
                "id": "712337945",
                "part_type": "comment",
                "body": "<p>test convo 1</p>",
                "created_at": 1501496025,
                "updated_at": 1501496025,
                "notified_at": 1501496025,
                "assigned_to": null,
                "author": {
                    "type": "user",
                    "id": "597f02cb22f4bb37597e0b7d"
                },
                "attachments": [],
                "external_id": null
            },
            {
                "type": "conversation_part",
                "id": "712338024",
                "part_type": "comment",
                "body": "<p>TestApp typically replies in a few hours. Don\u2019t miss their reply.</p>",
                "created_at": 1501496028,
                "updated_at": 1501496028,
                "notified_at": 1501496028,
                "assigned_to": null,
                "author": {
                    "type": "bot",
                    "id": "815309"
                },
                "attachments": [],
                "external_id": null
            },
            {
                "type": "conversation_part",
                "id": "712338089",
                "part_type": "comment",
                "body": "<p></p><p>Get notified by email</p>",
                "created_at": 1501496030,
                "updated_at": 1501496030,
                "notified_at": 1501496031,
                "assigned_to": null,
                "author": {
                    "type": "bot",
                    "id": "815309"
                },
                "attachments": [],
                "external_id": null
            },
            {
                "type": "conversation_part",
                "id": "712344562",
                "part_type": "comment",
                "body": "<p>group test two</p>",
                "created_at": 1501496290,
                "updated_at": 1501496290,
                "notified_at": 1501496291,
                "assigned_to": {
                    "type": "admin",
                    "id": "724860"
                },
                "author": {
                    "type": "admin",
                    "id": "724860"
                },
                "attachments": [],
                "external_id": null
            },
            {
                "type": "conversation_part",
                "id": "712383990",
                "part_type": "participant_added",
                "body": null,
                "created_at": 1501497831,
                "updated_at": 1501497831,
                "notified_at": 1501497832,
                "assigned_to": null,
                "author": {
                    "type": "admin",
                    "id": "724860"
                },
                "attachments": [],
                "external_id": null
            },
            {
                "type": "conversation_part",
                "id": "712411349",
                "part_type": "participant_added",
                "body": null,
                "created_at": 1501498885,
                "updated_at": 1501498885,
                "notified_at": 1501498885,
                "assigned_to": null,
                "author": {
                    "type": "admin",
                    "id": "724860"
                },
                "attachments": [],
                "external_id": null
            },
            {
                "type": "conversation_part",
                "id": "712412506",
                "part_type": "comment",
                "body": "<p>group test</p>",
                "created_at": 1501498931,
                "updated_at": 1501498931,
                "notified_at": 1501498932,
                "assigned_to": null,
                "author": {
                    "type": "user",
                    "id": "597f02cb22f4bb37597e0b7d"
                },
                "attachments": [],
                "external_id": null
            },
            {
                "type": "conversation_part",
                "id": "712425169",
                "part_type": "participant_removed",
                "body": null,
                "created_at": 1501499414,
                "updated_at": 1501499414,
                "notified_at": 1501499414,
                "assigned_to": null,
                "author": {
                    "type": "admin",
                    "id": "724860"
                },
                "attachments": [],
                "external_id": null
            },
            {
                "type": "conversation_part",
                "id": "712728293",
                "part_type": "snoozed",
                "body": null,
                "created_at": 1501508752,
                "updated_at": 1501508752,
                "notified_at": 1501508752,
                "assigned_to": null,
                "author": {
                    "type": "admin",
                    "id": "724860"
                },
                "attachments": [],
                "external_id": null
            }
        ],
        "total_count": 9
    },
    "open": true,
    "state": "snoozed",
    "read": false,
    "tags": {
        "type": "tag.list",
        "tags": []
    }
}

Customers can snooze a conversation via a POST method to https://api.intercom.io/conversations/{convo_id}/reply/, which accepts a JSON object identifying the time you want the conversation snoozed until.

Arguments

ArgumentRequiredDescription
admin_idYesOnly admins can snooze a conversation so you need to provide the admin_id
message_typeYesMust be snoozed
snoozed_untilYesThe time in Unix time (i.e. seconds) you want the conversation to reopen