Appeler votre CRM depuis votre propre code
L'API Builder est en HTTPS et JSON simple sur mcp.workspace369.com/v1, authentifiée avec un jeton d'accès personnel. POST /v1/tools/{name} exécute n'importe quel outil MCP autorisé par les étendues de votre jeton, et les raccourcis REST couvrent les clients, les propositions, les factures, les contrats, les projets, les tâches, les demandes et les événements du calendrier. Sa spécification OpenAPI est publique sur /v1/openapi.json. Les webhooks envoient 27 événements à votre point de terminaison, signés avec HMAC-SHA256. Les deux sont inclus avec chaque plan à partir de Cadet ; un essai donne accès une fois qu'une carte est enregistrée.
14 jours d'essai gratuit. Carte requise. Après l'essai : à partir de 29 $/mois. Se renouvelle automatiquement chaque mois jusqu'à annulation. Annulez à tout moment dans Paramètres → Facturation.
Demander une démoChaque plan à partir de Cadet ; un essai obtient l'accès une fois qu'une carte est enregistrée.
- 01
- 8 ressources avec 32 opérations, plus POST /v1/tools/{name} pour tout outil MCP que les étendues de votre jeton autorisent.
- 02
- L'envoi d'une facture, d'une proposition, d'un contrat ou d'un message renvoie 202 et attend l'approbation dans l'application.
- 03
- 27 événements webhook signés, avec jusqu'à 6 tentatives de livraison.
Qu'est-ce qu'une API CRM ?
Une API CRM permet à votre propre code de lire et de mettre à jour les enregistrements CRM sur Internet au lieu de passer par l'application. L'API Builder de Workspace369 est en HTTPS et JSON simple sur mcp.workspace369.com/v1, authentifiée avec un jeton d'accès personnel. POST /v1/tools/{name} exécute tout outil MCP que les étendues de votre jeton autorisent, et les raccourcis REST couvrent les clients, propositions, factures, contrats, projets, tâches, requêtes et événements de calendrier. L'envoi d'une facture, d'une proposition, d'un contrat ou d'un message renvoie un 202 et attend l'approbation dans l'application Workspace369, sauf si le jeton est configuré sur Envoyer sans demander. Les webhooks signés envoient 27 événements à votre point de terminaison lorsque le travail change.
Revu le 4 novembre 2026 par l'équipe produit de Workspace369. La disponibilité peut varier selon le plan, la région et la configuration de l'espace de travail.
Lire la documentation de l'API BuilderHTTP simple, réponses réelles, refus clairs.
Chaque outil est un appel HTTP : POST /v1/tools/{name} exécute n'importe quel outil MCP autorisé par les étendues de votre jeton, et les raccourcis REST couvrent les clients, les propositions, les factures, les contrats, les projets, les tâches, les demandes et les événements de calendrier. Choisissez un appel pour voir ce qui revient.
- Authentifiez-vous avec un jeton d'accès personnel : Authorization: Bearer mcp_pat_…
- 8 ressources avec 32 opérations, plus POST /v1/tools/{name} pour tout outil MCP que les étendues de votre jeton autorisent
- Une forme d'erreur pour chaque refus, avec un code sur lequel votre code peut se baser
Ouvrir la spécification OpenAPI Lisez le guide de l'API Builder
Demande
GET /v1/clients?query=acme&limit=5
Authorization: Bearer mcp_pat_••••
Réponse
200 OK
{
"clients": [
{ "id": "cl_93Fa", "name": "Acme Co",
"email": "billing@acme.test", "lifecycle_stage": "client" }
]
}Les lectures reviennent directement. Page de résultats avec un curseur.
Une forme d'erreur, des codes sur lesquels vous pouvez brancher.
Chaque refus renvoie { "error": { "code", "message", "details" } } avec un statut sur lequel votre code peut agir.
| Code | Statut | Ce que cela signifie |
|---|---|---|
| unauthorized | 401 | Le jeton d'accès personnel est manquant ou invalide. |
| usage_exhausted | 402 | L'espace de travail a utilisé son quota mensuel d'IA. Rechargez et réessayez. |
| plan_required | 403 | L'espace de travail n'a pas encore de plan. La réponse contient un lien de mise à niveau. |
| insufficient_scope | 403 | Le jeton manque d'une portée. details.required_scope le nomme. |
| payload_too_large | 413 | Le corps de la requête dépasse 1 Mo. |
| rate_limited | 429 | Hors limite. Attendez l'en-tête Retry-After, puis réessayez. |
Choisissez les événements. Vérifiez chaque livraison.
Dans Paramètres, sous Données, choisissez Webhooks et Nouveau webhook, sélectionnez parmi 27 événements, et copiez le secret de signature une fois. Chaque livraison est un POST JSON signé.
- Signé
- X-Webhook-Signature est un HMAC-SHA256 du corps brut plus X-Webhook-Timestamp, créé avec votre secret de signature. Faites pivoter le secret à tout moment.
- Retenté
- Répondez avec un 2xx dans les 10 secondes. Sinon, la livraison est réessayée jusqu'à 5 fois supplémentaires, soit 6 tentatives au total, avec le même X-Webhook-Id. Les livraisons sont enregistrées pendant 30 jours.
- Sans risque de répétition
- Les livraisons peuvent arriver dans le désordre ou plus d'une fois, alors ignorez tout X-Webhook-Id que vous avez déjà traité. Les livraisons de webhooks n'utilisent pas l'utilisation de l'IA.
Ce que reçoit votre point de terminaison
Choisissez les événements dont vous avez besoin.
27 événements répartis en 8 familles. Abonnez-vous à ceux dont vous avez besoin, jusqu'à 50 webhooks par espace de travail. La gestion des webhooks nécessite l'autorisation Gérer les webhooks.
| Famille | Événements |
|---|---|
| Entrées de temps | time_entry.created, time_entry.updated, time_entry.deleted |
| Feuilles de temps | timesheet.submitted, timesheet.approved, timesheet.rejected |
| Factures | invoice.created, invoice.paid, invoice.status_changed |
| Propositions | proposal.sent, proposal.accepted, proposal.declined |
| Contrats | contract.sent, contract.recipient_completed, contract.completed, contract.declined, contract.voided, contract.expired |
| Réservations | booking.created, booking.rescheduled, booking.cancelled, booking.no_show |
| Demandes | lead.created, lead.converted, lead.archived |
| Clients | client.created, client.stage_changed |
Envoyez des e-mails à partir de code et connectez vos outils d'automatisation.
L'API E-mail est un point de terminaison d'envoi uniquement avec sa propre clé d'espace de travail. L'application Workspace369 pour Zapier (bêta ; rejoignez avec le lien d'invitation sur la page Zapier) démarre des Zaps à partir de ceux-ci, et Make et n8n écoutent les mêmes webhooks signés.
- API d'e-mailPOST /v1/email/messages envoie des e-mails transactionnels avec une clé d'espace de travail, séparément de vos jetons d'accès personnels.
- Zapier, Make et n8nRejoignez l'application Workspace369 pour Zapier (bêta) avec le lien d'invitation, ou démarrez des automatisations Zapier, Make et n8n à partir des webhooks signés ci-dessus et appelez l'API Builder depuis leurs étapes HTTP.
- Appeler depuis votre serveurUne démonstration de l'appel de Workspace369 depuis votre propre serveur et de la création de factures.
Jetons avec des limites que vous choisissez, et rien de caché.
Une fois qu'un administrateur active les connexions IA, vous pouvez créer un jeton d'accès personnel dans Paramètres, sous IA. Il ne transporte que les étendues et l'expiration qu'ils choisissent, et l'espace de travail peut le voir et l'arrêter.
- Jamais plus que son créateur
- Chaque appel est vérifié en direct par rapport au rôle du membre, de sorte qu'un jeton ne peut pas faire ce que son créateur ne peut pas.
- Chaque appel est enregistré
- Le journal d'appels enregistre l'application, le membre, l'outil, la portée, le résultat et l'utilisation de l'IA. Il conserve les noms des champs, jamais les valeurs.
- Les administrateurs peuvent révoquer n'importe quel jeton
- Les administrateurs d'espace de travail voient les jetons de chaque membre. Un jeton révoqué cesse immédiatement de fonctionner.
- Un rythme soutenu
- Jusqu'à 120 appels par minute par jeton et 600 par espace de travail, partagés avec MCP, avec un corps de requête de 1 Mo. Au-delà de la limite, vous recevez un 429 avec Retry-After.
L'API et les webhooks sur tous les plans, à partir de Cadet.
L'API Builder sur mcp.workspace369.com/v1 et les webhooks signés sont inclus avec chaque plan à partir de Cadet. Un essai donne accès une fois qu'une carte est enregistrée. Chaque appel réussi utilise la même utilisation de l'IA que l'appel MCP correspondant.
Comparer les plans- outils sur le serveur
- 127
- événements webhook
- 27
- appels par minute par jeton
- 120
| Plans | Cadet29 $/mois | Voyager74 $/mois | Specialist149 $/mois | Commander299 $/mois | Enterprise699 $/mois | |
|---|---|---|---|---|---|---|
| API Builder | Chaque plan | Inclus | Inclus | Inclus | Inclus | Inclus |
| Webhooks | Chaque plan | Inclus | Inclus | Inclus | Inclus | Inclus |
| Connexions IA (MCP) | Chaque plan | Inclus | Inclus | Inclus | Inclus | Inclus |
Les appels échoués ou refusés n'utilisent pas l'IA.
Questions sur l'API Builder et les Webhooks
Quels plans incluent l'API Builder ?
Chaque plan à partir de Cadet, et un essai gratuit obtient l'accès une fois qu'une carte est enregistrée dans la facturation. Un propriétaire ou un administrateur doit avoir activé Autoriser les connexions IA dans les Paramètres, sous IA. Les webhooks sont également inclus avec chaque plan à partir de Cadet.#
L'essai gratuit inclut-il l'API ?
Oui, une fois qu'une carte est enregistrée. L'essai de 14 jours dispose alors de l'API Builder et des webhooks comme tout plan.#
Comment puis-je m'authentifier ?
Créez un jeton d'accès personnel dans les Paramètres, sous IA, avec Créer un jeton. Choisissez ses autorisations et son expiration (30 jours, 90 jours, 1 an ou aucune), copiez-le une fois et envoyez-le comme Authorization: Bearer mcp_pat_... à chaque requête. Chaque appel est vérifié par rapport aux autorisations actives du membre créateur ainsi qu'aux étendues du jeton.#
Où se trouve la spécification OpenAPI ?
Il est public, sans jeton requis, à l'adresse /v1/openapi.json sur le même hôte. Il est construit à partir du registre d'outils en direct, il correspond donc à ce que le serveur accepte.#
Comment puis-je vérifier un webhook ?
Chaque livraison transporte X-Webhook-Signature, X-Webhook-Timestamp et X-Webhook-Id. La signature est un HMAC-SHA256 hexadécimal du corps brut de la requête suivi du timestamp, créé avec votre secret de signature. Répondez avec un 2xx dans les 10 secondes ; les livraisons échouées sont retentées jusqu'à 5 fois supplémentaires, et X-Webhook-Id reste le même à chaque nouvelle tentative.#
Les appels API utilisent-ils l'utilisation de l'IA ?
Oui. Chaque appel réussi utilise la même IA que l'appel MCP correspondant, à partir de l'allocation mensuelle du plan. Les appels échoués ou refusés n'utilisent rien, et les livraisons par webhook n'utilisent rien.#
Dois-je utiliser l'API ou MCP ?
Utilisez l'API Builder lorsque votre propre code ou un script effectue les appels. Utilisez le serveur MCP lorsqu'une application IA telle que Claude ou ChatGPT les effectue. Les deux exécutent les mêmes outils avec les mêmes permissions, approbations, limites de débit et journal d'audit.#
Pointez votre code vers un espace de travail où les envois attendent un oui par défaut.
Commencez un essai, enregistrez une carte, créez un jeton d'accès personnel dans les paramètres, et passez votre premier appel.
14 jours d'essai gratuit. Carte requise. Après l'essai : à partir de 29 $/mois. Se renouvelle automatiquement chaque mois jusqu'à annulation. Annulez à tout moment dans Paramètres → Facturation.
Voir la tarification14 jours gratuits · carte requise · puis 29 $/mois · annulation à tout moment