🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Crisp Skill
πŸ¦€ ClawHub

Crisp Skill

by @paul-phan

Customer support via Crisp API. Use when the user asks to check, read, search, or respond to Crisp inbox messages. Requires Crisp website ID and plugin token (authenticated via environment variables CRISP_WEBSITE_ID, CRISP_TOKEN_ID, and CRISP_TOKEN_KEY).

Versionv1.0.0
Downloads2,100
Stars⭐ 1
#crypto-defi#security#legal
TERMINAL
clawhub install crisp

πŸ“– About This Skill

name: crisp description: Customer support via Crisp API. Use when the user asks to check, read, search, or respond to Crisp inbox messages. Requires Crisp website ID and plugin token (authenticated via environment variables CRISP_WEBSITE_ID, CRISP_TOKEN_ID, and CRISP_TOKEN_KEY).

Crisp Customer Support

Crisp is a customer support platform. Use this skill when the user needs to:

  • Check for new messages in the inbox
  • Read conversation history
  • Search conversations
  • Send replies to customers
  • Check conversation status

    • Credentials

    Crisp requires authentication via HTTP headers with a token identifier and key (Basic Auth), plus the website ID for the API URL.

    Set these as environment variables (stored securely, never logged):

  • CRISP_WEBSITE_ID - Your website identifier (e.g., 0f4c...)
  • CRISP_TOKEN_ID - Your Plugin Token Identifier (e.g., e47d...)
  • CRISP_TOKEN_KEY - Your Plugin Token Key (e.g., a7d7...)

    • Common Workflows

    Check Inbox Status

    scripts/crisp.py inbox list --page 1

    Read Conversation

    scripts/crisp.py conversation get

    Get Messages in Conversation

    scripts/crisp.py messages get

    Send a Reply

    scripts/crisp.py message send  "Your reply text here"

    Search Conversations

    scripts/crisp.py conversations search "query terms" --filter unresolved --max 10

    Mark as Read

    scripts/crisp.py conversation read

    Resolve Conversation

    scripts/crisp.py conversation resolve

    API Reference

    Key endpoints used:

  • GET /v1/website/{website_id}/conversations/{page} - List conversations
  • GET /v1/website/{website_id}/conversation/{session_id} - Get conversation details
  • GET /v1/website/{website_id}/conversation/{session_id}/messages - Get messages
  • POST /v1/website/{website_id}/conversation/{session_id}/message - Send message
  • PATCH /v1/website/{website_id}/conversation/{session_id}/read - Mark as read
  • PATCH /v1/website/{website_id}/conversation/{session_id} - Update/resolve

    • Base URL: https://api.crisp.chat

    Notes

  • Always ask before sending customer replies to confirm tone/content
  • Check for meta.email in conversation for customer email
  • Verify CRISP_WEBSITE_ID, CRISP_TOKEN_ID, and CRISP_TOKEN_KEY are set before running commands
  • Use --json flag for script output when parsing programmatically

    • πŸ“‹ Tips & Best Practices

  • Always ask before sending customer replies to confirm tone/content
  • Check for meta.email in conversation for customer email
  • Verify CRISP_WEBSITE_ID, CRISP_TOKEN_ID, and CRISP_TOKEN_KEY are set before running commands
  • Use --json flag for script output when parsing programmatically