Immens CRM Core - API & Utilizzo Avanzato
REST API
Namespace: immens-crm/v1. Autenticazione con API key configurata in Impostazioni > tab API (header X-API-Key). I webhook in entrata sono verificati con firma HMAC SHA-256.
Contatti
| Endpoint |
Descrizione |
GET /contacts |
Lista contatti (paginata, filtrabile) |
POST /contacts |
Crea/aggiorna contatto (upsert) |
GET /contacts/{id} |
Dettaglio contatto |
PUT /contacts/{id} |
Aggiorna contatto |
DELETE /contacts/{id} |
Elimina contatto |
POST /contacts/batch |
Operazioni batch |
GET /contacts/{id}/activities |
Attività del contatto |
GET /contacts/{id}/notes |
Note del contatto |
GET /contacts/{id}/recordings |
Registrazioni chiamate |
GET /contacts/{id}/transactions |
Transazioni del contatto |
POST /contacts/{id}/stage |
Cambia stage |
GET /contacts/{id}/tags |
Tag del contatto |
POST/DELETE /contacts/{id}/tags/{tag_id} |
Assegna/rimuovi tag |
GET /contacts/{id}/analyze |
Analisi AI del contatto |
Aziende
| Endpoint |
Descrizione |
GET /companies |
Lista aziende |
POST /companies |
Crea azienda |
GET /companies/{id} |
Dettaglio azienda |
PUT /companies/{id} |
Aggiorna azienda |
DELETE /companies/{id} |
Elimina azienda |
GET /companies/{id}/contacts |
Contatti dell'azienda |
Vendite
| Endpoint |
Descrizione |
GET /deals |
Lista deal |
POST /deals |
Crea deal |
GET /deals/{id} |
Dettaglio deal |
PUT /deals/{id} |
Aggiorna deal |
DELETE /deals/{id} |
Elimina deal |
GET /pipelines |
Lista pipeline |
GET /pipelines/{id}/stages |
Stage della pipeline |
GET /sales-scripts |
Lista script vendita |
POST /sales-scripts |
Crea script |
GET /sales-scripts/{id} |
Dettaglio script |
PUT/DELETE /sales-scripts/{id} |
Aggiorna/elimina script |
GET /objections |
Lista obiezioni |
GET /proposals |
Lista proposte |
GET /contracts |
Lista contratti |
GET /products |
Lista prodotti (management) |
POST /products |
Crea prodotto |
GET /products/{id} |
Dettaglio prodotto |
GET /revenue-goals |
Obiettivi di revenue |
Lead Scoring
| Endpoint |
Descrizione |
GET /scoring/rules |
Lista regole |
POST /scoring/rules |
Crea regola |
GET /scoring/rules/{id} |
Dettaglio regola |
PUT/DELETE /scoring/rules/{id} |
Aggiorna/elimina regola |
POST /scoring/calculate/{id} |
Ricalcola punteggio contatto |
Marketing
| Endpoint |
Descrizione |
GET /campaigns |
Lista campagne |
POST /campaigns |
Crea campagna |
GET /campaigns/{id} |
Dettaglio campagna |
PUT/DELETE /campaigns/{id} |
Aggiorna/elimina campagna |
POST /campaigns/{id}/send |
Invia campagna |
GET /email-templates |
Lista template email |
POST /email-templates |
Crea template |
GET /email-templates/{id} |
Dettaglio template |
GET /email-templates/{tid}/parse/{cid} |
Anteprima template per contatto |
GET /email-drafts |
Lista bozze email |
POST /email-drafts |
Crea bozza |
GET /email-drafts/{id} |
Dettaglio bozza |
PUT/DELETE /email-drafts/{id} |
Aggiorna/elimina bozza |
POST /email-drafts/{id}/send |
Invia bozza |
POST /email-drafts/{id}/duplicate |
Duplica bozza |
GET /email-log |
Log email inviate |
GET /email-log/{id} |
Dettaglio email |
POST /email/send-raw |
Invio email raw con header custom |
GET /forms |
Lista form web-to-lead |
POST /forms |
Crea form |
GET /forms/{id} |
Dettaglio form |
POST /form/submit |
Invio form pubblico |
Automazione
| Endpoint |
Descrizione |
GET /automations |
Lista automazioni |
POST /automations |
Crea automazione |
GET /automations/{id} |
Dettaglio automazione |
PUT/DELETE /automations/{id} |
Aggiorna/elimina automazione |
GET /automations/logs |
Log esecuzioni |
GET /automations/logs/{id} |
Dettaglio log |
Altri moduli
| Endpoint |
Descrizione |
GET /chats |
Conversazioni chat |
GET /chats/{id} |
Dettaglio chat |
GET /chats/{id}/messages |
Messaggi chat |
GET /meetings |
Lista meeting |
POST /meetings |
Crea meeting |
GET /meetings/{id} |
Dettaglio meeting |
GET /tasks |
Lista task |
POST /tasks |
Crea task |
GET /tasks/{id} |
Dettaglio task |
GET /tags |
Lista tag |
GET /custom-fields |
Definizioni campi personalizzati |
GET /reports |
Lista report |
GET /reports/{id}/data |
Dati del report |
GET /stats |
Statistiche aggregate |
GET /dashboard/alerts |
Alert dashboard |
GET /recordings |
Registrazioni chiamate |
GET /webhooks |
Lista webhook |
POST /webhooks |
Crea webhook |
GET /webhooks/{id} |
Dettaglio webhook |
GET /webhooks/deliveries |
Log consegne webhook |
POST /webhook/receive |
Ricezione webhook esterno (HMAC) |
GET /settings |
Impostazioni CRM |
GET /self-test |
Self-test del sistema |
Tutte le funzionalità CRM sono accessibili anche come tool MCP (via Immens MCP Fortress):
studioimmens__crm_list_contacts()
studioimmens__crm_get_contact(id=42)
studioimmens__crm_create_contact(name="Mario", email="mario@esempio.it")
studioimmens__crm_get_stats(range="30days")
studioimmens__crm_get_ai_insight(range="30days")
Torna alla panoramica | Installazione | Configurazione