Intégrez Chat33
à votre stack.

Endpoint

POST https://chat33.io/api/webhooks/events?token=YOUR_TOKEN

Content-Type: application/json

{
  "event": "purchase",
  "contactId": "cm1abc123...",
  "value": 49.99,
  "currency": "USD",
  "metadata": {
    "product": "Pro Plan",
    "source": "checkout"
  }
}

Corps de la requête

Exemples

# cURL
curl -X POST "https://chat33.io/api/webhooks/events?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"event":"purchase","value":29.99,"currency":"USD"}'

// Node.js / fetch
await fetch("https://chat33.io/api/webhooks/events?token=YOUR_TOKEN", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    event: "purchase",
    contactId: "cm1abc123...",
    value: 29.99,
    currency: "USD",
  }),
});

L’API Connect pour développeurs émet un lien à usage unique qui envoie l’un de vos utilisateurs vers l’écran de consentement OAuth de la plateforme elle-même, en votre nom, sans jamais toucher à son mot de passe. Une fois l’accès accordé, le compte connecté se comporte comme n’importe quel autre dans l’API de publication sociale ci-dessus : vous publiez dessus, vous lisez ses statistiques lorsque la plateforme les fournit, et vous le déconnectez, le tout limité à l’utilisateur final (le « profil ») auquel il appartient.

Comment ça marche

1. Créez un profil pour l’utilisateur (POST /v1/profiles), ou réutilisez-en un, identifié par votre propre externalId.
2. Demandez un lien de connexion pour ce profil et une plateforme (POST /v1/connect). Il est valable une seule fois, pendant 15 minutes.
3. Envoyez l’utilisateur vers l’url renvoyée. Il valide sur l’écran de la plateforme elle-même, qui indique Chat33 comme l’app qui demande l’accès : c’est normal, et personne ne voit son mot de passe.
4. Il revient sur votre redirectUrl avec status, profileId et accountIds (ou status=error&code=… s’il a annulé ou si un problème est survenu : un consentement annulé ne consomme pas le lien).

Créer un profil

curl -X POST "https://chat33.io/api/v1/profiles" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Fitness",
    "externalId": "user_482"
  }'

Créer un lien de connexion

curl -X POST "https://chat33.io/api/v1/connect" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prof_abc123",
    "platform": "instagram",
    "redirectUrl": "https://yourapp.com/oauth/done",
    "skipIntro": false
  }'
# -> {"url": "https://chat33.io/connect/...", "expiresAt": "...", "platform": "instagram", "profileId": "prof_abc123"}
# send your user to that url
# skipIntro: true returns a url that goes straight to the platform's consent screen

Ce que voit votre utilisateur

Une page hébergée par Chat33 qui indique le nom de votre app, puis l’écran de connexion et de consentement de la plateforme elle-même, qui indique Chat33 comme l’app qui demande l’accès, et non votre app. C’est ainsi que fonctionne l’OAuth sous-jacent, et c’est normal. L’utilisateur peut révoquer l’accès depuis la plateforme à tout moment.

Pour ignorer la page d’introduction et envoyer votre utilisateur directement à l’écran de consentement de la plateforme, passez "skipIntro": true à la création du lien. Le lien devient alors une redirection immédiate : même token, même expiration de 15 minutes, même retour vers votre redirectUrl. Si vous l’ignorez, indiquez à votre utilisateur sur votre propre écran que la page de consentement mentionnera Chat33, et privilégiez l’envoi par un clic sur un bouton plutôt que par un lien dans un e-mail : les clients de messagerie et les apps de chat préchargent les liens, et le préchargement d’un lien skipIntro ouvre la fenêtre de la plateforme dans l’outil d’analyse (le token n’est pas consommé).

Règles

• Un vrai compte n’existe qu’une seule fois dans tout Chat33 : il ne peut pas être connecté une seconde fois, par vous ou par quelqu’un d’autre, que ce soit via l’API ou le tableau de bord Chat33.
• Les comptes connectés via l’API ne comptent jamais dans la limite de canaux du forfait de votre organisation.
• Les messages et commentaires reçus sur ces comptes ne sont ni enregistrés ni automatisés par Chat33 (la v1 sert uniquement à publier).
• Facebook connecte chaque Page à laquelle l’utilisateur donne accès ; chaque Page est son propre compte et son propre emplacement.
• Instagram se connecte via Instagram Login, pour les comptes professionnels ou de créateur.
• Les publications X faites via les comptes connectés puisent aussi dans votre solde de crédits, comme celles des comptes de votre propre tableau de bord.

Comptes suspendus

Un compte dont l’emplacement est resté impayé pendant 7 jours est suspendu : la publication renvoie 402 account_paused avec les accountIds concernés ; elle reprend automatiquement dès que vous rechargez. POST /v1/posts, POST /v1/posts/validate et POST /v1/posts/:id/duplicate vérifient tous ce point d’emblée, avant de mettre quoi que ce soit en file.

// 402
{
  "error": "ACCOUNT_PAUSED",
  "code": "account_paused",
  "message": "These accounts are paused until outstanding connection charges are paid. Top up credits.",
  "accountIds": ["chan_abc123"]
}

Référence de l’API

Activer l’autorisation

Obtenez l’autorisation connect:write : créez une clé dans Réglages → Clés API et cochez Connecter les comptes de vos utilisateurs. Elle est désactivée par défaut sur chaque clé.

Comment ça marche

Quand vous utilisez des liens suivis dans vos automatisations, Chat33 les enveloppe dans une URL de redirection qui enregistre le clic avant de transférer vers la destination. L’ID du contact est ajouté comme paramètre de requête, pour que les pages suivantes puissent identifier le visiteur.

# Original URL in your flow:
https://yoursite.com/signup

# What gets sent to the user:
https://chat33.io/api/t?url=https://yoursite.com/signup&cid=cm1abc...&fid=flow123

# User is redirected to:
https://yoursite.com/signup?cid=cm1abc...&fid=flow123

Paramètres d’URL ajoutés