Modelo GraphQL

Modelo de Backend para App de CRM
GraphQL — Guia de Schema, API e IA

Um schema de backend de GraphQL CRM pronto para produção e Starter Kit na Back4app: Contato, Empresa, Negócio, Atividade, estágios do pipeline, diagrama ER, dicionário de dados, schema JSON, playground de API e um prompt de Agente de IA com um clique para implantar em minutos.

Principais Conclusões

Nesta página você obtém um schema de CRM pronto para produção, um prompt de IA com um clique e código GraphQL passo a passo — para que você possa lançar um app de CRM sem construir o backend.

  1. Implante em minutosCole o prompt do Agente de IA e obtenha um aplicativo em funcionamento com contatos, empresas, negócios e pipeline.
  2. Seguro por padrãoACLs e acesso baseado em funções para que os usuários vejam apenas seus negócios e dados atribuídos.
  3. GraphQL-nativo SDKObjetos tipados, async/await, fixação offline e Live Queries para atualizações de pipeline.
  4. REST + GraphQLAmbas as APIs geradas automaticamente; filtre negócios por estágio, liste atividades por relacionado a.
  5. Cinco classes_Usuário (embutido), Empresa, Contato, Negócio (pipeline), Atividade (tarefas/eventos).

O que é o template de backend do aplicativo CRM GraphQL?

Back4app é um backend como serviço (BaaS) ideal para aplicativos CRM: banco de dados gerenciado, sincronização em tempo real, acesso baseado em funções e SDKs para mais de 13 tecnologias. O template de backend do aplicativo CRM é um esquema de backend pré-construído e pronto para produção no Back4app. Ele oferece cinco classes (_User, Company, Contact, Deal, Activity), estágios de pipeline, APIs REST e GraphQL, e um prompt de agente de IA com um clique — para que você possa conectar um frontend GraphQL e enviar um aplicativo CRM funcional em minutos em vez de dias. Escolha sua tecnologia abaixo para integração passo a passo do SDK.

Melhor para:

Equipes de vendasConstrutores de CRMPrototipagem rápidaRepresentantes de campoLançamentos de MVPEquipes escolhendo um BaaS para CRM

Visão Geral

Back4app expõe seu esquema de CRM sobre GraphQL: consulte contatos, negócios (com onde: { stage }) e atividades; mutações com createDeal, updateDeal, createContact, createActivity. Um endpoint, esquema tipado e autenticação baseada em sessão.

As mesmas cinco classes — _User, Company, Contact, Deal, Activity — suportam tanto REST quanto GraphQL. Use seu cliente GraphQL favorito (Apollo, urql) para solicitar apenas os campos que você precisa e mantenha o pipeline e as listas de contatos em sincronia.

Recursos principais do CRM

GraphQL API CRM com tipos de Contato, Empresa, Negócio e Atividade. Consultas e mutações para gerenciamento de pipeline, ACLs e rastreamento de atividades — sem cola REST.

Gerenciamento de contatos

Armazene e gerencie contatos com nome, e-mail, telefone, empresa e notas. Ideal para aplicativos GraphQL.

Gestão de empresas

Rastreie empresas com nome, site, setor e endereço. Links para contatos e negócios.

Pipeline de negócios

Pipeline de vendas com etapas, valor, data de fechamento esperada e atribuição. Construído para backends GraphQL.

Rastreamento de atividades

Registre chamadas, e-mails, reuniões e notas vinculadas a contatos e negócios. Funciona com o SDK GraphQL.

Usuário e permissões

Modelo de usuário embutido e referências para propriedade e atribuição. ACLs prontas para uso para GraphQL.

Por que construir sua API de CRM GraphQL com Back4app?

Back4app fornece um endpoint GraphQL para que você possa consultar e modificar Contato, Empresa, Negócio e Atividade com um único endpoint.

  • Endpoint único: POST para o endpoint GraphQL com consultas e mutações; solicite apenas os campos que você precisa.
  • Esquema tipado: Os tipos de Contato, Empresa, Negócio e Atividade são gerados a partir do seu esquema Back4app; use-os em seu cliente para solicitações seguras em tipo.
  • Pipeline e atividades: Consultas de negócios por estágio e atividades relacionadas; mutações para atualizar o estágio do negócio e criar atividades.

