Quoted Replies

A quoted reply shows the message you are answering above your own, the way a person does it in WhatsApp with a swipe. Use it when a conversation has several open questions and the contact needs to see which one you are answering.

Send a Quoted Reply

Set content.replyToMessageId to the Zavu ID of the message you are answering. For a message the contact sent you, that is the data.messageId of its message.inbound webhook.

TypeScriptcURLCopy
const result = await zavu.messages.send({
  to: "+14155551234",
  channel: "whatsapp",
  text: "Your order ships tomorrow.",
  content: {
    replyToMessageId: "msg_abc123",
  },
});

The quote works on every WhatsApp message type except reaction, which already names the message it reacts to. An image, a document or a button message can quote too: add replyToMessageId next to the rest of its content.

You can quote messages in both directions: one the contact sent you, or one you sent them. Either way it must belong to the conversation you are sending to, and the sender you send from must be the one that sent or received it.

Replying from a Webhook

TypeScriptCopy
app.post("/webhooks/zavu", async (req, res) => {
  const event = req.body;
  if (event.type === "message.inbound" && event.data.channel === "whatsapp") {
    await zavu.messages.send({
      to: event.data.from,
      channel: "whatsapp",
      text: await answer(event.data.text),
      content: { replyToMessageId: event.data.messageId },
      // Answer from the sender that received the message.
      "Zavu-Sender": event.senderId,
    });
  }
  res.sendStatus(200);
});

What Comes Back

The stored message carries the full reply context, so GET /v1/messages/{messageId} shows what was quoted:

JSONCopy
{
  "content": {
    "replyToMessageId": "msg_abc123",
    "replyToProviderMessageId": "wamid.HBgL...ORIGINAL",
    "replyToFrom": "+14155551234",
    "replyToText": "When does my order ship?",
    "replyToMessageType": "text"
  }
}

Only replyToMessageId is read from your request. The other replyTo* fields are filled in by Zavu.

Errors

A quote that cannot be delivered as a quote is refused. Zavu never sends it unquoted.

Quoted replies also work on Telegram.