Skip to main content
POST
Edits lead information

Authorizations

token
string
header
required

Body

application/json
id
string
required

Chat identifier. Can be:

Example:

"5511999999999@s.whatsapp.net"

chatbot_disableUntil
integer<int64>

Pauses automation (AI, triggers, and flows) in this conversation until this time, in milliseconds. -1 pauses until someone turns it back on; 0 turns it back on.

Example:

-1

chatbot_agentResetMemoryAt
integer<int64>

Resets the AI memory in the conversation: the agent starts reading only messages from this time (ms) onward. -1 is now (server time); 0 undoes it. A time in the future counts as now.

Example:

-1

lead_isTicketOpen
boolean

Status of the ticket associated with the lead.

  • true: Ticket is open/in service
  • false: Ticket is closed/resolved
Example:

true

lead_assignedAttendant_id
string

ID of the attendant assigned to the lead. Use an empty string ("") to remove the assignment.

Example:

"att_123456"

lead_kanbanOrder
integer<int64>

Card position on the kanban board. Higher values appear first.

Example:

1000

lead_tags
string[]

List of tags associated with the lead. Non-existent tags are created automatically. Tags with kanban=true represent the card's column. Send an empty array ([]) to remove all tags.

Example:
lead_name
string

Lead's main name

Example:

"John Doe"

lead_fullName
string

Lead's full name

Example:

"John Smith Doe"

lead_email
string<email>

Lead email

Example:

"joao@exemplo.com"

lead_personalid
string

Identification document (CPF/CNPJ) Numbers only or formatted

Example:

"123.456.789-00"

lead_status
string

Free-form lead status in the sales funnel

Example:

"qualificado"

lead_notes
string

Notes about the lead

Example:

"Customer interested in premium plan"

lead_field01
string

Custom field 1

lead_field02
string

Custom field 2

lead_field03
string

Custom field 3

lead_field04
string

Custom field 4

lead_field05
string

Custom field 5

lead_field06
string

Custom field 6

lead_field07
string

Custom field 7

lead_field08
string

Custom field 8

lead_field09
string

Custom field 9

lead_field10
string

Custom field 10

lead_field11
string

Custom field 11

lead_field12
string

Custom field 12

lead_field13
string

Custom field 13

lead_field14
string

Custom field 14

lead_field15
string

Custom field 15

lead_field16
string

Custom field 16

lead_field17
string

Custom field 17

lead_field18
string

Custom field 18

lead_field19
string

Custom field 19

lead_field20
string

Custom field 20

Response

Updated lead. Includes the lead and chatbot fields of the conversation, not the whole Chat (no lead_awaitingReply, for example).

Represents a conversation/ticket in the system

id
string

Unique conversation ID (r + 7 random bytes in hex)

wa_fastid
string

WhatsApp fast identifier

wa_chatid
string

Full chat ID on WhatsApp

wa_chatlid
string

Chat LID on WhatsApp (when available)

wa_archived
boolean
default:false

Indicates whether the chat is archived

wa_contactName
string
default:""

Name saved in the phone's address book for this number (empty: not saved). The conversation is created with it (by LID, via the linked number) and it changes when the contact is saved or deleted on the phone.

wa_name
string
default:""

Name set by the user in the WhatsApp profile ("push name"). Comes from the contact's profile and may not be available depending on the context or data source.

name
string
default:""

Name resolved by the system as a fallback. It usually consolidates the best value available among internal data, the name coming from WhatsApp and the name saved in contacts. Therefore, it is more likely to be filled in.

image
string
default:""

Chat image URL

imagePreview
string
default:""

Image thumbnail URL

parent_community
object

Parent community of the chat when it represents a subgroup

wa_ephemeralExpiration
integer<int64>
default:0

Expiration time for ephemeral messages

wa_isBlocked
boolean
default:false

Indicates whether the contact is blocked

wa_isGroup
boolean
default:false

Indicates whether it is a group

wa_isGroup_admin
boolean
default:false

Indicates whether the user is a group admin

wa_isGroup_announce
boolean
default:false

Indicates whether it is an announcement-only group

wa_isGroup_community
boolean
default:false

Indicates whether it is a community

wa_isGroup_member
boolean
default:false

Indicates whether is a group member

wa_isPinned
boolean
default:false

Indicates whether the chat is pinned

wa_label
string[]

Chat labels

wa_notes
string
default:""

Internal chat notes synced via app state

wa_lastMessageTextVote
string
default:""

Text/vote of the last message

wa_lastMessageType
string
default:""

Type of the last message

wa_lastMsgTimestamp
integer<int64>
default:0

Timestamp of the last message

wa_lastMessageSender
string
default:""

Sender of the last message

lead_awaitingReply
boolean
read-only

true when the contact is awaiting a reply: the last message is theirs and no one has resolved the conversation (POST /lead/resolve). The contact's message turns it on; ours (you, the AI, a flow, or an integration) turns it off. In conversations predating this field, the api decides based on the sender (the instance's number or LID). Only in conversations with people: absent in groups and channels, which are not included in either filter, and when the conversation has no known last message (only the date). Filterable in /chat/find.

wa_muteEndTime
integer<int64>
default:0

Timestamp of the end of muting

owner
string
default:""

Instance owner

wa_unreadCount
integer<int64>
default:0

Unread message counter

phone
string
default:""

Phone number

common_groups
string
default:""

Groups in common separated by commas, format: (group_name)group_id

Example:

"Family Group(120363123456789012@g.us),Work(987654321098765432@g.us)"

lead_name
string
default:""

Lead name

lead_fullName
string
default:""

Lead's full name

lead_email
string
default:""

Lead email

lead_personalid
string
default:""

Identification document

lead_status
string
default:""

Free-form lead status

lead_tags
string[]

Lead tags. Tags configured with kanban=true also determine the columns in which the card appears in the Kanban.

lead_notes
string
default:""

Notes about the lead

lead_isTicketOpen
boolean
default:false

Indicates whether there is an open ticket

lead_assignedAttendant_id
string
default:""

ID of the responsible attendant

lead_kanbanOrder
integer<int64>
default:0

Order in the kanban

lead_field01
string
default:""
lead_field02
string
default:""
lead_field03
string
default:""
lead_field04
string
default:""
lead_field05
string
default:""
lead_field06
string
default:""
lead_field07
string
default:""
lead_field08
string
default:""
lead_field09
string
default:""
lead_field10
string
default:""
lead_field11
string
default:""
lead_field12
string
default:""
lead_field13
string
default:""
lead_field14
string
default:""
lead_field15
string
default:""
lead_field16
string
default:""
lead_field17
string
default:""
lead_field18
string
default:""
lead_field19
string
default:""
lead_field20
string
default:""
chatbot_agentResetMemoryAt
integer<int64>
default:0

AI memory start (ms): the agent only reads the conversation messages from this point on. 0: no cutoff (the agent's window applies). Set via /chat/editLead.

chatbot_lastTrigger_id
string
default:""

ID of the last executed trigger

chatbot_lastTriggerAt
integer<int64>
default:0

Timestamp of the last trigger

chatbot_disableUntil
integer<int64>
default:0

Automation (AI, triggers, and flows) paused in this conversation until this time, in milliseconds. -1: until someone turns it back on; 0: on.

chatbot_summary
string
default:""

Reason for the pause made by the automation: human request (AI or flow; paused until someone turns it back on) or AI reply limit (1-hour pause). Empty when there is no pause or after it ends. Turning it back on (chatbot_disableUntil: 0 in /chat/editLead) or resolving (POST /lead/resolve) clears it.