Cas d’usageVos clients suivent leur commande sur WhatsApp, et vous savez qu’ils l’ont lu.

Pas à pas, avec le vrai.

1. 1

   Le modèle d’expédition

   Claude Code le crée par create_template : catégorie utilitaire, le prénom et le numéro de commande, un bouton « Suivre mon colis » vers votre page de suivi. Meta l’approuve, souvent en quelques minutes, et get_template_status le confirme.

2. 2

   L’envoi à l’expédition

   Quand une commande passe en expédiée, votre application envoie le modèle par POST /v1/sends, avec une clé d’idempotence tirée de la commande : rejoué dans les 24 heures, il n’envoie pas deux fois. L’identifiant d’envoi rendu se range sur la commande.

3. 3

   Livré, puis lu

   Votre route, déclarée par create_webhook_endpoint, reçoit message.delivered puis message.read (décochés par défaut, on les coche exprès) : elle retrouve la commande par l’identifiant d’envoi et l’affiche « Lu ».

4. 4

   S’il répond

   Sa réponse ouvre une conversation, que prend l’agent IA qui répond pour l’espace (set_default_responder), avec votre politique de livraison dans sa connaissance. En Pro, votre équipe peut reprendre la main dans l’Inbox de la console.

Ce que vous tapez dans Claude Code

Le plugin installé, une phrase suffit : Claude Code crée le modèle, branche l’envoi et la route, et teste.

quand une commande passe en expédiée (lib/commandes.ts), envoie un whatsapp au client avec le suivi, et marque dans l’admin quand il l’a lu. s’il répond, l’agent IA prend la main

L’envoi à l’expédition, tel que Claude Code l’écrit

import { messagingme } from './messagingme';

// What this case needs from your orders: Claude Code wires these two functions to your own database.
const todo = (what: string): never => { throw new Error(`lib/orders.ts: ${what} is not connected yet`); };
export async function saveSendId(orderId: string, sendId: string): Promise<void> { return todo('saveSendId'); }
export async function setWhatsappStatus(sendId: string, status: 'delivered' | 'read'): Promise<void> { return todo('setWhatsappStatus'); }

// Call it when an order moves to shipped. The template order_shipped has two variables, the first name then the
// order number, and a URL button to your tracking page.
export async function notifyShipped(order: { id: string; phone: string; firstName: string }): Promise<void> {
  const send = await messagingme.POST('/v1/sends', {
    body: {
      target: { template: { name: 'order_shipped', language: 'en' } },
      recipients: [{ phone: order.phone, variables: { firstName: order.firstName, order: order.id } }],
      params: [
        { position: 1, source: { type: 'variable', key: 'firstName' } },
        { position: 2, source: { type: 'variable', key: 'order' } },
      ],
    },
    // Replayed within 24 hours (the life of the key), the shipment does not send twice.
    idempotencyKey: `shipped-${order.id}`,
  });
  // The delivery and read receipts carry this sendId: it ties them back to the order.
  await saveSendId(order.id, send.sendId);
}

lib/orders.ts · tout le code dans le guide