EspoCRM is een flexibel open source CRM systeem voor klantrelatiebeheer en salesprocessen.
| Eigenschap |
Waarde |
| Poort |
9109 |
| Container |
asd-espocrm |
| Database |
MySQL/MariaDB |
| Health endpoint |
/api/v1/App/user |
| Categorie |
CRM |
| Classificatie |
Optional |
flowchart TB
subgraph EspoCRM Stack
ESPO[asd-espocrm<br/>:9109]
MYSQL[(MariaDB)]
CRON[Cron Daemon]
end
subgraph Integraties
AUTHENTIK[Authentik SSO]
N8N[n8n Workflows]
ZAMMAD[Zammad Helpdesk]
ERPNEXT[ERPNext]
end
subgraph External
EMAIL[Email IMAP/SMTP]
CALDAV[CalDAV]
VOIP[VoIP/Asterisk]
end
ESPO --> MYSQL
CRON --> ESPO
AUTHENTIK --> ESPO
ESPO <--> N8N
ESPO <--> ZAMMAD
ESPO <--> ERPNEXT
ESPO <--> EMAIL
ESPO --> CALDAV
ESPO --> VOIP
| Feature |
Beschrijving |
| Accounts |
Bedrijven en organisaties |
| Contacts |
Contactpersonen |
| Leads |
Sales leads en prospects |
| Opportunities |
Sales pipeline |
| Cases |
Support cases |
| Tasks |
Taken en activiteiten |
| Calendar |
Afspraken en events |
| Emails |
Email integratie |
| Feature |
Beschrijving |
| Sales Pipeline |
Visuele deal tracking |
| Forecasting |
Sales voorspellingen |
| Quotes |
Offertes genereren |
| Products |
Product catalogus |
| Price Books |
Prijslijsten |
| Feature |
Beschrijving |
| Workflows |
Automatische acties |
| BPM |
Business Process Management |
| Webhooks |
Event triggers |
| Formula |
Berekende velden |
EspoCRM biedt een REST API voor alle entiteiten.
# Via API Key
curl -H "X-Api-Key: YOUR_API_KEY" \
"http://localhost:9109/api/v1/Account"
# Via Basic Auth (HMAC)
curl -u "username:password" \
"http://localhost:9109/api/v1/Account"
| Endpoint |
Beschrijving |
/api/v1/Account |
Accounts CRUD |
/api/v1/Contact |
Contacts CRUD |
/api/v1/Lead |
Leads CRUD |
/api/v1/Opportunity |
Opportunities CRUD |
/api/v1/Case |
Cases CRUD |
/api/v1/Task |
Tasks CRUD |
# Lijst accounts
curl -s -H "X-Api-Key: $ESPO_API_KEY" \
"http://localhost:9109/api/v1/Account" | jq '.list[] | {id, name}'
# Account details
curl -s -H "X-Api-Key: $ESPO_API_KEY" \
"http://localhost:9109/api/v1/Account/ACCOUNT_ID" | jq .
# Nieuw contact aanmaken
curl -X POST -H "X-Api-Key: $ESPO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"firstName": "John", "lastName": "Doe", "emailAddress": "john@example.com"}' \
"http://localhost:9109/api/v1/Contact"
# Zoeken met filters
curl -s -H "X-Api-Key: $ESPO_API_KEY" \
"http://localhost:9109/api/v1/Lead?where[0][type]=equals&where[0][attribute]=status&where[0][value]=New" | jq .
EspoCRM ondersteunt OAuth2/OIDC via een PHP plugin.
sso:
type: php-oidc
redirect_path: /oauth-callback.php
# Automatische SSO configuratie
just sso-add espocrm
# Valideer configuratie
just sso-check espocrm
# Test OAuth flow
just sso-test espocrm
¶ Handmatige Configuratie
In EspoCRM Admin > Authentication > OIDC:
| Setting |
Waarde |
| Enable OIDC |
Yes |
| Client ID |
<van Authentik> |
| Client Secret |
<van Authentik> |
| Authorization Endpoint |
http://IP:9101/application/o/authorize/ |
| Token Endpoint |
http://asd-authentik:9000/application/o/token/ |
| UserInfo Endpoint |
http://asd-authentik:9000/application/o/userinfo/ |
| Scopes |
openid profile email |
¶ Command Reference
¶ Lifecycle Commands
# Start EspoCRM
just start espocrm
# Stop EspoCRM
just stop espocrm
# Status bekijken
just status espocrm
# Logs bekijken
just logs espocrm -f
# Restart
just restart espocrm
¶ Management Commands
# Service info met credentials
just info espocrm
# Health check
just health espocrm
# Backup maken
just backup espocrm
# Restore van backup
just restore espocrm
¶ Specifieke Commands
# Clear cache
just espocrm-clear-cache
# Rebuild database
just espocrm-rebuild
# Run scheduled jobs
just espocrm-cron
# Export data
just espocrm-export ENTITY
| Variable |
Beschrijving |
Default |
ESPOCRM_DATABASE_HOST |
Database host |
asd-mariadb |
ESPOCRM_DATABASE_NAME |
Database naam |
espocrm |
ESPOCRM_ADMIN_USERNAME |
Admin user |
admin |
ESPOCRM_ADMIN_PASSWORD |
Admin password |
Generated |
ESPOCRM_SITE_URL |
Public URL |
http://localhost:9109 |
| Volume |
Pad |
Inhoud |
espocrm_data |
/var/www/html/data |
Uploads, cache |
espocrm_custom |
/var/www/html/custom |
Customizations |
espocrm_logs |
/var/www/html/data/logs |
Logfiles |
// n8n workflow: Sync EspoCRM contact to Zammad
{
"on": "EspoCRM Contact Created",
"do": [
"Create Zammad Customer",
"Link to Organization"
]
}
// n8n workflow: Sync EspoCRM opportunity to ERPNext quote
{
"on": "EspoCRM Opportunity Won",
"do": [
"Create ERPNext Quotation",
"Notify Sales Team"
]
}
- Custom Entities voor specifieke business objecten
- Relaties goed definieren tussen entiteiten
- Formula Fields voor berekeningen
- Layouts per team role configureren
- Cron Jobs: Scheduled Tasks draaien via cron
- Cache: Redis caching enablen
- Database: Indexes op custom fields
- Attachments: Externe storage voor grote files