Plantilla GraphQL

Plantilla de Backend para la App CRM
GraphQL — Guía de Esquema, API y AI

Un esquema de backend de GraphQL CRM listo para producción y un Kit de Inicio en Back4app: Contacto, Empresa, Negocio, Actividad, etapas del pipeline, diagrama ER, diccionario de datos, esquema JSON, playground de API, y un prompt de Agente de AI con un clic para desplegar en minutos.

Puntos Clave

En esta página obtienes un esquema de CRM listo para producción, un prompt de AI con un clic, y código GraphQL paso a paso — para que puedas lanzar una app CRM sin construir el backend.

  1. Despliega en minutosPega el aviso del Agente de IA y obtén una aplicación en funcionamiento con contactos, empresas, ofertas y pipeline.
  2. Seguro por defectoACLs y acceso basado en roles para que los usuarios vean solo sus ofertas y datos asignados.
  3. GraphQL-SDK nativoObjetos tipados, async/await, fijación offline y Live Queries para actualizaciones de pipeline.
  4. REST + GraphQLAmbas APIs generadas automáticamente; filtra ofertas por etapa, lista actividades por relacionado con.
  5. Cinco clases_Usuario (incorporado), Empresa, Contacto, Oferta (pipeline), Actividad (tareas/eventos).

¿Qué es la plantilla de backend de la aplicación CRM GraphQL?

Back4app es un backend como servicio (BaaS) ideal para aplicaciones CRM: base de datos gestionada, sincronización en tiempo real, acceso basado en roles y SDKs para más de 13 tecnologías. La plantilla de backend de la aplicación CRM es un esquema de backend preconstruido y listo para producción en Back4app. Te proporciona cinco clases (_User, Company, Contact, Deal, Activity), etapas de pipeline, APIs REST y GraphQL, y un aviso de agente de IA con un solo clic, para que puedas conectar un frontend GraphQL y lanzar una aplicación CRM funcional en minutos en lugar de días. Elige tu tecnología a continuación para la integración del SDK paso a paso.

Mejor para:

Equipos de ventasCreadores de CRMPrototipado rápidoRepresentantes de campoLanzamientos de MVPEquipos eligiendo un BaaS para CRM

Descripción general

Back4app expone tu esquema CRM a través de GraphQL: consulta contactos, ofertas (con where: { stage }) y actividades; muta con createDeal, updateDeal, createContact, createActivity. Un endpoint, esquema tipado y autenticación basada en sesión.

Las mismas cinco clases — _User, Company, Contact, Deal, Activity — respaldan tanto REST como GraphQL. Usa tu cliente GraphQL favorito (Apollo, urql) para solicitar solo los campos que necesitas y mantener la lista de contactos y el pipeline sincronizados.

Características principales del CRM

API de CRM GraphQL con tipos de Contacto, Empresa, Negocio y Actividad. Consultas y mutaciones para gestión de pipeline, ACLs y seguimiento de actividades — sin pegamento REST.

Gestión de contactos

Almacena y gestiona contactos con nombre, correo electrónico, teléfono, empresa y notas. Ideal para aplicaciones GraphQL.

Gestión de empresas

Rastrea empresas con nombre, sitio web, industria y dirección. Enlaces a contactos y ofertas.

Tubería de ofertas

Tubería de ventas con etapas, monto, fecha de cierre esperada y asignación. Construido para backends de GraphQL.

Seguimiento de actividades

Registra llamadas, correos electrónicos, reuniones y notas vinculadas a contactos y negocios. Funciona con el SDK de GraphQL.

Usuario y permisos

Modelo de usuario integrado y punteros para propiedad y asignación. ACLs listos para usar para GraphQL.

¿Por qué construir tu API de CRM GraphQL con Back4app?

