# Webhook delivery completion event

Use of optional functions requires an application

Only corporate users who have submitted the required applications can use the functions described in this document. To use it with your LINE Official Account, contact your sales representative or contact our Sales partners (opens new window).

# Overview of webhook delivery completion events

When a request is made to the LINE notification messages API and delivery of the LINE notification message to the user is completed, a dedicated webhook event (delivery completion event) is sent from the LINE Platform to the webhook URL of the bot server.

# Webhook delivery completion event specifications

Property name Type Description
type String delivery
mode Object See Common properties.
source Object See Common properties.
timestamp Number See Common properties.
webhookEventId String See Common properties.
deliveryContext Object See Common properties.
delivery Object A delivery object containing a hashed phone number string or a string specified by X-Line-Delivery-Tag.
delivery.data String A hashed phone number string or a string specified by X-Line-Delivery-Tag.

Example webhook event

About the status of webhook delivery completion events

The webhook delivery completion event indicates that the LINE notification message has been delivered to the user and the message can now be viewed. It doesn't indicate the following:

Signature verification of webhook events

Use the channel secret for Verifying signatures upon receipt of the delivery completion event. For channels using LINE Chat Plus, use Switcher Secret to verify signatures.

# Additional information on Webhook delivery completion events

Even if a LINE notification messages API request is sent and a response is made with the HTTP status code 200, depending on the user's LINE notification message reception settings and SMS authentication status, LINE notification messages may not be delivered to the user or the sending of LINE notification messages may be suspended.

If a LINE notification messages API request is sent and a Webhook delivery completion event isn't received within 24 hours after the response is made with the HTTP status code 200, it means that the LINE notification message wasn't delivered to the user for one of these reasons.

# The user has blocked the LINE Official Account

Even if the user has blocked the LINE Official Account that sent the LINE notification message, requests for the LINE notification messages API will be responded with HTTP status code 200.

# The user didn't give required consent or authentication

It's possible that the settings for receiving LINE notification messages haven't been set, or that SMS authentication is required, but these settings or operations haven't been performed. For more information, see When the LINE notification messages API request is successful but the message isn't sent.