Get started
Coexistence
A number that keeps the WhatsApp Business app: what is written from the phone reaches you too.
With coexistence, a business connects its number to Nodium and keeps using the WhatsApp Business app on its phone. GET /channels?scope=account tells which numbers do (coexistence). Both sides write in the same threads; Nodium carries what the phone does to you.
What is written from the phone
message.echoed— the person holding the phone wrote to a contact from the app, not through the API. The payload carriesto,type,text(or the caption),mediaandsent_at, andsenderis alwaysphone.message.edited— a message was edited from the phone.message_idandprovider_message_idare those of the original message;textis the text after the edit.message.revoked— a message was deleted for everyone from the phone; same identifiers as the original.- These messages are stored as outbound, in the conversation, and signed by the person the client named as holding the phone. They do not reopen the 24-hour window: only a message from the customer does.
{ "id": "evt_9a8b7c6d5e4f30211a2b3c4d5e6f7081", "event": "message.echoed", "workspace_id": "…", "external_id": "crm-4187", "occurred_at": "2026-09-29T09:59:58.900Z", "data": { "message_id": "…", "conversation_id": "…", "channel_id": "…", "to": "+33612345678", "sender": "phone", "type": "text", "text": "Received, see you tomorrow.", "sent_at": "2026-09-29T09:59:58.000Z" }}How to tell them apart in messages
originon a message isphonewhen it was written from the WhatsApp Business app; otherwisenull. Use it to tell a person's message from one your code sent.importedistruefor a message taken from the phone's chat history, not received live.- Both appear in
GET /conversations/{id}/messages.
History
When the number is connected, Meta can hand over the conversations already on the phone, and the address book. Nodium imports them into the same conversations and contacts: read them through the API (imported: true). No webhook is sent for imported history — it is not news — so do not wait for one; list the conversations instead. Imported history never moves the 24-hour window backwards.