chatsac
Testar grátis
No arVia API· API e dados

API REST

Em resumo

A API REST dá acesso programático ao que a sua equipe faz no painel: contatos, conversas, negócios, funis, campanhas, modelos e métricas. A especificação pública tem 120 operações, e esta página lê esse número direto dela.

Conferido em 16/10/2026 contra especificação da API

Como configurar

  1. Gere um token de acesso no painel (formato nxs_).
  2. Leia a documentação e teste as chamadas na página da API.
  3. Envie o token no cabeçalho Authorization como Bearer.
  4. Respeite o limite de requisições e trate as respostas de erro padronizadas.

O que se move e em que direção

  • ChatsacContatos e negóciosNos dois sentidosSeu sistema
  • ChatsacConversas e mensagensNos dois sentidosSeu sistema
  • ChatsacMétricas e relatóriosChatsac para o seu sistemaSeu sistema
O queDireçãoQuando
Contatos e negóciosNos dois sentidosA cada chamada que o seu sistema fizer
Conversas e mensagensNos dois sentidosA cada chamada, dentro da regra de 24 horas do WhatsApp
Métricas e relatóriosChatsac para o seu sistemaQuando o seu sistema consultar

O que não faz

Os limites estão por escrito para você decidir sem surpresa.

  • Limite de 50 requisições por segundo e 2.500 por minuto. Acima disso a API responde 429.
  • Nem toda função do painel tem uma operação na API ainda. Confira a lista antes de planejar.
  • Webhooks não são gerenciados pela API. Eles são configurados no painel (veja a página de Webhooks).
  • Fora da janela de 24 horas do WhatsApp, só modelos aprovados pela Meta podem ser enviados.
  • Ainda não publicamos política de versionamento nem SLA da API.

O que a API alcança

Contagem lida da especificação pública: 120 operações em 91 caminhos. Limite: 50 requisições por segundo e 2.500 por minuto.

