Aller au contenu principal

Générateur de code intégré

Ajoutez un widget de vote Society Speaks à votre article en quelques minutes. Les développeurs bénéficient d'une iframe épurée et de contrôles de personnalisation. Les rédacteurs obtiennent des informations structurées, pas du bruit de commentaires.

Référence API Contact

Les intégrations sont disponibles pour les discussions natives de Society Speaks.

Liste de contrôle d'implémentation

  • Confirmez que votre domaine est autorisé
  • Générez l'iframe ci-dessous
  • Ajoutez le redimensionnement automatique pour une expérience utilisateur fluide

Utilisez le Portail Partenaires pour l'intégration en production

Créez vos clés de test, vérifiez les domaines et activez les clés en direct depuis le <a href="/for-publishers/portal/signup" class="underline">Portail Partenaire</a>. Pour la scalabilité, utilisez l'API pour créer des discussions et stockez l'ID de discussion retourné dans votre CMS. Consultez le <a href="/for-publishers/api" class="underline">Référence API</a> pour le flux de travail programmatique.

Pour les développeurs

Une iframe légère, des paramètres prévisibles et des crochets de redimensionnement postMessage.

Pour les rédacteurs

Participation structurée, signaux de consensus clairs et méthodologie vérifiable.

Pour les audiences

Votez en secondes, voyez où le public s'aligne et explorez une analyse approfondie.

Flux à grande échelle

1) Recherche par URL d'article, 2) créer si manquant, 3) stocker l'ID de discussion.

Qu'est-ce qu'un ID de discussion ?

Un identifiant unique renvoyé par l'API lors de la création ou de la recherche d'une discussion.

Pas encore de discussion ?

Appelez POST /api/partner/discussions pour en créer une, puis intégrez immédiatement.

1. Trouvez votre discussion

ou

Renvoyé par l'API lors de la création ou de la recherche d'une discussion.

2. Choisissez un thème

Ou personnalisez les couleurs :

3. Ajouter votre référence (Optionnel)

Utilisé pour l'analyse. Minuscules, pas d'espaces.

Aperçu

Entrez un ID de discussion ou recherchez une URL d'article pour voir l'aperçu

Code d'intégration

<!-- Entrez un ID de discussion pour générer le code d'intégration -->

Extrait à redimensionnement automatique

<script>
window.addEventListener('message', (event) => {
  if (event.data && event.data.type === 'societyspeaks:embed:resize') {
    const iframe = document.getElementById('societyspeaks-embed');
    if (iframe) iframe.style.height = event.data.height + 'px';
  }
});
</script>

Conseils de performance

<link rel="preconnect" href="https://societyspeaks.io">
<link rel="dns-prefetch" href="https://societyspeaks.io">

Astuces

  • Définissez la largeur de l'iframe à 100% pour les intégrations réactives
  • La hauteur par défaut est 600 px ; ajustez en fonction du nombre de déclarations
  • Ajoutez ref pour suivre la participation depuis votre site
  • L'intégration envoie sa hauteur via postMessage pour un dimensionnement dynamique
  • Ajoutez l'extrait de redimensionnement automatique pour éviter les barres de défilement
  • Utilisez les indices de préconnexion pour accélérer le premier affichage