Ideal para equipes que usam GraphQL clientes (Apollo, urql) para CRM ou painéis.

Benefícios Principais

Um backend CRM pronto para produção para que você possa enviar mais rápido e focar no seu aplicativo.

Envie Mais Rápido, Sem Código de Backend

APIs REST & GraphQL e um esquema pronto para uso — conecte seu aplicativo e vá.

Seguro por Padrão

ACLs e permissões em nível de classe; restrição por assignedTo e createdBy.

Pipeline em Tempo Real

Live Queries sobre WebSockets para atualizações instantâneas de negócios e atividades.

Autenticação Integrada

Cadastro de usuário, login e gerenciamento de sessão prontos para uso.

Funciona Offline

O pinning local mantém contatos e negócios disponíveis offline e sincroniza quando você se reconecta.

Implante em Minutos

Use o Agente de IA para criar e implantar seu aplicativo CRM a partir deste modelo.

Pronto para experimentar?

Deixe o agente de IA da Back4app criar o backend do seu aplicativo CRM, conectar o frontend GraphQL e implantar — tudo a partir de um único comando.

Grátis para começar — 50 comandos de Agente de IA/mês, sem necessidade de cartão de crédito

Pilha Técnica

Tudo que alimenta este modelo de aplicativo CRM em um relance.

Frontend
GraphQL
Backend
Back4app
Banco de Dados
MongoDB
Autenticação
Autenticação e Controle de Acesso
APIs
REST e GraphQL
Implantação
Agente de IA / Painel

Diagrama ER

Diagrama de Entidade-Relacionamento para o modelo de dados do aplicativo GraphQL CRM.

