Skip to main content
Use client.chatwoot() to connect a VZaps instance to Chatwoot. Common fields on every call:
FieldTypeRequiredDescription
instanceIdstringYesInstance ID.
instanceTokenstringYesInstance token.

​
client.chatwoot().get(...)

Reads the current configuration, including webhookUrl and tokenMasked when applicable. 
var options = InstanceRequestOptions.builder().instanceToken(instanceToken).build();
JsonNode result = client.chatwoot().get(GenericInstanceRequest.builder()
    .instanceId(instanceId)
    .instanceToken(instanceToken)
    .build());
// Example: tipagem estrita com DTOs publicados quando disponivel
Return: Chatwoot config (enabled, url, account_id, webhook_url, token_masked, etc.).

​
client.chatwoot().set(...)

Creates or updates the instance Chatwoot integration. 
var options = InstanceRequestOptions.builder().instanceToken(instanceToken).build();
JsonNode result = client.chatwoot().set(GenericInstanceRequest.builder()
    .instanceId(instanceId)
    .instanceToken(instanceToken)
    .build());
// Example: tipagem estrita com DTOs publicados quando disponivel
Return: saved config (includes webhook_url when generated). Main payload fields:
FieldTypeRequiredDescription
enabledbooleanYesEnables or disables the integration.
urlstringYesChatwoot base URL.
accountIdstringYesNumeric account ID.
tokenstringYesChatwoot API token.
nameInboxstringNoAPI inbox name.
autoCreatebooleanNoAuto-create inbox and webhook.
importContactsbooleanNoImport contacts in the initial flow.
importMessagesbooleanNoImport messages in the initial flow.
daysLimitImportMessagesnumberNoMessage import window in days. Minimum 1.
ignoreGroupsbooleanNoIgnore group messages.
ignoreJidsarrayNoJIDs to ignore.
Copy webhookUrl from the response into the Chatwoot API inbox when autoCreate does not apply it automatically.

​
client.chatwoot().delete(...)

Removes the Chatwoot integration from the instance. 
var options = InstanceRequestOptions.builder().instanceToken(instanceToken).build();
JsonNode result = client.chatwoot().delete(GenericInstanceRequest.builder()
    .instanceId(instanceId)
    .instanceToken(instanceToken)
    .build());
// Example: tipagem estrita com DTOs publicados quando disponivel
Return: integration removal confirmation.

​
client.chatwoot().triggerImport(...)

Triggers a manual import of contacts, messages, or both. Import contacts: 
var options = InstanceRequestOptions.builder().instanceToken(instanceToken).build();
JsonNode result = client.chatwoot().triggerImport(GenericInstanceRequest.builder()
    .instanceId(instanceId)
    .instanceToken(instanceToken)
    .build());
// Example: tipagem estrita com DTOs publicados quando disponivel
Return: import job confirmation (contacts, messages, or all). Import messages: 
await vzaps.chatwoot.triggerImport({
  instanceId: 'VZ...',
  instanceToken: 'instance-token',
  what: 'messages',
});
Import all: 
await vzaps.chatwoot.triggerImport({
  instanceId: 'VZ...',
  instanceToken: 'instance-token',
  what: 'all',
});
Accepted values for what: contacts, messages, all.