v2026.8.19
Release date: August 26, 2026
New Features
contact field on the create-chat API
POST /chat/create reads the recipient from customer based on the channel: WhatsApp uses customer.whatsapp (or phone), email uses customer.email, Instagram/Facebook use the matching ID. Name, document, tags, and custom fields also go in that object.
What is it for?
- Simpler Make, n8n, and other automations: just the number (or ID) and
channelId - Avoid a mismatch between the type you send and the channel you pick
- Find the same customer if the CRM stored
instagramand inbound storedinstagramId
How to use it?
- Send
contact+channelId(plus the usual optional fields) - Official WhatsApp, WAPI, Z-API, WAHA, and EVO treat the value as WhatsApp
- Instagram and Facebook use the contact ID; email uses the address
- Use
customerfor email, phone, WhatsApp, and document - Docs: Create Chat
Benefits
- Smaller payload, aligned with the channel
- New integrations do not need to guess the type enum
- Customers created by inbound (Instagram/Facebook) are reused when opening a chat via API