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.
- Despliega en minutos — Pega el aviso del Agente de IA y obtén una aplicación en funcionamiento con contactos, empresas, ofertas y pipeline.
- Seguro por defecto — ACLs y acceso basado en roles para que los usuarios vean solo sus ofertas y datos asignados.
- GraphQL-SDK nativo — Objetos tipados, async/await, fijación offline y Live Queries para actualizaciones de pipeline.
- REST + GraphQL — Ambas APIs generadas automáticamente; filtra ofertas por etapa, lista actividades por relacionado con.
- 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:
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.
Diagrama ER
Diagrama de entidad-relación para el modelo de datos de la aplicación CRM GraphQL.
Esquema CRM: _Usuario, Empresa, Contacto, Negocio, Actividad con punteros para empresa, contacto, negocio, asignado a, relacionado con, creado por.
Ver fuente del diagrama
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
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 listDiccionario de datos
Referencia completa de campos para cada clase en el esquema.
| Campo | Tipo | Descripción | Requerido |
|---|---|---|---|
| objectId | String | Auto-generated unique identifier | automático |
| name | String | Full name of the contact | |
| String | Email address | — | |
| phone | String | Phone number | — |
| company | Pointer<Company> | Company this contact belongs to | — |
| notes | String | Free-form notes | — |
| createdBy | Pointer<_User> | User who created this contact | — |
| createdAt | Date | Auto-generated creation timestamp | automático |
| updatedAt | Date | Auto-generated last-update timestamp | automá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.
{
"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.
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.
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.
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.
Consultar contactos y negocios
Enviar una consulta de GraphQL para obtener contactos o negocios (con el token de sesión en los encabezados).
GraphQLquery GetDeals { deals { edges { node { objectId title done dueDate priority createdAt } } } }Crear un negocio
Usa la mutación createDeal con variables para título, etapa, monto y contacto/empresa relacionado.
GraphQLmutation 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 } } }Actualizar y eliminar
Mutaciones UpdateDeal y DeleteDeal con objectId.
GraphQLmutation 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.
¿Listo para construir tu aplicación CRM?
Comienza tu proyecto GraphQL en minutos. No se requiere tarjeta de crédito.