Back4app proporciona un endpoint GraphQL para que puedas consultar y mutar Contacto, Empresa, Oferta y Actividad con un solo endpoint.

  • Endpoint único: POST al endpoint GraphQL con consultas y mutaciones; solicita solo los campos que necesitas.
  • Esquema tipado: Los tipos de Contacto, Empresa, Oferta y Actividad se generan a partir de tu esquema Back4app; úsalos en tu cliente para solicitudes seguras en tipos.
  • Canal y actividades: Consulta ofertas por etapa y actividades por relacionado a; mutaciones para actualizar la etapa de la oferta y crear actividades.

Ideal para equipos que utilizan clientes de GraphQL (Apollo, urql) para CRM o paneles de control.

Beneficios principales

Un backend CRM listo para producción para que puedas enviar más rápido y concentrarte en tu aplicación.

Envía más rápido, sin código de backend

APIs REST y GraphQL y un esquema listo para usar — conecta tu aplicación y listo.

Seguro por defecto

ACLs y permisos a nivel de clase; restringir por assignedTo y createdBy.

Pipeline en Tiempo Real

Live Queries sobre WebSockets para actualizaciones instantáneas de ofertas y actividades.

Autenticación Integrada

Registro de usuario, inicio de sesión y manejo de sesiones listos para usar.

Funciona Sin Conexión

El anclaje local mantiene contactos y ofertas disponibles sin conexión y se sincroniza cuando te reconectas.

Despliega en Minutos

Usa el Agente de IA para crear y desplegar tu aplicación CRM a partir de esta plantilla.

¿Listo para probarlo?

Deja que el agente de IA de Back4app cree el backend de tu aplicación CRM, conecte el frontend GraphQL y despliegue — todo desde un solo aviso.

Gratis para comenzar — 50 avisos de agente de IA/mes, no se requiere tarjeta de crédito

Pila técnica

Todo lo que impulsa esta plantilla de aplicación CRM de un vistazo.

Frontend
GraphQL
Backend
Back4app
Base de datos
MongoDB
Autenticación
Autenticación y Control de Acceso
APIs
REST y GraphQL
Despliegue
Agente de IA / Panel de control

Diagrama ER

Diagrama de entidad-relación para el modelo de datos de la aplicación CRM GraphQL.

Ver fuente del 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"

Flujo de integración

Secuencia de Auth-to-CRUD: cómo tu aplicación GraphQL se comunica con Back4app — iniciar sesión, luego consultar contactos y negocios, actualizar el pipeline.

Ver fuente del 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

Diccionario de datos

Referencia completa de campos para cada clase en el esquema.

CampoTipoDescripciónRequerido
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 en Contact

Seguridad y permisos

Cómo la propiedad, ACLs y permisos a nivel de clase protegen los datos en este esquema de CRM.

ACLs a Nivel de Fila

Usa ACLs y punteros (assignedTo, createdBy) para que los usuarios solo vean y editen sus tratos asignados y datos relacionados.

Permisos a Nivel de Clase

Los CLPs restringen qué roles o usuarios pueden crear, leer, actualizar o eliminar objetos a nivel de clase.

Propiedad Basada en Punteros

Deal.assignedTo y Activity.createdBy se vinculan a _User; Cloud Code puede hacer cumplir la visibilidad y las ediciones por rol.

Esquema (JSON)

Definición de esquema JSON en bruto — copia y usa en tu aplicación Back4app o importa a través de la 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
        }
      }
    }
  ]
}

Construir con el Agente de IA

Utiliza el Agente de IA de Back4app para construir una aplicación CRM real a partir de esta plantilla: creará el frontend, el backend (este esquema, autenticación y APIs) y lo desplegará — sin configuración manual. El aviso a continuación describe esta pila CRM para que el Agente pueda generar una aplicación lista para producción de una sola vez.

Agente de IA Back4app
Listo para construir
Crea una aplicación CRM en Back4app con este esquema y comportamiento exactos.

