[{"data":1,"prerenderedAt":330},["ShallowReactive",2],{"help-article-integrations-webhook-events":3,"help-siblings-integrations":297},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"category":5,"order":10,"difficulty":11,"time_to_complete":12,"related":13,"body":17,"_type":291,"_id":292,"_source":293,"_file":294,"_stem":295,"_extension":296},"\u002Fhelp\u002Fintegrations\u002Fwebhook-events","integrations",false,"","Webhook event types reference","Complete reference of all webhook event types, their payloads, and when they fire.",10,"intermediate","5 minutes",[14,15,16],"\u002Fhelp\u002Fintegrations\u002Fwebhooks-receiving","\u002Fhelp\u002Fintegrations\u002Fapi-overview","\u002Fhelp\u002Fsettings\u002Fwebhook-configuration",{"type":18,"children":19,"toc":269},"root",[20,28,34,41,48,53,66,72,77,86,92,97,103,108,114,119,128,134,140,149,155,160,166,172,181,187,193,198,207,213],{"type":21,"tag":22,"props":23,"children":25},"element","h1",{"id":24},"webhook-event-types-reference",[26],{"type":27,"value":8},"text",{"type":21,"tag":29,"props":30,"children":31},"p",{},[32],{"type":27,"value":33},"Complete list of events you can subscribe to and their payload formats.",{"type":21,"tag":35,"props":36,"children":38},"h2",{"id":37},"message-events",[39],{"type":27,"value":40},"Message events",{"type":21,"tag":42,"props":43,"children":45},"h3",{"id":44},"messageincoming",[46],{"type":27,"value":47},"message.incoming",{"type":21,"tag":29,"props":49,"children":50},{},[51],{"type":27,"value":52},"Fired when a customer sends you a message.",{"type":21,"tag":54,"props":55,"children":60},"pre",{"className":56,"code":58,"language":59,"meta":7},[57],"language-json","{\n  \"event\": \"message.incoming\",\n  \"timestamp\": \"2026-05-29T10:30:00Z\",\n  \"data\": {\n    \"message_id\": \"wamid.HBgLOTE5ODc2...\",\n    \"from\": \"+919876543210\",\n    \"contact_id\": \"uuid\",\n    \"contact_name\": \"John Doe\",\n    \"type\": \"text\",\n    \"text\": \"Hello, I need help\",\n    \"whatsapp_account_id\": \"uuid\"\n  }\n}\n","json",[61],{"type":21,"tag":62,"props":63,"children":64},"code",{"__ignoreMap":7},[65],{"type":27,"value":58},{"type":21,"tag":42,"props":67,"children":69},{"id":68},"messagesent",[70],{"type":27,"value":71},"message.sent",{"type":21,"tag":29,"props":73,"children":74},{},[75],{"type":27,"value":76},"Fired when your message is sent to WhatsApp.",{"type":21,"tag":54,"props":78,"children":81},{"className":79,"code":80,"language":59,"meta":7},[57],"{\n  \"event\": \"message.sent\",\n  \"timestamp\": \"2026-05-29T10:30:05Z\",\n  \"data\": {\n    \"message_id\": \"wamid.HBgLOTE5ODc2...\",\n    \"to\": \"+919876543210\",\n    \"type\": \"text\",\n    \"status\": \"sent\"\n  }\n}\n",[82],{"type":21,"tag":62,"props":83,"children":84},{"__ignoreMap":7},[85],{"type":27,"value":80},{"type":21,"tag":42,"props":87,"children":89},{"id":88},"messagedelivered",[90],{"type":27,"value":91},"message.delivered",{"type":21,"tag":29,"props":93,"children":94},{},[95],{"type":27,"value":96},"Fired when message reaches the recipient's phone.",{"type":21,"tag":42,"props":98,"children":100},{"id":99},"messageread",[101],{"type":27,"value":102},"message.read",{"type":21,"tag":29,"props":104,"children":105},{},[106],{"type":27,"value":107},"Fired when recipient opens and reads the message.",{"type":21,"tag":42,"props":109,"children":111},{"id":110},"messagefailed",[112],{"type":27,"value":113},"message.failed",{"type":21,"tag":29,"props":115,"children":116},{},[117],{"type":27,"value":118},"Fired when message delivery fails.",{"type":21,"tag":54,"props":120,"children":123},{"className":121,"code":122,"language":59,"meta":7},[57],"{\n  \"event\": \"message.failed\",\n  \"data\": {\n    \"message_id\": \"wamid.xxx\",\n    \"to\": \"+919876543210\",\n    \"error_code\": 131047,\n    \"error_message\": \"Re-engagement message\"\n  }\n}\n",[124],{"type":21,"tag":62,"props":125,"children":126},{"__ignoreMap":7},[127],{"type":27,"value":122},{"type":21,"tag":35,"props":129,"children":131},{"id":130},"contact-events",[132],{"type":27,"value":133},"Contact events",{"type":21,"tag":42,"props":135,"children":137},{"id":136},"contactcreated",[138],{"type":27,"value":139},"contact.created",{"type":21,"tag":54,"props":141,"children":144},{"className":142,"code":143,"language":59,"meta":7},[57],"{\n  \"event\": \"contact.created\",\n  \"data\": {\n    \"id\": \"uuid\",\n    \"phone_number\": \"+919876543210\",\n    \"name\": \"John Doe\",\n    \"source\": \"whatsapp_webhook\"\n  }\n}\n",[145],{"type":21,"tag":62,"props":146,"children":147},{"__ignoreMap":7},[148],{"type":27,"value":143},{"type":21,"tag":42,"props":150,"children":152},{"id":151},"contactupdated",[153],{"type":27,"value":154},"contact.updated",{"type":21,"tag":29,"props":156,"children":157},{},[158],{"type":27,"value":159},"Fired when contact data changes (name, tags, stage, custom fields).",{"type":21,"tag":35,"props":161,"children":163},{"id":162},"campaign-events",[164],{"type":27,"value":165},"Campaign events",{"type":21,"tag":42,"props":167,"children":169},{"id":168},"campaigncompleted",[170],{"type":27,"value":171},"campaign.completed",{"type":21,"tag":54,"props":173,"children":176},{"className":174,"code":175,"language":59,"meta":7},[57],"{\n  \"event\": \"campaign.completed\",\n  \"data\": {\n    \"id\": \"uuid\",\n    \"name\": \"May Promotion\",\n    \"total\": 1000,\n    \"sent\": 985,\n    \"delivered\": 970,\n    \"read\": 650,\n    \"failed\": 15\n  }\n}\n",[177],{"type":21,"tag":62,"props":178,"children":179},{"__ignoreMap":7},[180],{"type":27,"value":175},{"type":21,"tag":35,"props":182,"children":184},{"id":183},"transfer-events",[185],{"type":27,"value":186},"Transfer events",{"type":21,"tag":42,"props":188,"children":190},{"id":189},"transfercreated",[191],{"type":27,"value":192},"transfer.created",{"type":21,"tag":29,"props":194,"children":195},{},[196],{"type":27,"value":197},"Fired when a conversation is transferred to an agent.",{"type":21,"tag":54,"props":199,"children":202},{"className":200,"code":201,"language":59,"meta":7},[57],"{\n  \"event\": \"transfer.created\",\n  \"data\": {\n    \"contact_id\": \"uuid\",\n    \"from_agent_id\": null,\n    \"to_agent_id\": \"uuid\",\n    \"to_team_id\": \"uuid\",\n    \"notes\": \"Customer asking about refund\"\n  }\n}\n",[203],{"type":21,"tag":62,"props":204,"children":205},{"__ignoreMap":7},[206],{"type":27,"value":201},{"type":21,"tag":35,"props":208,"children":210},{"id":209},"tips-for-handling-events",[211],{"type":27,"value":212},"Tips for handling events",{"type":21,"tag":214,"props":215,"children":216},"ol",{},[217,229,239,249,259],{"type":21,"tag":218,"props":219,"children":220},"li",{},[221,227],{"type":21,"tag":222,"props":223,"children":224},"strong",{},[225],{"type":27,"value":226},"Respond with 200 immediately",{"type":27,"value":228}," — Process async",{"type":21,"tag":218,"props":230,"children":231},{},[232,237],{"type":21,"tag":222,"props":233,"children":234},{},[235],{"type":27,"value":236},"Use message_id for dedup",{"type":27,"value":238}," — Same event may arrive twice",{"type":21,"tag":218,"props":240,"children":241},{},[242,247],{"type":21,"tag":222,"props":243,"children":244},{},[245],{"type":27,"value":246},"Filter by event type",{"type":27,"value":248}," — Only subscribe to what you need",{"type":21,"tag":218,"props":250,"children":251},{},[252,257],{"type":21,"tag":222,"props":253,"children":254},{},[255],{"type":27,"value":256},"Log raw payloads",{"type":27,"value":258}," — Helpful for debugging",{"type":21,"tag":218,"props":260,"children":261},{},[262,267],{"type":21,"tag":222,"props":263,"children":264},{},[265],{"type":27,"value":266},"Handle unknown events gracefully",{"type":27,"value":268}," — New events may be added",{"title":7,"searchDepth":270,"depth":270,"links":271},2,[272,280,284,287,290],{"id":37,"depth":270,"text":40,"children":273},[274,276,277,278,279],{"id":44,"depth":275,"text":47},3,{"id":68,"depth":275,"text":71},{"id":88,"depth":275,"text":91},{"id":99,"depth":275,"text":102},{"id":110,"depth":275,"text":113},{"id":130,"depth":270,"text":133,"children":281},[282,283],{"id":136,"depth":275,"text":139},{"id":151,"depth":275,"text":154},{"id":162,"depth":270,"text":165,"children":285},[286],{"id":168,"depth":275,"text":171},{"id":183,"depth":270,"text":186,"children":288},[289],{"id":189,"depth":275,"text":192},{"id":209,"depth":270,"text":212},"markdown","content:help:integrations:webhook-events.md","content","help\u002Fintegrations\u002Fwebhook-events.md","help\u002Fintegrations\u002Fwebhook-events","md",[298,300,303,306,309,312,315,318,321,322,324,327],{"_path":15,"title":299},"REST API overview and authentication",{"_path":301,"title":302},"\u002Fhelp\u002Fintegrations\u002Fapi-rate-limits","API rate limits and best practices",{"_path":304,"title":305},"\u002Fhelp\u002Fintegrations\u002Fcustom-js-actions","Using the JavaScript VM for custom actions",{"_path":307,"title":308},"\u002Fhelp\u002Fintegrations\u002Ferror-codes","Error codes reference",{"_path":310,"title":311},"\u002Fhelp\u002Fintegrations\u002Fpayment-gateway","Payment gateway setup (Razorpay\u002FStripe)",{"_path":313,"title":314},"\u002Fhelp\u002Fintegrations\u002Fproduct-catalog-sync","Product catalog sync from Meta",{"_path":316,"title":317},"\u002Fhelp\u002Fintegrations\u002Fsending-messages-api","Sending messages via API",{"_path":319,"title":320},"\u002Fhelp\u002Fintegrations\u002Fsending-messages-api-templates","Sending messages via API (advanced)",{"_path":4,"title":8},{"_path":14,"title":323},"Receiving messages via webhooks",{"_path":325,"title":326},"\u002Fhelp\u002Fintegrations\u002Fwoocommerce","WooCommerce integration setup",{"_path":328,"title":329},"\u002Fhelp\u002Fintegrations\u002Fzapier-pabbly","Connecting with Zapier and Pabbly Connect",1780423187270]