상태 및 가격 알림

WhatsApp Business API 클라이언트는 비즈니스와 사용자 사이의 메시지 status에 대한 알림을 전송합니다. 이러한 알림은 statuses 개체를 통해 전송됩니다.

상태 업데이트

가격 업데이트

예

다음 예시에서 recipient_id는 group_id 필드로 대신할 수 있습니다. 메시지를 전송하는 대상이 개인인지 그룹인지에 따라 달라집니다.

상태: 메시지 전송됨

비즈니스에서 사용자가 시작한 대화(해당 대화가 무료 진입점에서 시작되지 않은 경우)의 일부로 메시지를 전송하면 다음과 같은 Webhooks를 수신합니다.

{
   "statuses": [{
     "id": "ID",
     "recipient_id": "WHATSAPP_ID",
     "status": "sent",
     "timestamp": "TIMESTAMP",
     "type": "message",
     "message": {         
        "recipient_id":"WHATSAPP_ID"   
     },
     "conversation": {
       "id": "CONVERSATION_ID",
       "expiration_timestamp": TIMESTAMP,
       "origin": {
         "type": "user_initiated"
       }
      },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "user_initiated"
    }
   }]
}

비즈니스에서 미디어 메시지에 대해 사용자가 시작한 대화(해당 대화가 무료 진입점에서 시작되지 않은 경우)의 일부로 메시지를 전송하면 다음과 같은 Webhooks를 수신합니다.

{
   "statuses": [{
     "id": "ID",
     "recipient_id": "WHATSAPP_ID",
     "status": "sent",
     "timestamp": "TIMESTAMP",
     "type": "message",
     "message": {   
       "media_id": "98d14c8e-0310-4061-8f99-2d148274c286",
       "recipient_id":"WHATSAPP_ID"  
     },
     "conversation": {
       "id": "CONVERSATION_ID",
       "expiration_timestamp": TIMESTAMP,
       "origin": {
         "type": "user_initiated"
       }
      },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "user_initiated"
    }
   }]
}

비즈니스에서 비즈니스가 시작한 대화의 일부로 메시지를 전송하면 다음과 같은 Webhooks를 수신합니다.

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "sent",
    "timestamp": "TIMESTAMP",
    "type": "message",         
    "message": {
        "recipient_id":"WHATSAPP_ID" 
    },
    "conversation": {
      "id": "CONVERSATION_ID",
      "expiration_timestamp": TIMESTAMP,
      "origin": {
         "type": "business_initiated"
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "business_initiated"
    }
   }]
}

비즈니스가 무료 진입점에서 발생한 사용자가 시작한 대화에 대한 답장으로 메시지를 전송하면 다음과 같은 Webhooks를 수신합니다.

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "sent",
    "timestamp": "TIMESTAMP",
    "type": "message",
    "message": {
        "recipient_id":"WHATSAPP_ID"   
    },
    "conversation": {
      "id": "CONVERSATION_ID",
      "expiration_timestamp": TIMESTAMP,
      "origin": {
         "type": "referral_conversion",
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": false,
      "category": "referral_conversion"
    }
   }]
}

상태: 메시지 전달됨

비즈니스의 메시지가 전달되고 해당 메시지가 사용자가 시작한 대화(해당 대화가 무료 진입점에서 시작되지 않은 경우)의 일부인 경우 다음과 같은 Webhooks를 수신합니다.

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "delivered",
    "timestamp": "TIMESTAMP",
    "type": "message",
    "message": {
        "recipient_id":"WHATSAPP_ID" 
      },
    "conversation": {
      "id": "CONVERSATION_ID",
      "origin": {
         "type": "user_initiated"
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "user_initiated"
    }
  }]
}

비즈니스의 메시지가 전달되고 해당 메시지가 비즈니스가 시작한 대화의 일부인 경우 다음과 같은 Webhooks를 수신합니다.

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "delivered",
    "timestamp": "TIMESTAMP",
    "type": "message",
    "message": {
        "recipient_id": "WHATSAPP_ID" 
    },
    "conversation": {
      "id": "CONVERSATION_ID",
      "origin": {
         "type": "business_initiated"
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "business_initiated"
    }
  }]
}

비즈니스의 메시지가 전달되고 해당 메시지가 무료 진입점에서 발생한 사용자가 시작한 대화의 일부인 경우 다음과 같은 Webhooks를 수신합니다.

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "delivered",
    "timestamp": "TIMESTAMP",
    "type": "message",  
    "message": {
        "recipient_id": "WHATSAPP_ID" 
    },
    "conversation": {
      "id": "CONVERSATION_ID",
      "origin": {
         "type": "referral_conversion",
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": false,
      "category": "referral_conversion"
    }
  }]
}

상태: 메시지 읽음

읽은 메시지에 대한 표준 콜백:

{
  "statuses":[{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "read",
    "timestamp": "TIMESTAMP",
    "type": "message",  
    "message": {
        "recipient_id": "WHATSAPP_ID" 
    }
  }]
}

상태: 메시지 전송 실패

오류 코드 470

{
  "statuses": [{
    "errors": [{
      "code": 470,
      "title": "Failed to send message because you are outside the support window for freeform messages to this user. Please use a valid HSM notification or reconsider." 
    }],
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "failed",
    "timestamp": "TIMESTAMP"
  }]
}

오류 코드 480

{
  "statuses": [{
      "errors": [{
          "code": 480,
          "title": "Failed to send message since we detect an identity change of the contact"
      }],
      "id": "ID",
      "recipient_id": "WHATSAPP_ID",
      "status": "failed",
      "timestamp": "TIMESTAMP"
   }]
}

메시지가 실패했다면 콜백에 대화 하위 섹션이 포함되지 않은 것입니다. 이 경우에는 청구 또는 대화 활성화가 포함되지 않습니다.

상태: 메시지 삭제됨

삭제된 메시지에 대한 표준 콜백:

{
  "statuses": [{
        "id": "ID",
        "recipient_id": "WHATSAPP_ID",
        "status": "deleted",
        "timestamp": "TIMESTAMP",
        "type": "message",
        "message": {
           "recipient_id": "WHATSAPP_ID" 
      }
    }]
}

메시지가 삭제되었다면 콜백에 대화 하위 섹션이 포함되지 않은 것입니다. 이 경우에는 청구 또는 대화 활성화가 포함되지 않습니다.

모든 가능한 메시지 상태

자세한 내용은 개요, 메시지를 참조하세요.

FAQ