DEVELOPER GUIDE

How to prevent duplicate WhatsApp messages

Use idempotency keys and durable event records so retries never become duplicate customer alerts.

Developer guide for duplicate messages. Validate the behavior in your own stack before production rollout.

The problem

Derive one key from the source event revision and recipient before the first send.

Design the boundary

Send the same key on every retry and store the resulting message ID against the source event.

Process the interaction

Treat timeouts as unknown outcomes; retry with the original key and cap attempts.

Measure the outcome

Measure duplicate conflicts, retry count and dead-lettered sends.

Related documentation

WhatsApp API · Webhook events · Security · Tutorials

BUILD IT SAFELY

Make the failure path part of the design.

Reliable messaging is an operational system, not only an API call.

Gain Access
STRAIGHT ANSWERS

Questions before you build?

Start with the documentation or review the practical answers below.

Is ChatRail the official Meta Cloud API?

No. ChatRail uses a WhatsApp Linked Devices session. Review the transport trade-offs before production use.

Can I use it without AI?

Yes. Sending, delivery tracking and webhooks work without enabling AI.

Where should I start?

Use the Quickstart for your first request, then choose a workflow tutorial.