Se você já integra com o Chatwoot, a API da ConverZAP vai parecer familiar: os conceitos de conversa, mensagem, nota, etiqueta, atendente, equipe e resposta pronta são os mesmos. As diferenças principais:
Conceitos
| Chatwoot | ConverZAP |
|---|---|
/api/v1/accounts/{account_id}/... | /v1/... (a conta vem da chave) |
api_access_token (token de usuário, sem escopo) | Authorization: Bearer czk_live_… com escopos |
| inbox | canal = número de WhatsApp (/v1/channels, id = phone_number_id) |
| várias conversas por contato | uma conversa por contato e número |
status open / pending / snoozed / resolved | open / snoozed / resolved; o "pending" do bot vira awaiting_human: true |
message_type 0/1/2 | direction: inbound / outbound + author (contact, user, ai_agent, phone, campaign…) |
private: true | notas em /conversations/{id}/notes |
| datas em Unix | ISO 8601 em tudo |
page com tamanhos fixos | cursor (limit, cursor) |
| erros variados | RFC 9457 com code estável |
Endpoints equivalentes (leitura)
| Chatwoot | ConverZAP |
|---|---|
GET /conversations?status=&assignee_type=&inbox_id=&labels[]= | GET /v1/conversations?status=&assignee=&channel=&label= (assignee: me, unassigned, assigned ou id) |
GET /conversations/meta | GET /v1/conversations/counts |
GET /conversations/{id}/messages | GET /v1/conversations/{id}/messages |
GET /contacts · /contacts/search | GET /v1/contacts?q= · GET /v1/contacts/by-phone/{phone} |
GET /labels | GET /v1/labels |
GET /custom_attribute_definitions | GET /v1/custom-fields (só de contato) |
GET /agents · /teams · /inboxes | GET /v1/users · /v1/teams · /v1/channels |
GET /canned_responses | GET /v1/canned-responses |
GET /inboxes/{id}/message_templates | GET /v1/templates |
GET /api/v2/reports/summary | GET /v1/reports/inbox (com o período anterior) |
O que não existe aqui
Prioridade de conversa, atributos personalizados de conversa (use os campos do contato), equipe atribuída à conversa (na ConverZAP a equipe se liga aos números e ao rodízio), indicador de digitação e contact_inboxes (o telefone E.164 basta).
Envio de mensagens, notas e ações da conversa chegam na próxima fase (escrita).