Chame seu CRM do seu próprio código
A API do Builder é HTTPS simples e JSON em mcp.workspace369.com/v1, autenticada com um token de acesso pessoal. POST /v1/tools/{name} executa qualquer ferramenta MCP que os escopos do seu token permitam, e atalhos REST cobrem clientes, propostas, faturas, contratos, projetos, tarefas, solicitações e eventos de calendário. Sua especificação OpenAPI é pública em /v1/openapi.json. Webhooks enviam 27 eventos para seu endpoint, assinados com HMAC-SHA256. Ambos vêm com todos os planos a partir de Cadet; uma avaliação obtém acesso assim que um cartão é salvo.
Teste grátis de 14 dias. Cartão necessário. Após o teste: a partir de US$ 29/mês. Renova automaticamente todo mês até você cancelar. Cancele a qualquer momento em Configurações → Cobrança.
Solicitar uma demonstraçãoTodos os planos a partir de Cadet; um teste obtém acesso assim que um cartão é salvo.
- 01
- 8 recursos com 32 operações, mais POST /v1/tools/{name} para qualquer ferramenta MCP que os escopos do seu token permitam.
- 02
- O envio de uma fatura, proposta, contrato ou mensagem retorna 202 e aguarda aprovação na aplicação.
- 03
- 27 eventos de webhook assinados, com até 6 tentativas de entrega.
O que é uma API de CRM?
Uma API de CRM permite que seu próprio código leia e atualize registros de CRM pela internet em vez de pelo aplicativo. A API Builder do Workspace369 é HTTPS e JSON simples em mcp.workspace369.com/v1, autenticada com um token de acesso pessoal. POST /v1/tools/{name} executa qualquer ferramenta MCP que os escopos do seu token permitam, e atalhos REST cobrem clientes, propostas, faturas, contratos, projetos, tarefas, solicitações e eventos de calendário. O envio de uma fatura, proposta, contrato ou mensagem retorna um 202 e aguarda aprovação no aplicativo Workspace369, a menos que o token esteja configurado para Enviar sem perguntar. Webhooks assinados enviam 27 eventos para seu endpoint quando o trabalho muda.
Revisado em 4 de novembro de 2026 pela Equipe de Produto do Workspace369. A disponibilidade pode variar por plano, região e configuração do espaço de trabalho.
Ler a documentação da API do BuilderHTTP simples, respostas reais, recusas claras.
Cada ferramenta é uma chamada HTTP: POST /v1/tools/{name} executa qualquer ferramenta MCP que os escopos do seu token permitam, e atalhos REST cobrem clientes, propostas, faturas, contratos, projetos, tarefas, solicitações e eventos de calendário. Escolha uma chamada para ver o que retorna.
- Autenticar com um token de acesso pessoal: Authorization: Bearer mcp_pat_…
- 8 recursos com 32 operações, mais POST /v1/tools/{name} para qualquer ferramenta MCP que os escopos do seu token permitam
- Uma forma de erro para cada recusa, com um código no qual seu código pode ramificar
Solicitação
GET /v1/clients?query=acme&limit=5
Authorization: Bearer mcp_pat_••••
Resposta
200 OK
{
"clients": [
{ "id": "cl_93Fa", "name": "Acme Co",
"email": "billing@acme.test", "lifecycle_stage": "client" }
]
}Leituras retornam diretamente. Página de resultados com um cursor.
Uma forma de erro, códigos nos quais você pode ramificar.
Cada recusa retorna { "error": { "code", "message", "details" } } com um status que seu código pode agir.
| Código | Status | O que significa |
|---|---|---|
| unauthorized | 401 | O token de acesso pessoal está ausente ou é inválido. |
| usage_exhausted | 402 | O espaço de trabalho usou seu uso mensal de IA. Recarregue e tente novamente. |
| plan_required | 403 | O espaço de trabalho ainda não tem plano. A resposta carrega um link de upgrade. |
| insufficient_scope | 403 | O token não possui um escopo. details.required_scope o nomeia. |
| payload_too_large | 413 | O corpo da solicitação excede 1 MB. |
| rate_limited | 429 | Acima do limite. Aguarde o cabeçalho Retry-After e tente novamente. |
Escolha os eventos. Verifique cada entrega.
Em Configurações, em Dados, escolha Webhooks e Novo webhook, selecione entre 27 eventos e copie o segredo de assinatura uma vez. Cada entrega é um POST JSON assinado.
- Assinado
- X-Webhook-Signature é um HMAC-SHA256 do corpo bruto mais X-Webhook-Timestamp, feito com seu segredo de assinatura. Rotacione o segredo a qualquer momento.
- Tentado novamente
- Responda com um 2xx em até 10 segundos. Caso contrário, a entrega é retentada até mais 5 vezes, totalizando 6 tentativas, com o mesmo X-Webhook-Id. As entregas são registradas por 30 dias.
- Seguro para repetir
- As entregas podem chegar fora de ordem ou mais de uma vez, então ignore qualquer X-Webhook-Id que você já tenha processado. As entregas de Webhook não usam nenhum uso de IA.
O que seu endpoint recebe
Escolha os eventos que você precisa.
27 eventos vêm em 8 famílias. Assine os que você precisa, até 50 webhooks por espaço de trabalho. O gerenciamento de webhooks requer a permissão Gerenciar webhooks.
| Família | Eventos |
|---|---|
| Registros de tempo | time_entry.created, time_entry.updated, time_entry.deleted |
| Folhas de ponto | timesheet.submitted, timesheet.approved, timesheet.rejected |
| Faturas | invoice.created, invoice.paid, invoice.status_changed |
| Propostas | proposal.sent, proposal.accepted, proposal.declined |
| Contratos | contract.sent, contract.recipient_completed, contract.completed, contract.declined, contract.voided, contract.expired |
| Agendamentos | booking.created, booking.rescheduled, booking.cancelled, booking.no_show |
| Solicitações | lead.created, lead.converted, lead.archived |
| Clientes | client.created, client.stage_changed |
Enviar e-mail a partir de código e conectar as suas ferramentas de automação.
A API de E-mail é um endpoint somente de envio com sua própria chave de workspace. O aplicativo Workspace369 para Zapier (beta; participe com o link de convite na página do Zapier) inicia Zaps a partir deles, e Make e n8n escutam os mesmos webhooks assinados.
- API de E-mailPOST /v1/email/messages envia e-mail transacional com uma chave de espaço de trabalho, separada de seus tokens de acesso pessoal.
- Zapier, Make e n8nParticipe do aplicativo Workspace369 para Zapier (beta) com o link de convite, ou inicie automações Zapier, Make e n8n a partir dos webhooks assinados acima e chame a API do Builder de suas etapas HTTP.
- Ligar do seu servidorUma demonstração de como chamar o Workspace369 de seu próprio servidor e redigir faturas.
Tokens com limites que você escolhe, e nada oculto.
Assim que um administrador ativar as conexões de IA, você poderá criar um token de acesso pessoal em Configurações, em IA. Ele carrega apenas os escopos e a expiração que eles escolhem, e o espaço de trabalho pode vê-lo e pará-lo.
- Nunca mais que seu criador
- Cada chamada é verificada ao vivo contra a função do membro, para que um token não possa fazer o que seu criador não pode.
- Cada chamada é registrada
- O registro de chamadas grava o aplicativo, membro, ferramenta, escopo, resultado e uso de IA. Ele mantém os nomes dos campos, nunca os valores.
- Os administradores podem revogar qualquer token
- Os administradores do espaço de trabalho veem os tokens de cada membro. Um token revogado para de funcionar imediatamente.
- Um ritmo constante
- Até 120 chamadas por minuto por token e 600 por espaço de trabalho, compartilhado com MCP, com um corpo de solicitação de 1 MB. Acima do limite, você recebe um 429 com Retry-After.
A API e os webhooks em todos os planos, a partir de Cadet.
A API do Builder em mcp.workspace369.com/v1 e webhooks assinados vêm com todos os planos a partir de Cadet. Uma avaliação obtém acesso assim que um cartão é salvo. Cada chamada bem-sucedida usa o mesmo uso de IA que a chamada MCP correspondente.
Comparar planos- ferramentas no servidor
- 127
- eventos de webhook
- 27
- chamadas por minuto por token
- 120
| Planos | Cadet$29/mês | Voyager$74/mês | Specialist$149/mês | Commander$299/mês | Enterprise$699/mês | |
|---|---|---|---|---|---|---|
| API Builder | Todo plano | Incluído | Incluído | Incluído | Incluído | Incluído |
| Webhooks | Todo plano | Incluído | Incluído | Incluído | Incluído | Incluído |
| Conexões de IA (MCP) | Todo plano | Incluído | Incluído | Incluído | Incluído | Incluído |
Chamadas falhadas ou recusadas não usam IA.
Perguntas sobre a API Builder e Webhooks
Quais planos incluem a API do Construtor?
Todos os planos a partir de Cadet, e um teste gratuito obtém acesso assim que um cartão é salvo em Faturamento. Um proprietário ou administrador deve ter ativado Permitir conexões de IA em Configurações, em IA. Webhooks vêm com todos os planos a partir de Cadet também.#
O teste gratuito inclui a API?
Sim, assim que um cartão for salvo. O teste de 14 dias terá então a API Builder e webhooks como qualquer plano.#
Como autentico?
Crie um token de acesso pessoal em Configurações, em IA, com Criar token. Escolha suas permissões e expiração (30 dias, 90 dias, 1 ano ou nenhuma), copie-o uma vez e envie-o como Authorization: Bearer mcp_pat_... em cada solicitação. Cada chamada é verificada contra as permissões ativas do membro que a criou, bem como os escopos do token.#
Onde está a especificação OpenAPI?
É público, sem necessidade de token, em /v1/openapi.json no mesmo host. É construído a partir do registro de ferramentas ao vivo, portanto, corresponde ao que o servidor aceita.#
Como verifico um webhook?
Cada entrega carrega X-Webhook-Signature, X-Webhook-Timestamp e X-Webhook-Id. A assinatura é um HMAC-SHA256 hexadecimal do corpo bruto da solicitação seguido pelo timestamp, feito com seu segredo de assinatura. Responda com um 2xx em até 10 segundos; entregas falhas são retentadas até mais 5 vezes, e X-Webhook-Id permanece o mesmo em cada retentativa.#
As chamadas de API usam uso de IA?
Sim. Cada chamada bem-sucedida usa o mesmo uso de IA da chamada MCP correspondente, da cota mensal do plano. Chamadas falhas ou recusadas não consomem nada, e entregas de webhook não consomem nada.#
Devo usar a API ou o MCP?
Use a Builder API quando seu próprio código ou um script fizer as chamadas. Use o servidor MCP quando um aplicativo de IA como Claude ou ChatGPT as fizer. Ambos executam as mesmas ferramentas com as mesmas permissões, aprovações, limites de taxa e log de auditoria.#
Aponte seu código para um espaço de trabalho onde os envios aguardam um sim por padrão.
Inicie um teste, guarde um cartão, crie um token de acesso pessoal nas Definições e faça a sua primeira chamada.
Teste grátis de 14 dias. Cartão necessário. Após o teste: a partir de US$ 29/mês. Renova automaticamente todo mês até você cancelar. Cancele a qualquer momento em Configurações → Cobrança.
Ver preços14 dias grátis · cartão necessário · depois US$ 29/mês · cancele a qualquer momento