120 operações

  • GET/api/v1/analytics/agents-performanceAgent performance metrics
  • GET/api/v1/analytics/conversation-analysis/{id}Conversation analysis (sentiment, intent, summary)
  • GET/api/v1/analytics/conversationsConversation sentiment analytics
  • GET/api/v1/analytics/dashboardDashboard KPIs (conversations, contacts, deals, CSAT)
  • GET/api/v1/analytics/financial/settingsValue metrics settings
  • PUT/api/v1/analytics/financial/settingsUpdate value metrics settings
  • GET/api/v1/analytics/lead-score/{contactId}Lead score for contact
  • GET/api/v1/callsList call history
  • GET/api/v1/calls/{id}Call detail
  • GET/api/v1/calls/{id}/analysisCall transcription and sentiment
  • GET/api/v1/calls/{id}/notesList call notes
  • POST/api/v1/calls/{id}/notesAdd note to call
  • GET/api/v1/telephony/configTenant telephony configuration
  • GET/api/v1/telephony/providersList telephony providers
  • GET/api/v1/campaignsList campaigns
  • POST/api/v1/campaignsCreate campaign (draft)
  • DELETE/api/v1/campaigns/{id}Delete campaign (draft only)
  • GET/api/v1/campaigns/{id}Campaign detail
  • PUT/api/v1/campaigns/{id}Update campaign (draft only)
  • POST/api/v1/campaigns/{id}/cancelCancel scheduled campaign
  • GET/api/v1/campaigns/{id}/metricsCampaign delivery metrics
  • GET/api/v1/campaigns/{id}/recipientsList campaign recipients
  • POST/api/v1/campaigns/{id}/recipientsAdd recipients to campaign
  • GET/api/v1/playbooksList playbooks
  • GET/api/v1/playbooks/{id}Playbook detail
  • GET/api/v1/channel/listList channels
  • GET/api/v1/chatbotsList chatbot flows
  • GET/api/v1/chatbots/{id}Chatbot flow detail
  • GET/api/v1/chats/{id}Get chat by ID
  • GET/api/v1/chats/{id}/attributesList conversation attributes
  • POST/api/v1/chats/{id}/attributesUpsert conversation attributes
  • GET/api/v1/chats/{id}/attributes/{key}Get conversation attribute by key
  • GET/api/v1/chats/{id}/classificationGet conversation classification (sentiment, intent)
  • POST/api/v1/chats/{id}/finalizeFinalize a single chat
  • GET/api/v1/chats/{id}/messagesList messages of a chat (cursor-paginated)
  • GET/api/v1/chats/{id}/notesList conversation notes
  • POST/api/v1/chats/{id}/notesAdd note to conversation
  • DELETE/api/v1/chats/{id}/notes/{noteId}Delete conversation note
  • DELETE/api/v1/chats/{id}/pinUnpin a conversation
  • POST/api/v1/chats/{id}/pinPin a conversation
  • POST/api/v1/chats/{id}/transferTransfer chat to agent or team
  • POST/api/v1/chats/countCount conversations by filters
  • POST/api/v1/chats/create-newOpen a new chat with a contact and optionally send first message
  • POST/api/v1/chats/finalizeBulk finalize conversations
  • GET/api/v1/chats/listList chats
  • POST/api/v1/chats/list-liteLightweight conversation list
  • POST/api/v1/chats/messages/schedulerSchedule a message
  • DELETE/api/v1/chats/messages/scheduler/{scheduleId}Cancel scheduled message
  • GET/api/v1/chats/messages/scheduler/{scheduleId}Get scheduled message by ID
  • POST/api/v1/chats/messages/scheduler/listList scheduled messages
  • GET/api/v1/chats/pinnedList pinned conversations
  • POST/api/v1/chats/send-textSend a WhatsApp text message
  • GET/api/v1/contactsList contacts
  • POST/api/v1/contactsCreate contact
  • GET/api/v1/contacts/{id}Get contact by ID
  • GET/api/v1/contacts/{id}/attributesList contact attributes
  • POST/api/v1/contacts/{id}/attributesUpsert contact attributes
  • GET/api/v1/contacts/{id}/attributes/{key}Get contact attribute by key
  • GET/api/v1/contacts/{id}/tagsList contact tags
  • PUT/api/v1/contacts/{id}/tagsReplace all tags on contact
  • PUT/api/v1/contacts/{id}/tags/addAdd tags to contact (incremental)
  • PUT/api/v1/contacts/{id}/tags/removeRemove tags from contact
  • GET/api/v1/contacts/number/{number}Lookup contact by phone number
  • GET/api/v1/csat/configGet CSAT configuration
  • PUT/api/v1/csat/configUpdate CSAT configuration
  • GET/api/v1/csat/metricsAggregated CSAT metrics
  • GET/api/v1/csat/metrics/by-agentCSAT metrics grouped by agent
  • GET/api/v1/csat/metrics/trendCSAT daily trend (last 90 days)
  • GET/api/v1/csat/ratingsList CSAT ratings
  • GET/api/v1/dealsList deals
  • POST/api/v1/dealsCreate deal
  • DELETE/api/v1/deals/{id}Delete deal
  • GET/api/v1/deals/{id}Deal detail with stage history
  • PUT/api/v1/deals/{id}Update deal
  • POST/api/v1/deals/{id}/closeClose deal as won or lost
  • PUT/api/v1/deals/{id}/custom-propertiesSet custom property values on deal
  • GET/api/v1/deals/{id}/historyDeal stage movement history
  • POST/api/v1/deals/{id}/moveMove deal to stage (records history)
  • GET/api/v1/deals/custom-propertiesList custom property definitions
  • POST/api/v1/deals/custom-propertiesCreate custom property
  • GET/api/v1/deals/pipelinesList pipelines with stages
  • POST/api/v1/messagesSend message (unified)
  • DELETE/api/v1/messages/{id}Soft-delete a message
  • GET/api/v1/pipelinesList pipelines
  • POST/api/v1/pipelinesCreate pipeline
  • DELETE/api/v1/pipelines/{id}Delete pipeline (fails if has deals)
  • GET/api/v1/pipelines/{id}Pipeline detail with stages
  • PUT/api/v1/pipelines/{id}Update pipeline
  • GET/api/v1/pipelines/{id}/stagesList stages of a pipeline
  • POST/api/v1/pipelines/{id}/stagesCreate stage
  • DELETE/api/v1/pipelines/{pipelineId}/stages/{stageId}Delete stage (fails if has deals)
  • PUT/api/v1/pipelines/{pipelineId}/stages/{stageId}Update stage
  • GET/api/v1/scriptsList automation scripts
  • DELETE/api/v1/scripts/{id}Delete script
  • GET/api/v1/scripts/{id}Script detail (includes code)
  • GET/api/v1/scripts/eventsList available trigger event types
  • DELETE/api/v1/scripts/scheduler/{id}Cancel scheduled script
  • POST/api/v1/scripts/scheduler/listList script executions
  • GET/api/v1/check-is-service-timeCheck if current time is within business hours
  • GET/api/v1/service-time-rulesList business hours rules
  • GET/api/v1/general-settingsGet company settings
  • POST/api/v1/general-settingsUpdate company settings
  • GET/healthHealth check
  • GET/api/v1/tagsList workspace tags
  • GET/api/v1/teamsList teams
  • POST/api/v1/teamsCreate team
  • GET/api/v1/teams/{id}Team detail with members
  • PUT/api/v1/teams/{id}Update team
  • POST/api/v1/teams/{id}/membersAdd member to team
  • DELETE/api/v1/teams/{id}/members/{memberId}Remove member from team
  • GET/api/v1/teams/{id}/permissionsList team permissions
  • PUT/api/v1/teams/{id}/permissionsBulk upsert team permissions
  • GET/api/v1/quick-answersList quick replies
  • GET/api/v1/quick-answers/{id}Quick reply detail
  • GET/api/v1/templatesList WhatsApp templates
  • GET/api/v1/templates/{id}WhatsApp template detail
  • GET/api/v1/usersList users
  • GET/api/v1/users/{id}User detail
  • PUT/api/v1/users/{id}Update user profile
  • GET/api/v1/users/meCurrent user profile

Cópia da especificação em 16/10/2026. Conferimos antes de cada publicação.

Perguntas

Posso testar sem escrever código?

Sim. A página da API permite executar as chamadas com o seu token antes de programar.

Como são os erros?

Seguem o padrão RFC 7807, com tipo, título e detalhe em JSON.

Tem conector pronto para o meu sistema?

Não temos conector pronto para ERPs e CRMs de terceiros. A API e os webhooks existem para você ou um parceiro construir, ou podemos avaliar um projeto sob medida.

Veja também

  • No arWebhooks

    Avisos do Chatsac para o seu sistema quando algo acontece.

  • No arn8n, Zapier e Make

    Conecte por requisição HTTP e webhook. Não há app oficial nos catálogos.

  • Sob medidaIntegração sob medida

    Seu sistema não está na lista? Avaliamos como projeto.

Todas as integrações