Esquema:
1. _Usuario (usar Back4app incorporado): nombre de usuario (String, requerido), correo electrónico (String, requerido), contraseña (String, requerido); objectId, createdAt, updatedAt (sistema).
2. Empresa: nombre (String, requerido), sitio web (String), industria (String), dirección (String), notas (String), creadoPor (Puntero a _Usuario); objectId, createdAt, updatedAt (sistema).
3. Contacto: nombre (String, requerido), correo electrónico (String), teléfono (String), empresa (Puntero a Empresa), notas (String), creadoPor (Puntero a _Usuario); objectId, createdAt, updatedAt (sistema).
4. Negocio: título (String, requerido), monto (Número), etapa (String; por ejemplo, cliente potencial, calificado, propuesta, negociación, ganado, perdido), contacto (Puntero a Contacto), empresa (Puntero a Empresa), fechaEsperadaCierre (Fecha), notas (String), asignadoA (Puntero a _Usuario); objectId, createdAt, updatedAt (sistema).
5. Actividad: tipo (String; por ejemplo, llamada, correo electrónico, reunión, nota), asunto (String), descripción (String), fechaVencimiento (Fecha), completadoEn (Fecha), relacionadoCon (Puntero a Contacto o Negocio), creadoPor (Puntero a _Usuario); objectId, createdAt, updatedAt (sistema).

Seguridad:
- Establecer ACLs para que solo los usuarios autenticados puedan acceder a los datos; usar reglas basadas en roles o basadas en propietarios donde sea apropiado (por ejemplo, asignadoA, creadoPor).
- Usar Permisos a Nivel de Clase para que solo los usuarios autenticados puedan crear/leer/actualizar/eliminar estas clases.

Autenticación:
- Registro (nombre de usuario, correo electrónico, contraseña) e inicio de sesión; soporte para cerrar sesión/sesión.

Comportamiento:
- CRUD completo para Empresa, Contacto, Negocio y Actividad.
- Listar negocios con filtro por etapa y ordenar por fechaEsperadaCierre o updatedAt (vista de pipeline).
- Listar actividades por relacionadoCon (Contacto o Negocio).
- Opcional: Live Queries en tiempo real para Negocio y Actividad para actualizaciones de panel/pipeline.
- Opcional: fijación fuera de línea para móvil (Contactos, Negocios, Actividades).

Entregar:
- Crear la aplicación Back4app con el esquema anterior, ACLs y cualquier Código en la Nube necesario.
- Generar el frontend y conectarlo a este backend; desplegar para que la aplicación sea ejecutable de extremo a extremo.

Presiona el botón a continuación para abrir el Agente con el aviso de esta plantilla prellenado.

Desplegar en minutos50 mensajes gratuitos / mesNo se requiere tarjeta de crédito

API Playground

Prueba los endpoints REST y GraphQL para el esquema CRM. Respuestas de los datos de ejemplo anteriores — no se necesita cuenta de Back4app.

Cargando espacio de trabajo…

Utiliza el mismo esquema CRM (Contacto, Empresa, Negocio, Actividad) que esta plantilla.

Integración paso a paso GraphQL

Conéctate a tu backend de Back4app desde una app GraphQL utilizando el SDK Back4app GraphQL.

  1. Consultar contactos y negocios

    Enviar una consulta de GraphQL para obtener contactos o negocios (con el token de sesión en los encabezados).

    GraphQL
    query GetDeals {
      deals {
        edges {
          node {
            objectId
            title
            done
            dueDate
            priority
            createdAt
          }
        }
      }
    }
  2. Crear un negocio

    Usa la mutación createDeal con variables para título, etapa, monto y contacto/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. Actualizar y eliminar

    Mutaciones UpdateDeal y DeleteDeal con 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 }
    }

Preguntas Frecuentes

Preguntas comunes sobre la plantilla del backend de la aplicación CRM.

¿Qué es Back4app?
¿Por qué usar Back4app para una API de CRM GraphQL?
¿Cómo consulto tratos por etapa en GraphQL?
¿Cómo actualizo la etapa de un trato a través de GraphQL?

Confiado por desarrolladores de todo el mundo

Únete a la comunidad que está construyendo el futuro de las aplicaciones

G2 Users Love Us Badge

¿Listo para construir tu aplicación CRM?

Comienza tu proyecto GraphQL en minutos. No se requiere tarjeta de crédito.

Construye con Agente AI