<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Harpreet Seehra</title>
    <description>The latest articles on DEV Community by Harpreet Seehra (@harpreet_seehra_c9a8eb4ed).</description>
    <link>https://dev.to/harpreet_seehra_c9a8eb4ed</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4253547%2F65b15e55-b28d-4f40-a4be-dbeae300ccda.png</url>
      <title>DEV Community: Harpreet Seehra</title>
      <link>https://dev.to/harpreet_seehra_c9a8eb4ed</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/harpreet_seehra_c9a8eb4ed"/>
    <language>en</language>
    <item>
      <title>Build an AI Grocery Delivery Assistant on WhatsApp with Telnyx</title>
      <dc:creator>Harpreet Seehra</dc:creator>
      <pubDate>Thu, 19 Nov 2026 10:09:35 +0000</pubDate>
      <link>https://dev.to/harpreet_seehra_c9a8eb4ed/build-an-ai-grocery-delivery-assistant-on-whatsapp-with-telnyx-5d6c</link>
      <guid>https://dev.to/harpreet_seehra_c9a8eb4ed/build-an-ai-grocery-delivery-assistant-on-whatsapp-with-telnyx-5d6c</guid>
      <description>&lt;p&gt;Grocery delivery apps have a retention problem. Users download the app, order once, forget their password, and go back to the shop. The interface that every phone already has — a messaging app — never gets used for commerce because wiring up a conversational AI agent to a messaging channel is traditionally a stack of three or four vendors: a messaging gateway, an LLM provider, a transcription service, and a phone validation API.&lt;/p&gt;

&lt;p&gt;This walkthrough builds FreshCart, a WhatsApp-based grocery delivery assistant powered by an AI agent named Mia. A customer messages a WhatsApp number, browses products, builds a cart, places an order, tracks delivery, handles substitutions, and reorders previous deliveries — all inside a single chat thread. Voice notes work too: say "add bananas, eggs, and sourdough" and Mia transcribes, parses, and adds each item to the cart.&lt;/p&gt;

&lt;p&gt;The whole system runs on four Telnyx products through a single unified API — no third-party LLM, no external transcription service, no separate phone validation vendor.&lt;/p&gt;

&lt;p&gt;The canonical code example lives in the Telnyx code examples repo:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://github.com/team-telnyx/telnyx-code-examples/tree/main/whatsapp-grocery-delivery-nodejs" rel="noopener noreferrer"&gt;https://github.com/team-telnyx/telnyx-code-examples/tree/main/whatsapp-grocery-delivery-nodejs&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What This Example Builds
&lt;/h2&gt;

&lt;p&gt;A Node.js Express server with a WhatsApp webhook handler, an agentic AI tool-calling loop, and a 3-panel real-time dashboard:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Component&lt;/th&gt;
&lt;th&gt;Purpose&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;WhatsApp webhook&lt;/td&gt;
&lt;td&gt;Receives inbound messages (text, interactive replies, voice notes)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AI agent (Mia)&lt;/td&gt;
&lt;td&gt;12-tool agentic loop — browse, cart, order, track, substitute, reorder&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Dashboard&lt;/td&gt;
&lt;td&gt;Product catalog, WhatsApp conversation mirror, delivery pipeline&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;SSE stream&lt;/td&gt;
&lt;td&gt;Real-time event push to the browser dashboard&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Why This Matters
&lt;/h2&gt;

&lt;p&gt;WhatsApp has 2 billion monthly active users. For many markets — grocery, pharmacy, food delivery — WhatsApp is where customers already are. Building a full commerce experience inside WhatsApp means no app download, no account creation, no forgotten passwords.&lt;/p&gt;

&lt;p&gt;The technical pattern here — an agentic tool-calling loop over a messaging channel — is the foundation for any conversational commerce application:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Grocery and food delivery&lt;/strong&gt; — Browse, order, track, substitute, reorder&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pharmacy&lt;/strong&gt; — Prescription refills, drug interaction checks, delivery scheduling&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Restaurant ordering&lt;/strong&gt; — Menu browsing, customization, delivery tracking&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Retail&lt;/strong&gt; — Product search, size/color selection, order tracking, returns&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Service booking&lt;/strong&gt; — Appointment scheduling, rescheduling, cancellations&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The system prompt and tool definitions are the only things that change.&lt;/p&gt;

