API & Integrações

Referência da API Webhooks

API — Parcelamento e recorrência de faturas (cartão Asaas suportado)

Parcelamento no CARTÃO DE CRÉDITO é suportado na API via asaas_installment_count (1–12) com gateway Asaas habilitado. Já o carnê (parcelar boleto) e as faturas recorrentes NÃO são suportados via API — use a interface web ou crie várias faturas com vencimentos diferentes.

API — Webhooks (outbound) e payloads de automação

Receba eventos do CRM em tempo real: cadastro e gestão de webhooks, lista de eventos, verificação de assinatura HMAC SHA-256, auto-desativação por falhas e payload completo das automações.

API — WhatsApp Connector (/wa-connector)

Endpoints para sistemas externos consumirem canais e templates do WhatsApp Oficial (Meta Cloud API) do tenant e dispararem templates aprovados, sem armazenar credenciais fora do 360.

API — Agendamentos / Agenda (/appointments)

CRUD de compromissos da agenda: reuniões, ligações, tarefas e eventos, com vínculo a contato, negócio e responsável, controle de status e integração com Google Meet.

API — Códigos de erro e troubleshooting

Referência dos códigos HTTP retornados pela API, formato dos erros (incluindo o objeto errors do 422) e causas comuns: token inválido, addon/licença, rate limit e isolamento por tenant.

API — Contatos (/contacts)

CRUD completo de contatos via API: listar com filtros, criar, atualizar, excluir, buscar por telefone e listar negócios e conversas do contato. Inclui todos os parâmetros e o formato da resposta.

API — Conversas e Mensagens (Chat / WhatsApp)

Listar e atualizar conversas, ler o histórico de mensagens e enviar mensagens (texto e mídia) por conversa ou por telefone. O padrão recomendado para responder a webhooks é usar conversation_id.

API — Faturas e Pagamentos (/invoices)

Criar e gerenciar faturas: itens, ESCOLHA de gateway (payment_gateway_id / enabled_gateways), PARCELAMENTO no cartão via Asaas (asaas_installment_count 1–12), descobrir gateways em GET /payment-gateways e registrar pagamentos. Carnê e faturas recorrentes não são suportados via API.

API — Produtos e Serviços (/products)

Catálogo de produtos e serviços via API: criar, listar com filtros, controlar estoque, preço, custo, impostos, categoria, imagens e variações.

API — Propostas (/proposals)

Criar e gerenciar propostas comerciais com itens (inclusive opcionais), vincular a contato e negócio, controlar status e acompanhar datas de envio, visualização, aceite e assinatura.

API REST — Visão geral, autenticação e convenções

Ponto de partida para integrar com a API REST do Contrate 360: base URL, autenticação por Bearer Token (Sanctum), pré-requisitos de licença e addon, rate limit, paginação e padrões de resposta.