API de Projetos e Quadros
Como criar quadros, colunas, grupos e itens do módulo de Projetos do Omnifox via API.
Veja este passo no vídeo · CRM e calendário pela API
O módulo de Projetos (quadros estilo Monday) organiza o trabalho em quadros com grupos, colunas tipadas e itens. A API REST permite automatizar a criação de tarefas a partir de outros sistemas — por exemplo, criar um item quando chega um chamado ou uma oportunidade do CRM é ganha.
Requisitos
- O workspace precisa ter o recurso
projects_enabledhabilitado pelo plano; sem ele, os endpoints retornam403. - Token Bearer do workspace.
Endpoints principais
GET/POST /api/v1/boards— listar ou criar quadros.GET /api/v1/boards/column-types— tipos de coluna disponíveis (texto, status, pessoa, data, número etc.).POST /api/v1/boards/{board}/groups— criar um grupo (seção) dentro do quadro.POST /api/v1/boards/{board}/columns— adicionar uma coluna.POST /api/v1/boards/{board}/items— criar um item (tarefa).PUT /api/v1/boards/items/{item}/columns/{column}— atualizar o valor de uma coluna em um item.PATCH /api/v1/boards/items/{item}/move— mover um item entre grupos.POST /api/v1/boards/items/{item}/subitems— criar subitens.
Exemplo: criar um item em um quadro
curl -X POST "https://app.omnifox.io/api/v1/boards/8/items" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Preparar proposta comercial",
"group_id": 22,
"contact_id": 55
}'
Um item pode ter contact_id e/ou deal_id para vinculá-lo a um contato ou a uma oportunidade do CRM.
Dicas
- Chame
GET /api/v1/boards/{board}/viewpara trazer o quadro inteiro (grupos, colunas e itens) em uma única chamada — ideal para dashboards externos. - As automações do quadro (
/api/v1/boards/{board}/automations) podem criar ou mover itens sozinhas quando um evento ocorre; confira o catálogo comGET .../automations/catalogantes de montar uma regra nova.
Solução de problemas
- 403 em
/boards/*: o plano do workspace não inclui Projetos. - A coluna não aceita o valor enviado: cada tipo de coluna (status, pessoa, data…) espera um formato diferente; consulte
GET /api/v1/boards/column-typespara ver o esquema exato. - O item não muda de grupo: use
PATCH .../move(nãoPUT) e inclua ogroup_idde destino.
Artigos relacionados
-
Como conectar integrações e apps externos
Conecte o Omnifox às suas ferramentas favoritas a partir do catálogo de integrações em poucos passos.
-
Integrar o Omnifox com Azur, Siigo, Alegra, QuickBooks ou outro sistema contábil ou ERP
O Omnifox não tem hoje um conector nativo com sistemas contábeis ou ERP. Veja como fazer essa conexão mesmo assim com fluxos de trabalho, o nó HTTP, n8n, Make, Zapier ou a API, com exemplos.
-
Guia completo de integrações e API
Integrações e API a fundo, em 30 capítulos: chaves de API, chamadas reais, webhooks assinados, n8n, MCP e SDKs, tudo funcionando de verdade.
-
Gerar e usar API keys e webhooks
Crie chaves de API para acessar o Omnifox por código e configure webhooks para receber eventos em tempo real.
-
Introdução às integrações (webhook / OAuth / chave de API)
Conecte o Omnifox às suas outras ferramentas: o que está disponível hoje, o que chega em breve e quando usar um webhook, uma conexão OAuth ou uma chave de API.