L'API Messagerie permet de créer des tickets dans la Messagerie et permet ainsi l'intégration de canaux que SocialHub ne prend pas encore en charge. Par exemple, les commentaires sur votre propre site Web peuvent affluer dans la Messagerie SocialHub, même s'il n'est pas basé sur WordPress. Bien sûr, cela nécessite le développement en interne d'un programme qui envoie les commentaires à l'API Messagerie.
Il s'agit d'une fonctionnalité qui doit être activée au préalable pour votre compte. Écrivez-nous un court e-mail à happy@socialhub.io indiquant que vous souhaitez utiliser cette fonctionnalité.
Pour les administrateurs SocialHub
Créer un canal personnalisé
Pour qu'un développeur puisse utiliser l'API Messagerie, un administrateur du compte SocialHub doit d'abord créer un "canal personnalisé". Si l'API Messagerie est activée pour le compte, la section "API Messagerie" apparaît sous Compte > Canaux.
Cliquer sur "Ajouter une chaîne" ouvre un formulaire dans lequel un nom et une image pour la chaîne doivent être attribués. L'image est utilisée comme icône pour les tickets créés via l'API Messagerie. Une fois la chaîne enregistrée, une clé d'accès s'affiche sous le message de confirmation. Avec cette clé d'accès, un développeur peut accéder à notre API et créer des tickets pour le canal personnalisé.
À propos des clés d'accès
Il est parfois nécessaire de remplacer une clé d'accès actuelle (par exemple si elle n'est plus secrète pour une raison quelconque). Normalement, le développeur responsable du canal personnalisé dans votre entreprise vous contactera. Dans ce cas, une nouvelle clé d'accès peut être générée. Attention : La clé d'accès précédente sera désactivée et l'API de ticket ne pourra plus être utilisée avec elle. Par conséquent, une nouvelle clé ne doit être générée qu'en consultation avec le développeur responsable du canal personnalisé concerné dans votre entreprise.
Si un canal personnalisé est supprimé ou désactivé, l'accès à l'API n'est plus possible. Si le canal est réactivé ultérieurement, il recevra une nouvelle clé.
Actuellement, un développeur peut effectuer ces actions à l'aide de la clé d'accès d'un canal personnalisé via l'API Ticket:
- Créer de nouveaux tickets dans le canal personnalisé
Il ne peut pas l'utiliser:
- Créer des tickets pour d'autres canaux ou canaux personnalisés
- Lire ou modifier les tickets du SocialHub
- Accédez à d'autres chaînes
Pour les développeurs
Nous avons résumé tout ce que vos développeurs doivent savoir sur notre site Web SocialHub pour Développeurs: documentation technique de l'API Messagerie