Build on top of
Wa-Wexa.

Authenticate with your API key.

Wa-Wexa provides a secure application API for workspace data, messaging, automations, flows, and webhooks. Official Meta WhatsApp Business services power message delivery behind the scenes.

Send a WhatsApp message.

Send text, media, location, contact, or interactive messages through an existing conversation, or start a template conversation with an E.164 phone number.

fetch('/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    conversation_id: 'conversation-uuid',
    message_type: 'text',
    content_text: 'Hello from Wa-Wexa'
  })
})

Start with a phone number

For a first business-initiated message, send an E.164 phone instead of conversation_id. Wa-Wexa finds or creates the contact and its open conversation in the API key's workspace before sending the approved template. The optional name is used only when a new contact is created.

fetch('/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '+919876XXXX',
    name: 'Aarav Sharma',
    message_type: 'template',
    template_name: 'welcome_message',
    template_params: ['Aarav', 'Wa-Wexa']
  })
})

Get the conversation_id from the response

You do not create this UUID yourself. The conversation-uuid text in examples is only a placeholder. When the phone-first template request succeeds, the response contains the workspace-scoped conversation_id. Save that returned value for later messages to the same conversation.

const response = await fetch('/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '+919876XXXX',
    name: 'Raki',
    message_type: 'template',
    template_name: 'welcome_message',
    template_params: ['Aarav']
  })
});

if (!response.ok) {
  throw new Error(await response.text());
}

const result = await response.json();
const conversationId = result.conversation_id;
console.log('Save this ID for later messages:', conversationId);

Send the next message to the same number

For a text reply, pass the saved conversation_id. For another approved template, you can pass that ID too, or send the same phone again; Wa-Wexa will find the existing contact and conversation in the same workspace. Phone-only sends are for templates, not free-form text. Replace conversation-uuid below with the actual ID from the first successful response.

{
  "conversation_id": "conversation-uuid",
  "message_type": "text",
  "content_text": "Hello again"
}

await fetch('https://wawexa.com/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    conversation_id: conversationId,
    message_type: 'text',
    content_text: 'Hello again'
  })
})

{
  "success": true,
  "conversation_id": "conversation-uuid",
  "contact_id": "contact-uuid",
  "message_id": "message-uuid",
  "whatsapp_message_id": "wamid..."
}

fetch('/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    conversation_id: 'conversation-uuid',
    message_type: 'template',
    template_name: 'welcome_message',
    template_params: ['Aarav']
  })
})

fetch('/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '+919876XXXX',
    name: 'Aarav Sharma',
    message_type: 'template',
    template_name: 'welcome_message',
    template_params: ['Aarav', 'Wa-Wexa']
  })
})

// app/api/wawexa/request/route.ts
export async function POST(request: Request) {
  const response = await fetch('https://wawexa.com/api/whatsapp/send', {
    method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.WAWEXA_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(await request.json()),
  });
  return Response.json(await response.json(), { status: response.status });
}

Manage Marketing, Utility, and Authentication templates.

Create templates locally, submit them to Meta for review, synchronize approval status, and send approved templates using scoped API keys.

Create a Utility template

const response = await fetch('/api/whatsapp/templates', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'order_update',
    category: 'Utility',
    language: 'en_US',
    body_text: 'Order {{1}} will arrive on {{2}}.',
    variable_samples: ['ORD-1001', '25 Sep 2026']
  })
})

const { template, next_step } = await response.json()

Create an Authentication template

const response = await fetch('/api/whatsapp/templates', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'login_code',
    category: 'Authentication',
    language: 'en_US',
    body_text: 'Your verification code is {{1}}.',
    authentication: {
      buttonType: 'copy_code',
      addSecurityRecommendation: true,
      codeExpirationMinutes: 10,
      copyCodeText: 'Copy Code'
    }
  })
})

const { template } = await response.json()

Authentication templates must contain exactly one {{1}} verification-code variable. Set buttonType to copy_code, one_tap, or none. One-tap also requires packageName and signatureHash.

Submit and synchronize

await fetch('/api/whatsapp/templates/submit', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ template_id: 'template-uuid' })
})

Submission returns Meta's template ID and review status. Call POST /api/whatsapp/templates/sync later to refresh Pending, Approved, or Rejected status.

Send an approved Utility template

