FAQ - MsgFlash

MsgFlash utilise-t-il l'API officielle WhatsApp Business ?

Non. MsgFlash s’appuie sur Evolution API v2 comme provider interne, pas sur l’API Cloud officielle Meta.

Puis-je utiliser un numéro WhatsApp existant ?

Oui. Vous connectez un numéro existant via QR code ou pairing code depuis le dashboard.

Comment intégrer avec Make, n8n ou Zapier ?

Utilisez un module HTTP standard vers https://srv.msgflash.com/api/v1/* avec le header x-api-key: votre_cle_api.

Puis-je avoir plusieurs clés API ?

Oui, selon votre plan. Free: 1, Pro: 5, MAX: 10.

Que faire si ma clé API est compromise ?

Révoquez-la immédiatement dans le dashboard, puis créez-en une nouvelle et mettez vos intégrations à jour.

Que se passe-t-il quand j'annule mon abonnement ?

L’abonnement reste exploitable jusqu’à la fin de la période en cours, puis le compte revient sur le plan Free et ses limites.

Quelle est la différence entre l'espace personnel et l'équipe ?

L’espace personnel suit votre plan et vos instances. L’espace équipe suit le plan et les instances du propriétaire d’équipe (avec assignations pour les collaborateurs). Changez le contexte actif dans le portail une fois l’UI reliée aux API équipes.

Qui paie les messages envoyés dans une équipe ?

La consommation sortante est imputée à l’abonnement du propriétaire d’équipe pour le mois en cours.

Clé API d'équipe vs clé personnelle ?

Les clés personnelles commencent par msgf_live_ et n’accèdent qu’à votre espace personnel. Les clés d’équipe commencent par msgf_team_ et exigent l’en-tête X-Team-Id correspondant à l’équipe. On ne les mélange pas.

Une clé d'équipe peut-elle appeler /v1/me, /v1/usage ou /v1/billing/* ?

Non. Les routes du compte personnel (/v1/me, /v1/usage, /v1/billing/subscription, /v1/billing/usage, /v1/billing/payments) rejettent les clés d’équipe avec 403 TEAM_KEY_NOT_ALLOWED. Utilisez une clé personnelle pour ces routes, ou l’API console (JWT) pour le billing en contexte d’équipe.

Comment agir dans une équipe depuis la console (JWT) ?

Ajoutez l’en-tête optionnel X-Team-Id: <team uuid> sur n’importe quel appel /api/* de ressource. Sans cet en-tête, l’appel cible votre espace personnel. Si l’équipe est inconnue ou si vous n’en êtes plus membre, l’API renvoie 404 TEAM_NOT_FOUND.

Un collaborateur peut-il gérer la facturation d'une équipe ?

Non. Le propriétaire lit et modifie la facturation. Les admins lisent la souscription et l’usage mais ne peuvent pas modifier (403 BILLING_TEAM_MUTATION_FORBIDDEN). Seul le propriétaire peut voir l’historique de paiements de l’équipe (403 BILLING_PAYMENTS_TEAM_OWNER_ONLY sinon). Les collaborateurs n’ont aucun accès facturation.

Que se passe-t-il pour mes équipes si je rétrograde mon plan ?

Le changement de plan est bloqué avec 409 PLAN_CHANGE_BLOCKED_ACTIVE_TEAMS quand le plan cible ne peut pas accueillir vos équipes ou sièges actuels. Supprimez des équipes ou réduisez les sièges d’abord, puis réessayez le downgrade.

Pagination par curseur — comment itérer une longue liste ?

Les endpoints comme GET /api/v1/contacts, /contacts/groups, /members d’un groupe et /contacts/bulk-jobs retournent nextCursor et hasMore. Repassez nextCursor comme cursor jusqu’à ce que hasMore soit false. Ne changez pas le sort en cours de pagination.