Répondre dans ChatWoot depuis votre propre code

Votre équipe répond déjà aux clients dans ChatWoot. Ceci atteint le même ChatWoot depuis votre propre code — ses boîtes de réception, ce qui est ouvert, ce qui s'est dit et la réponse que vous envoyez — sans seconde boîte de réception et sans rien déplacer.

Connectez-le une fois

Sur la page des salles, une fois connecté : l'adresse de votre tableau de bord ChatWoot et un jeton d'accès d'administrateur. La connexion ajoute un webhook pour que les réponses de l'équipe reviennent ; la lâcher le supprime. L'API n'accepte jamais ni l'un ni l'autre : POST /chatwoot/v1/connections/link répond 403 avec la page où ils se saisissent.

Ce qui est ouvert

curl "https://makehybrid.com/chatwoot/v1/connections" \
  -H "X-API-KEY: $MAKEHYBRID_KEY"

curl "https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations?status=open" \
  -H "X-API-KEY: $MAKEHYBRID_KEY"

Chaque conversation porte le contact avec qui elle a lieu, l'agent auquel elle est assignée, sa boîte de réception et le moment de son dernier mouvement. Ses messages arrivent du plus ancien au plus récent, et chacun dit dans quel sens il est allé : incoming est celui du client, outgoing celui de l'équipe.

Répondre, annoter, résoudre

curl -X POST https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID/messages \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
  -d '{"content":"It went out this morning — here is the tracking link."}'

curl -X PATCH https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
  -d '{"status":"resolved"}'

Être prévenu plutôt que demander

Enregistrez un endpoint de webhook et chaque message de n'importe quelle conversation de ce ChatWoot y est posté : celui du client sous la forme chatwoot.message_received, celui de l'équipe sous la forme chatwoot.message_sent. Mêmes endpoints, même signature que ceux de la LinkedIn API.

curl -X POST https://makehybrid.com/chatwoot/v1/webhooks/endpoints \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://acme.com/hooks/chatwoot","events":["chatwoot.message_received"]}'

Questions fréquentes