Integrations and API
GoWeBa integrates with third-party services to extend its functionality. This module explains how to connect, configure, and manage available integrations.
Integrations Page
The Settings → Integrations page lets you connect GoWeBa to third-party services.
Available Integrations
| Service | Type | Function |
|---|---|---|
| Google Workspace | OAuth | Contact, calendar, email, and Drive synchronization |
| Microsoft 365 | OAuth | Contact, calendar, email, and OneDrive synchronization |
| Stripe | API Key | Online payments, automatic billing |
| Twilio | API Key | VoIP telephony, SMS, Voice AI |
| SendGrid | API Key | Email reception and routing |
| Slack | Webhook | GoWeBa event notifications to Slack |
| Zapier | Webhook | Automations with 5,000+ applications |
Configuring an Integration
- Go to Settings → Integrations — The list of available integrations is displayed
- Click "Connect" — The configuration form opens
- Enter credentials — API Key, OAuth, or Webhook URL depending on the service
- Test the connection — GoWeBa verifies the credentials are valid
- Activate — The integration is active and begins synchronizing
Data Migration
GoWeBa offers a complete migration assistant to import your data from other platforms.
Supported Sources
| Source | Data Migrated |
|---|---|
| Google Workspace | Contacts, emails, calendar, Drive |
| Microsoft 365 | Contacts, emails, calendar, OneDrive |
| CSV / vCard | Contacts |
| Other CRM | Via CSV export |
Migration Process
- Connection — OAuth authentication with the source service
- Scan — GoWeBa analyzes the available data and displays a summary
- Mapping — Field mapping verification (GoWeBa suggests automatic mapping)
- Execution — Data import with duplicate management
- Validation — Detailed report: imported, skipped, errors
Outgoing Webhooks
GoWeBa can send HTTP notifications (webhooks) to external services when certain events occur:
- New contact created
- Task completed
- Invoice paid
- Call received
- WEBA message with negative sentiment
Webhooks include an HMAC signature header to verify authenticity.
GoWeBa API
GoWeBa exposes a complete REST API for custom integrations.
Main Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/contacts | GET, POST | List and create contacts |
/api/contacts/[id] | GET, PATCH, DELETE | Detail, edit, delete |
/api/inbox/threads | GET | List email conversations |
/api/tasks | GET, POST | List and create tasks |
/api/calendar/events | GET, POST | List and create events |
/api/invoices | GET, POST | List and create invoices |
/api/weba/chat | POST | Send a message to WEBA |
API Authentication
All API requests require a valid authentication token:
Authorization: Bearer <session_token>
Tokens are generated upon login via NextAuth and are valid for the session duration.
Custom Domain
GoWeBa lets you configure a custom domain to access your platform:
- Settings → Domain — Access DNS configuration
- Add a domain — Enter your domain name (e.g., crm.mybusiness.com)
- Configure DNS — Add the CNAME records indicated at your registrar
- Verification — GoWeBa automatically verifies DNS propagation
- Activation — The domain is active with automatic SSL certificate
FAQ
Q: How many integrations can I configure? A: There is no limit. Configure as many integrations as needed.
Q: Are integrations secure? A: Yes. OAuth tokens are encrypted and API Keys are stored securely. No sensitive data is exposed client-side.
Q: Does migration overwrite my existing data? A: No. Migration adds data without deleting existing data. Duplicates are detected and managed intelligently.
Q: Can I use the API outside of GoWeBa? A: The API is designed for internal platform use. For advanced integrations, contact GoWeBa support.