[{"data":1,"prerenderedAt":380},["ShallowReactive",2],{"help-article-getting-started-webhook-setup":3,"help-siblings-getting-started":343},{"_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":337,"_id":338,"_source":339,"_file":340,"_stem":341,"_extension":342},"\u002Fhelp\u002Fgetting-started\u002Fwebhook-setup","getting-started",false,"","Configuring webhooks for incoming messages","How to set up the webhook URL in Meta's dashboard so AIsoule receives incoming WhatsApp messages.",8,"intermediate","5 minutes",[14,15,16],"\u002Fhelp\u002Fgetting-started\u002Fconnect-whatsapp","\u002Fhelp\u002Fsettings\u002Fmanaging-accounts","\u002Fhelp\u002Fintegrations\u002Fwebhooks-receiving",{"type":18,"children":19,"toc":325},"root",[20,28,34,41,46,52,57,64,133,139,240,246,268,274,292,298,308],{"type":21,"tag":22,"props":23,"children":25},"element","h1",{"id":24},"configuring-webhooks-for-incoming-messages",[26],{"type":27,"value":8},"text",{"type":21,"tag":29,"props":30,"children":31},"p",{},[32],{"type":27,"value":33},"Webhooks are how Meta delivers incoming messages to AIsoule. Without this, you won't receive customer messages.",{"type":21,"tag":35,"props":36,"children":38},"h2",{"id":37},"if-you-used-embedded-signup",[39],{"type":27,"value":40},"If you used Embedded Signup",{"type":21,"tag":29,"props":42,"children":43},{},[44],{"type":27,"value":45},"Good news — webhooks are configured automatically! You don't need to do anything manually. Skip this article.",{"type":21,"tag":35,"props":47,"children":49},{"id":48},"manual-webhook-setup",[50],{"type":27,"value":51},"Manual webhook setup",{"type":21,"tag":29,"props":53,"children":54},{},[55],{"type":27,"value":56},"If you connected your account manually:",{"type":21,"tag":58,"props":59,"children":61},"h3",{"id":60},"step-1-get-your-webhook-details-from-aisoule",[62],{"type":27,"value":63},"Step 1: Get your webhook details from AIsoule",{"type":21,"tag":65,"props":66,"children":67},"ol",{},[68,80,85,97],{"type":21,"tag":69,"props":70,"children":71},"li",{},[72,74],{"type":27,"value":73},"Go to ",{"type":21,"tag":75,"props":76,"children":77},"strong",{},[78],{"type":27,"value":79},"Settings → WhatsApp Accounts",{"type":21,"tag":69,"props":81,"children":82},{},[83],{"type":27,"value":84},"Click on your account",{"type":21,"tag":69,"props":86,"children":87},{},[88,90,95],{"type":27,"value":89},"Find the ",{"type":21,"tag":75,"props":91,"children":92},{},[93],{"type":27,"value":94},"Webhook Configuration",{"type":27,"value":96}," section",{"type":21,"tag":69,"props":98,"children":99},{},[100,102],{"type":27,"value":101},"Copy:\n",{"type":21,"tag":103,"props":104,"children":105},"ul",{},[106,123],{"type":21,"tag":69,"props":107,"children":108},{},[109,114,116],{"type":21,"tag":75,"props":110,"children":111},{},[112],{"type":27,"value":113},"Webhook URL",{"type":27,"value":115},": ",{"type":21,"tag":117,"props":118,"children":120},"code",{"className":119},[],[121],{"type":27,"value":122},"https:\u002F\u002Fapp.aisoule.com\u002Fapi\u002Fwebhook",{"type":21,"tag":69,"props":124,"children":125},{},[126,131],{"type":21,"tag":75,"props":127,"children":128},{},[129],{"type":27,"value":130},"Verify Token",{"type":27,"value":132},": (unique per account)",{"type":21,"tag":58,"props":134,"children":136},{"id":135},"step-2-configure-in-meta",[137],{"type":27,"value":138},"Step 2: Configure in Meta",{"type":21,"tag":65,"props":140,"children":141},{},[142,155,160,187,197],{"type":21,"tag":69,"props":143,"children":144},{},[145,146],{"type":27,"value":73},{"type":21,"tag":147,"props":148,"children":152},"a",{"href":149,"rel":150},"https:\u002F\u002Fdevelopers.facebook.com\u002Fapps",[151],"nofollow",[153],{"type":27,"value":154},"Meta App Dashboard",{"type":21,"tag":69,"props":156,"children":157},{},[158],{"type":27,"value":159},"Select your app → WhatsApp → Configuration",{"type":21,"tag":69,"props":161,"children":162},{},[163,165],{"type":27,"value":164},"Under \"Webhook\":\n",{"type":21,"tag":103,"props":166,"children":167},{},[168,178],{"type":21,"tag":69,"props":169,"children":170},{},[171,176],{"type":21,"tag":75,"props":172,"children":173},{},[174],{"type":27,"value":175},"Callback URL",{"type":27,"value":177},": Paste the webhook URL from AIsoule",{"type":21,"tag":69,"props":179,"children":180},{},[181,185],{"type":21,"tag":75,"props":182,"children":183},{},[184],{"type":27,"value":130},{"type":27,"value":186},": Paste the verify token from AIsoule",{"type":21,"tag":69,"props":188,"children":189},{},[190,192],{"type":27,"value":191},"Click ",{"type":21,"tag":75,"props":193,"children":194},{},[195],{"type":27,"value":196},"\"Verify and Save\"",{"type":21,"tag":69,"props":198,"children":199},{},[200,202],{"type":27,"value":201},"Subscribe to webhook fields:\n",{"type":21,"tag":103,"props":203,"children":204},{},[205,216,228],{"type":21,"tag":69,"props":206,"children":207},{},[208,210],{"type":27,"value":209},"✅ ",{"type":21,"tag":117,"props":211,"children":213},{"className":212},[],[214],{"type":27,"value":215},"messages",{"type":21,"tag":69,"props":217,"children":218},{},[219,220,226],{"type":27,"value":209},{"type":21,"tag":117,"props":221,"children":223},{"className":222},[],[224],{"type":27,"value":225},"message_deliveries",{"type":27,"value":227}," (for delivery receipts)",{"type":21,"tag":69,"props":229,"children":230},{},[231,232,238],{"type":27,"value":209},{"type":21,"tag":117,"props":233,"children":235},{"className":234},[],[236],{"type":27,"value":237},"message_reads",{"type":27,"value":239}," (for read receipts)",{"type":21,"tag":58,"props":241,"children":243},{"id":242},"step-3-subscribe-in-aisoule",[244],{"type":27,"value":245},"Step 3: Subscribe in AIsoule",{"type":21,"tag":65,"props":247,"children":248},{},[249,254,263],{"type":21,"tag":69,"props":250,"children":251},{},[252],{"type":27,"value":253},"Go back to your account in AIsoule",{"type":21,"tag":69,"props":255,"children":256},{},[257,258],{"type":27,"value":191},{"type":21,"tag":75,"props":259,"children":260},{},[261],{"type":27,"value":262},"\"Subscribe\"",{"type":21,"tag":69,"props":264,"children":265},{},[266],{"type":27,"value":267},"This registers your app to receive events",{"type":21,"tag":35,"props":269,"children":271},{"id":270},"verifying-it-works",[272],{"type":27,"value":273},"Verifying it works",{"type":21,"tag":65,"props":275,"children":276},{},[277,282,287],{"type":21,"tag":69,"props":278,"children":279},{},[280],{"type":27,"value":281},"Send a message from any WhatsApp number to your business number",{"type":21,"tag":69,"props":283,"children":284},{},[285],{"type":27,"value":286},"The message should appear in AIsoule's inbox within seconds",{"type":21,"tag":69,"props":288,"children":289},{},[290],{"type":27,"value":291},"If not, check the webhook configuration and try again",{"type":21,"tag":35,"props":293,"children":295},{"id":294},"troubleshooting",[296],{"type":27,"value":297},"Troubleshooting",{"type":21,"tag":29,"props":299,"children":300},{},[301,306],{"type":21,"tag":75,"props":302,"children":303},{},[304],{"type":27,"value":305},"\"Verification failed\"",{"type":27,"value":307}," — Make sure the Verify Token matches exactly (no extra spaces).",{"type":21,"tag":29,"props":309,"children":310},{},[311,316,318,323],{"type":21,"tag":75,"props":312,"children":313},{},[314],{"type":27,"value":315},"\"Messages not arriving\"",{"type":27,"value":317}," — Check that you subscribed to the ",{"type":21,"tag":117,"props":319,"children":321},{"className":320},[],[322],{"type":27,"value":215},{"type":27,"value":324}," field in Meta's dashboard AND clicked \"Subscribe\" in AIsoule.",{"title":7,"searchDepth":326,"depth":326,"links":327},2,[328,329,335,336],{"id":37,"depth":326,"text":40},{"id":48,"depth":326,"text":51,"children":330},[331,333,334],{"id":60,"depth":332,"text":63},3,{"id":135,"depth":332,"text":138},{"id":242,"depth":332,"text":245},{"id":270,"depth":326,"text":273},{"id":294,"depth":326,"text":297},"markdown","content:help:getting-started:webhook-setup.md","content","help\u002Fgetting-started\u002Fwebhook-setup.md","help\u002Fgetting-started\u002Fwebhook-setup","md",[344,347,350,352,355,358,361,364,367,370,373,376,377],{"_path":345,"title":346},"\u002Fhelp\u002Fgetting-started\u002Fbilling-plans","Billing, plans, and subscription management",{"_path":348,"title":349},"\u002Fhelp\u002Fgetting-started\u002Fbusiness-profile-setup","Setting up your business profile",{"_path":14,"title":351},"Connecting your WhatsApp Business number",{"_path":353,"title":354},"\u002Fhelp\u002Fgetting-started\u002Fcreate-account","How to create your AIsoule account",{"_path":356,"title":357},"\u002Fhelp\u002Fgetting-started\u002Fdashboard-overview","Understanding the AIsoule dashboard",{"_path":359,"title":360},"\u002Fhelp\u002Fgetting-started\u002Finvite-team","Inviting team members to your workspace",{"_path":362,"title":363},"\u002Fhelp\u002Fgetting-started\u002Fmobile-app-setup","Mobile app setup (iOS & Android)",{"_path":365,"title":366},"\u002Fhelp\u002Fgetting-started\u002Forganization-switching","Switching between organizations",{"_path":368,"title":369},"\u002Fhelp\u002Fgetting-started\u002Fprofile-settings","Profile settings (password, availability)",{"_path":371,"title":372},"\u002Fhelp\u002Fgetting-started\u002Fsecurity-overview","Security and data protection",{"_path":374,"title":375},"\u002Fhelp\u002Fgetting-started\u002Fsend-first-message","Send your first message in 5 minutes",{"_path":4,"title":8},{"_path":378,"title":379},"\u002Fhelp\u002Fgetting-started\u002Fwhatsapp-api-basics","Understanding WhatsApp Business API basics",1780423185997]