&lt;h2&gt;
  
  
  Products Used
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;telnyx_products&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;WhatsApp&lt;/span&gt; &lt;span class="s"&gt;Business&lt;/span&gt; &lt;span class="s"&gt;API&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s"&gt;AI&lt;/span&gt; &lt;span class="s"&gt;Inference&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s"&gt;Number&lt;/span&gt; &lt;span class="s"&gt;Lookup&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s"&gt;Audio&lt;/span&gt; &lt;span class="s"&gt;Transcription&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;WhatsApp Business API&lt;/strong&gt; — Sends and receives messages via &lt;code&gt;POST /v2/messages/whatsapp&lt;/code&gt;. Supports text, interactive list messages (for product browsing), and quick-reply buttons (for substitution decisions and delivery confirmations).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;AI Inference&lt;/strong&gt; — Powers the agentic tool-calling loop via &lt;code&gt;POST /v2/ai/chat/completions&lt;/code&gt; with OpenAI-compatible function calling. The model (GLM-5.3-Flash) receives the conversation history and tool definitions, decides which tool to call, and the server executes it.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Number Lookup&lt;/strong&gt; — Validates and normalizes customer phone numbers at registration via &lt;code&gt;GET /v2/number_lookup/{phone}&lt;/code&gt;. Returns E.164 format so the app never stores mismatched phone formats.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Audio Transcription&lt;/strong&gt; — Transcribes WhatsApp voice notes via &lt;code&gt;POST /v2/ai/audio/transcriptions&lt;/code&gt; using the Whisper model.&lt;/p&gt;

&lt;h2&gt;
  
  
  Architecture
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;  WhatsApp Message (text / voice note / button tap)
        |
        v
  +-----------------------+
  | /webhooks/whatsapp    |  Express webhook handler
  +----------+------------+
             |
             v
  +-----------------------+
  | AI Inference           |  Agentic tool-calling loop
  | (GLM-5.3-Flash)       |  12 tools available
  +----------+------------+
             |
     +-------+-------+
     |               |
     v               v
  [Tool execution]  [WhatsApp reply]
  - browse_products  - sendText()
  - add_to_cart      - sendList()
  - place_order      - sendButtons()
  - track_delivery
             |
             v
  +-----------------------+
  | SSE -&amp;gt; Dashboard      |  Real-time 3-panel view
  +-----------------------+
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  The Tool-Calling Loop
&lt;/h2&gt;

&lt;p&gt;The core of the AI agent is a loop that runs until the model returns a final text response instead of a tool call:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;processInbound&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;db&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ssePublish&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;fromNumber&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;messages&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;getConversationHistory&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;db&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;fromNumber&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;role&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="n"&gt;turn&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;turn&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="no"&gt;MAX_TURNS&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;turn&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;chatCompletion&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;choice&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;choice&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;finish_reason&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s2"&gt;"tool_calls"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;toolCall&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="n"&gt;choice&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;tool_calls&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;result&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;executeTool&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;db&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ssePublish&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;fromNumber&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;toolCall&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
          &lt;span class="n"&gt;role&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"tool"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;result&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="n"&gt;tool_call_id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;toolCall&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;reply&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;choice&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sendText&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;fromNumber&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;reply&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;storeMessage&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;db&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;fromNumber&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"assistant"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;reply&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  The 12 AI Tools
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Tool&lt;/th&gt;
&lt;th&gt;Purpose&lt;/th&gt;
&lt;th&gt;WhatsApp Output&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;browse_products&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Browse by category or search&lt;/td&gt;
&lt;td&gt;Interactive list message&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;add_to_cart&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Add items (supports bulk from voice)&lt;/td&gt;
&lt;td&gt;Text confirmation&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;view_cart&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Show cart contents and total&lt;/td&gt;
&lt;td&gt;Formatted text&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;update_cart&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Change quantity or remove items&lt;/td&gt;
&lt;td&gt;Text confirmation&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;get_delivery_slots&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Available delivery windows&lt;/td&gt;
&lt;td&gt;Interactive list&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;place_order&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Checkout from cart&lt;/td&gt;
&lt;td&gt;Text with order number&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;track_delivery&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Delivery status and ETA&lt;/td&gt;
&lt;td&gt;Status timeline&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;reschedule_delivery&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Change delivery window&lt;/td&gt;
&lt;td&gt;Quick-reply buttons&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;handle_substitution&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Accept/reject replacements&lt;/td&gt;
&lt;td&gt;Quick-reply buttons&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;reorder&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Reorder past delivery items&lt;/td&gt;
&lt;td&gt;Quick-reply buttons&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;register_customer&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;New customer + Number Lookup&lt;/td&gt;
&lt;td&gt;Text&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;send_whatsapp&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Send formatted message&lt;/td&gt;
&lt;td&gt;Varies&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Voice Note Ordering
&lt;/h2&gt;

&lt;p&gt;When a customer sends a WhatsApp voice note, the webhook detects audio and routes it to Telnyx Audio Transcription:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;resp&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"https://api.telnyx.com/v2/ai/audio/transcriptions"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"POST"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nc"&gt;Authorization&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sb"&gt;`Bearer ${apiKey}`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s2"&gt;"Content-Type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"application/json"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;url&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;audioUrl&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;language&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"en"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"whisper"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;resp&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The transcription feeds into the AI agent as text. "Add bananas, eggs, and sourdough" becomes three separate &lt;code&gt;add_to_cart&lt;/code&gt; calls.&lt;/p&gt;

&lt;h2&gt;
  
  
  Phone Number Validation
&lt;/h2&gt;