fetch('/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    conversation_id: 'conversation-uuid',
    message_type: 'template',
    template_name: 'welcome_message',
    template_params: ['Aarav', 'Wa-Wexa']
  })
})

Send an approved Authentication code

fetch('/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    conversation_id: 'conversation-uuid',
    message_type: 'template',
    template_name: 'login_code',
    template_params: ['482913']
  })
})

Send a template from your framework

// app/api/wawexa/send/route.ts
export async function POST(request: Request) {
  const { template_name, template_params = [] } = await request.json();
  const response = await fetch(
    'https://wawexa.com/api/whatsapp/send',
    {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.WAWEXA_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        phone: '+919876XXXX',
        message_type: 'template',
        template_name,
        template_params,
      }),
    },
  );
  return Response.json(await response.json(), { status: response.status });
}

// app/api/wawexa/request/route.ts
export async function POST(request: Request) {
  const response = await fetch('https://wawexa.com/api/whatsapp/send', {
    method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.WAWEXA_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(await request.json()),
  });
  return Response.json(await response.json(), { status: response.status });
}

Track delivery and read events.

Meta posts delivery lifecycle events to the webhook. Wa-Wexa mirrors them onto message and broadcast-recipient records.

For application data, read the messages.status or broadcast_recipients.status fields through the authenticated Wa-Wexa API.

Keep your audience in sync.

Contacts are managed in your Wa-Wexa workspace. Use the authenticated Wa-Wexa API so workspace permissions remain in control of every read and write.

const response = await fetch('/api/contacts', {
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key'
  }
})

const { contacts } = await response.json()

CRUD request examples

Choose a framework and operation. These examples use the Contacts API; the same authentication pattern applies to templates, automations, and flows.

// app/api/wawexa/contacts/route.ts
export async function POST(request: Request) {
  const body = await request.json();
  const response = await fetch('https://wawexa.com/api/contacts', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.WAWEXA_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(body),
  });
  return Response.json(await response.json(), { status: response.status });
}

Trigger actions without extra glue.

Create and manage keyword, event, and time-based automation rules. Activation validates the trigger and step configuration.

fetch('/api/automations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'New lead follow-up',
    trigger_type: 'keyword',
    trigger_config: { keyword: 'pricing' },
    is_active: false,
    steps: []
  })
})

// app/api/wawexa/request/route.ts
export async function POST(request: Request) {
  const response = await fetch('https://wawexa.com/api/automations', {
    method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.WAWEXA_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(await request.json()),
  });
  return Response.json(await response.json(), { status: response.status });
}

Trigger a personalized Utility automation

Create an automation with the External Eventtrigger and event name order.shipped. In its Send Template step, map {{1}} to {{vars.order_id}} and {{2}} to {{vars.delivery_date}}.

fetch('/api/automations/engine', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    event_name: 'order.shipped',
    phone: '+919876XXXX',
    contact_name: 'Aarav',
    variables: {
      order_id: 'ORD-8451',
      delivery_date: '18 September 2026'
    }
  })
})

Trigger an Authentication template

Create an External Event automation named auth.otp_requested, select the approved Authentication template, and map {{1}} to {{vars.otp_code}}. Generate, expire, and verify the OTP in your authentication server; Wa-Wexa handles delivery.

fetch('/api/automations/engine', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    event_name: 'auth.otp_requested',
    phone: '+919876XXXX',
    variables: {
      otp_code: '482913'
    }
  })
})

Build guided conversations.

Flows are structured conversation journeys with triggers and nodes. They can be created as drafts, updated, published, and deleted from the flow API.

fetch('/api/flows', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wawexa_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Lead qualification',
    trigger_type: 'keyword',
    trigger_config: { keyword: 'start' }
  })
})

// app/api/wawexa/request/route.ts
export async function POST(request: Request) {
  const response = await fetch('https://wawexa.com/api/flows', {
    method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.WAWEXA_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(await request.json()),
  });
  return Response.json(await response.json(), { status: response.status });
}

Receive events securely.

Configure Meta to send WhatsApp messages and status updates to this endpoint. Wa-Wexa verifies the HMAC signature before processing the event.

POST https://your-wa-wexa-domain.com/api/whatsapp/webhook

Headers:
x-hub-signature-256: sha256=<meta-signature>
Content-Type: application/json