Ver fonte do diagrama
Mermaid
erDiagram
    _User {
        String objectId PK
        String username
        String email
        String password
        Date createdAt
        Date updatedAt
    }

    Company {
        String objectId PK
        String name
        String website
        String industry
        String address
        String notes
        Pointer createdBy FK
        Date createdAt
        Date updatedAt
    }

    Contact {
        String objectId PK
        String name
        String email
        String phone
        Pointer company FK
        String notes
        Pointer createdBy FK
        Date createdAt
        Date updatedAt
    }

    Deal {
        String objectId PK
        String title
        Number amount
        String stage
        Pointer contact FK
        Pointer company FK
        Date expectedCloseDate
        String notes
        Pointer assignedTo FK
        Date createdAt
        Date updatedAt
    }

    Activity {
        String objectId PK
        String type
        String subject
        String description
        Date dueDate
        Date completedAt
        Pointer relatedTo FK
        Pointer createdBy FK
        Date createdAt
        Date updatedAt
    }

    Company ||--o{ Contact : "has"
    Company ||--o{ Deal : "has"
    Contact ||--o{ Deal : "has"
    _User ||--o{ Deal : "assignedTo"
    _User ||--o{ Activity : "createdBy"
    Contact ||--o{ Activity : "relatedTo"
    Deal ||--o{ Activity : "relatedTo"
    _User ||--o{ Company : "createdBy"
    _User ||--o{ Contact : "createdBy"

Fluxo de Integração

Sequência Auth-to-CRUD: como seu aplicativo GraphQL se comunica com Back4app — login, depois consulta contatos e negócios, atualiza o pipeline.

Ver fonte do diagrama
Mermaid
sequenceDiagram
  participant User
  participant Client as GraphQL Client
  participant Back4app as Back4app Cloud

  User->>Client: Login
  Client->>Back4app: mutation { logIn(username, password) }
  Back4app-->>Client: Session token
  Client-->>User: Logged in

  User->>Client: Load contacts and deals
  Client->>Back4app: query { deals { edges { node { objectId title stage } } } }
  Back4app-->>Client: Deal list
  Client-->>User: Show pipeline

  User->>Client: Create deal or contact
  Client->>Back4app: mutation { createDeal(input: { ... }) }
  Back4app-->>Client: Deal (objectId)
  Client-->>User: Updated list

Dicionário de Dados

Referência completa de campos para cada classe no esquema.

CampoTipoDescriçãoObrigatório
objectIdStringAuto-generated unique identifierautomático
nameStringFull name of the contact
emailStringEmail address
phoneStringPhone number
companyPointer<Company>Company this contact belongs to
notesStringFree-form notes
createdByPointer<_User>User who created this contact
createdAtDateAuto-generated creation timestampautomático
updatedAtDateAuto-generated last-update timestampautomático

9 campos em Contact

Segurança e Permissões

Como a propriedade, ACLs e permissões em nível de classe protegem os dados neste esquema de CRM.

ACLs em Nível de Linha

Use ACLs e ponteiros (assignedTo, createdBy) para que os usuários vejam e editem apenas seus negócios atribuídos e dados relacionados.

Permissões em Nível de Classe

CLPs restringem quais funções ou usuários podem criar, ler, atualizar ou excluir objetos em nível de classe.

Propriedade Baseada em Ponteiro

Deal.assignedTo e Activity.createdBy vinculam-se a _User; o Cloud Code pode impor visibilidade e edições por função.

Esquema (JSON)

Definição de esquema JSON bruto — copie e use em seu aplicativo Back4app ou importe via API.

JSON
{
  "classes": [
    {
      "className": "Contact",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "name": {
          "type": "String",
          "required": true
        },
        "email": {
          "type": "String",
          "required": false
        },
        "phone": {
          "type": "String",
          "required": false
        },
        "company": {
          "type": "Pointer",
          "targetClass": "Company",
          "required": false
        },
        "notes": {
          "type": "String",
          "required": false
        },
        "createdBy": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "Company",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "name": {
          "type": "String",
          "required": true
        },
        "website": {
          "type": "String",
          "required": false
        },
        "industry": {
          "type": "String",
          "required": false
        },
        "address": {
          "type": "String",
          "required": false
        },
        "notes": {
          "type": "String",
          "required": false
        },
        "createdBy": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "Deal",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "title": {
          "type": "String",
          "required": true
        },
        "amount": {
          "type": "Number",
          "required": false
        },
        "stage": {
          "type": "String",
          "required": false
        },
        "contact": {
          "type": "Pointer",
          "targetClass": "Contact",
          "required": false
        },
        "company": {
          "type": "Pointer",
          "targetClass": "Company",
          "required": false
        },
        "expectedCloseDate": {
          "type": "Date",
          "required": false
        },
        "notes": {
          "type": "String",
          "required": false
        },
        "assignedTo": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "Activity",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "type": {
          "type": "String",
          "required": false
        },
        "subject": {
          "type": "String",
          "required": false
        },
        "description": {
          "type": "String",
          "required": false
        },
        "dueDate": {
          "type": "Date",
          "required": false
        },
        "completedAt": {
          "type": "Date",
          "required": false
        },
        "relatedTo": {
          "type": "Pointer",
          "required": false
        },
        "createdBy": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "_User",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "username": {
          "type": "String",
          "required": true
        },
        "email": {
          "type": "String",
          "required": true
        },
        "password": {
          "type": "String",
          "required": true
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    }
  ]
}

Construa com o Agente de IA

Use o Agente de IA Back4app para construir um aplicativo CRM real a partir deste modelo: ele criará o frontend, o backend (este esquema, autenticação e APIs) e fará a implantação — sem configuração manual. O prompt abaixo descreve esta pilha de CRM para que o Agente possa gerar um aplicativo pronto para produção de uma só vez.

Agente de IA Back4app
Pronto para construir
Crie um aplicativo CRM no Back4app com este esquema e comportamento exatos.

Esquema:
1. _Usuário (use Back4app embutido): nome de usuário (String, obrigatório), email (String, obrigatório), senha (String, obrigatório); objectId, createdAt, updatedAt (sistema).
2. Empresa: nome (String, obrigatório), site (String), setor (String), endereço (String), notas (String), criadoPor (Ponteiro para _Usuário); objectId, createdAt, updatedAt (sistema).
3. Contato: nome (String, obrigatório), email (String), telefone (String), empresa (Ponteiro para Empresa), notas (String), criadoPor (Ponteiro para _Usuário); objectId, createdAt, updatedAt (sistema).
4. Negócio: título (String, obrigatório), valor (Número), estágio (String; por exemplo, lead, qualificado, proposta, negociação, ganho, perdido), contato (Ponteiro para Contato), empresa (Ponteiro para Empresa), dataFechamentoEsperada (Data), notas (String), atribuídoA (Ponteiro para _Usuário); objectId, createdAt, updatedAt (sistema).
5. Atividade: tipo (String; por exemplo, chamada, email, reunião, nota), assunto (String), descrição (String), dataVencimento (Data), concluídoEm (Data), relacionadoA (Ponteiro para Contato ou Negócio), criadoPor (Ponteiro para _Usuário); objectId, createdAt, updatedAt (sistema).

Segurança:
- Defina ACLs para que apenas usuários autenticados possam acessar os dados; use regras baseadas em função ou baseadas em proprietário onde apropriado (por exemplo, atribuídoA, criadoPor).
- Use Permissões em Nível de Classe para que apenas usuários autenticados possam criar/ler/atualizar/excluir essas classes.

Autenticação:
- Cadastro (nome de usuário, email, senha) e login; suporte para logout/sessão.

Comportamento:
- CRUD completo para Empresa, Contato, Negócio e Atividade.
- Liste negócios com filtro por estágio e ordene por dataFechamentoEsperada ou updatedAt (visualização de pipeline).
- Liste atividades por relacionadoA (Contato ou Negócio).
- Opcional: Live Queries em tempo real para Negócio e Atividade para atualizações de painel/pipeline.
- Opcional: fixação offline para mobile (Contatos, Negócios, Atividades).

Entregar:
- Crie o aplicativo Back4app com o esquema acima, ACLs e qualquer Cloud Code necessário.
- Gere o frontend e conecte-o a este backend; implante para que o aplicativo seja executável de ponta a ponta.

Pressione o botão abaixo para abrir o Agente com o prompt deste modelo pré-preenchido.

Implantar em minutos50 prompts gratuitos / mêsNenhum cartão de crédito necessário

API Playground

Experimente os endpoints REST e GraphQL para o esquema CRM. Respostas dos dados de exemplo acima — nenhuma conta Back4app necessária.

Carregando playground…

Usa o mesmo esquema CRM (Contato, Empresa, Negócio, Atividade) que este modelo.

Integração GraphQL Passo a Passo

Conecte-se ao seu backend Back4app a partir de um app GraphQL usando o SDK Back4app GraphQL.

  1. Consultar contatos e negócios

    Enviar uma consulta GraphQL para buscar contatos ou negócios (com token de sessão nos cabeçalhos).

    GraphQL
    query GetDeals {
      deals {
        edges {
          node {
            objectId
            title
            done
            dueDate
            priority
            createdAt
          }
        }
      }
    }
  2. Criar um negócio

    Usar a mutação createDeal com variáveis para título, estágio, valor e contato/empresa relacionado.

    GraphQL
    mutation CreateDeal($title: String!, $stage: String, $amount: Float) {
      createDeal(input: {
        fields: {
          title: $title
          stage: $stage
          amount: $amount
        }
      }) {
        deal {
          objectId
          title
          stage
          amount
          createdAt
        }
      }
    }
    
    mutation CreateContact($name: String!, $email: String, $phone: String) {
      createContact(input: {
        fields: { name: $name email: $email phone: $phone }
      }) {
        contact { objectId name createdAt }
      }
    }
  3. Atualizar e excluir

    Mutações UpdateDeal e DeleteDeal com objectId.

    GraphQL
    mutation UpdateDeal($objectId: ID!, $stage: String) {
      updateDeal(input: {
        objectId: $objectId
        fields: { stage: $stage }
      }) {
        deal { objectId stage }
      }
    }
    
    mutation DeleteDeal($objectId: ID!) {
      deleteDeal(input: { objectId: $objectId }) { success }
    }

Perguntas Frequentes

Perguntas comuns sobre o modelo de backend do aplicativo CRM.

O que é Back4app?
Por que usar Back4app para uma API de CRM GraphQL?
Como consulto negócios por estágio em GraphQL?
Como atualizo o estágio de um negócio via GraphQL?

Confiado por desenvolvedores em todo o mundo

Junte-se à comunidade que está construindo o futuro dos aplicativos

G2 Users Love Us Badge

Pronto para Construir Seu App de CRM?

Comece seu projeto GraphQL em minutos. Nenhum cartão de crédito necessário.

Construa com Agente de IA