&lt;p&gt;New customers register with their phone number. The server calls Telnyx Number Lookup to validate and normalize to E.164:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;nlResp&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
  &lt;span class="sb"&gt;`https://api.telnyx.com/v2/number_lookup/${encodeURIComponent(phone)}`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nc"&gt;Authorization&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sb"&gt;`Bearer ${apiKey}`&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;nlData&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;nlResp&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;nlData&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;valid_number&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;422&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;error&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Invalid phone number"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;e164Phone&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;nlData&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;phone_number&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This prevents the common bug where local format (&lt;code&gt;0626781895&lt;/code&gt;) and international format (&lt;code&gt;+31626781895&lt;/code&gt;) create duplicate customer records.&lt;/p&gt;

&lt;h2&gt;
  
  
  Run It
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/team-telnyx/telnyx-code-examples.git
&lt;span class="nb"&gt;cd&lt;/span&gt; telnyx-code-examples/whatsapp-grocery-delivery-nodejs
cp .env.example .env  &lt;span class="c"&gt;# add your keys&lt;/span&gt;
npm install
node server.js
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The server starts on &lt;code&gt;http://localhost:3000&lt;/code&gt;. Expose it for webhooks:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;ngrok http 3000
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Configure the webhook URL in the &lt;a href="https://portal.telnyx.com" rel="noopener noreferrer"&gt;Telnyx Portal&lt;/a&gt; under your WhatsApp Messaging Profile -&amp;gt; Webhook URL -&amp;gt; &lt;code&gt;https://&amp;lt;id&amp;gt;.ngrok.io/webhooks/whatsapp&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Open &lt;code&gt;http://localhost:3000&lt;/code&gt; in a browser to see the 3-panel dashboard. Register with your phone number, then message the WhatsApp number from your phone.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Dashboard
&lt;/h2&gt;

&lt;p&gt;The 3-panel dashboard updates in real time via Server-Sent Events:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Left — Product Catalog.&lt;/strong&gt; Nine categories, 70+ products with prices and dietary tags.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Center — WhatsApp Phone Mockup.&lt;/strong&gt; Live conversation mirror with typing indicators and tool activity.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Right — Delivery Pipeline.&lt;/strong&gt; Order cards progressing through Confirmed -&amp;gt; Picking -&amp;gt; Packed -&amp;gt; Out for Delivery -&amp;gt; Delivered. An Advance button lets you manually push orders through stages, sending WhatsApp notifications at each step.&lt;/p&gt;

&lt;h2&gt;
  
  
  Going to Production
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Database&lt;/strong&gt; — The app includes a Telnyx Edge SQL adapter for serverless deployment&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Webhook security&lt;/strong&gt; — Add signature verification for inbound webhooks&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Conversation limits&lt;/strong&gt; — Cap conversation history sent to AI Inference&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Error recovery&lt;/strong&gt; — Send retry messages on inference failures&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Multi-instance&lt;/strong&gt; — Move session state to Redis for horizontal scaling&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Frequently Asked Questions
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Do I need a WhatsApp Business Account?&lt;/strong&gt; Yes. You need a Telnyx account connected to a WABA with an approved phone number and a messaging profile.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Can customers order items not in the catalog?&lt;/strong&gt; Yes. The AI creates ad-hoc products when items aren't in the seed catalog.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;How does voice note ordering work?&lt;/strong&gt; Voice notes are transcribed via Telnyx Audio Transcription (Whisper), then fed to the AI agent as text. The agent parses items naturally and calls &lt;code&gt;add_to_cart&lt;/code&gt; for each one.&lt;/p&gt;

&lt;h2&gt;
  
  
  Resources
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://developers.telnyx.com/docs/messaging/whatsapp" rel="noopener noreferrer"&gt;WhatsApp API docs&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://developers.telnyx.com/docs/inference/getting-started" rel="noopener noreferrer"&gt;AI Inference docs&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://developers.telnyx.com/docs/inference/functions" rel="noopener noreferrer"&gt;AI Inference function calling&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://developers.telnyx.com/docs/identity/number-lookup/quickstart" rel="noopener noreferrer"&gt;Number Lookup docs&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://developers.telnyx.com/docs/voice/stt/getting-started" rel="noopener noreferrer"&gt;Audio Transcription docs&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://developers.telnyx.com/docs/development/sdk/node" rel="noopener noreferrer"&gt;Node.js SDK&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://portal.telnyx.com" rel="noopener noreferrer"&gt;Telnyx Portal&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://github.com/team-telnyx/telnyx-code-examples/tree/main/whatsapp-grocery-delivery-nodejs" rel="noopener noreferrer"&gt;Full code example&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;If you build something with this pattern — pharmacy, restaurant, booking agent — let me know in the comments. The agentic loop is more general than the grocery example.&lt;/p&gt;

</description>
      <category>ai</category>
      <category>telnyx</category>
      <category>api</category>
      <category>llm</category>
    </item>
  </channel>
</rss>
