Envoyer WhatsApp via l'API d'Intégration

Authentification

L'auth utilise une clé API locale dans le corps de la requête (`api_key`), pas dans un en-tête HTTP. Chaque entreprise a une clé API locale (UUID) qui est générée automatiquement lors de la création de l'entreprise.

Comment obtenir la clé API locale

1. Connecte-toi au panneau cshub à /app.
2. Ouvre Paramètres → Clé API (ou Profil → Intégration).
3. Copie la clé API locale. Tu peux la régénérer à tout moment — l'ancienne clé devient immédiatement invalide.

Point de terminaison

Un seul point de terminaison couvre chaque envoi WhatsApp non officiel (whatsmeow). Choisis method = text pour des messages libres, ou method = template pour envoyer un modèle que tu as déjà configuré dans le panneau.

Champs du corps

Le corps est en JSON. Les champs ci-dessous sont en parité avec whatscrmhub Laravel — en migrant de l'ancienne version, la forme de la requête est identique.

Exemples de requêtes

1. Envoyer un simple message texte

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "6281234567890",
    "method": "text",
    "text": "Halo, makasih udah order ya!"
  }'

2. Envoyer un modèle avec substitution de variable

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "6281234567890",
    "method": "template",
    "template": "<TEMPLATE_ID>",
    "variables": {
      "$name": "Pak Budi",
      "$order_id": "INV-20260602-001"
    }
  }'

3. Envoyer à un groupe (utiliser le JID de groupe)

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "120363012345678901@g.us",
    "method": "text",
    "text": "Pengumuman: order minggu ini ditutup pukul 17:00.",
    "is_group": true
  }'

Réponse de succès (200 OK)

{
  "status": true,
  "message": "berhasil mengirim pesan"
}

Codes d'erreur & corrections

Notes & limites

• Il y a une limite daily_send par appareil. Évite d'envoyer plus de ~10 messages/seconde depuis un seul appareil pour éviter les interdictions de WhatsApp.
• Si ton entreprise a `api_device_use = required`, le champ `device_key` est obligatoire. Avec cela en option, le serveur choisit un appareil actif basé sur le paramètre `whatsapp_sender_notif` (`sequence` / `spin` / `random`).
• La substitution de variable utilise `str_replace` littéral — les espaces réservés peuvent être n'importe quelle chaîne (par exemple, `$name`, `{name}`, `[NAME]`). Il doit juste correspondre exactement au texte à l'intérieur du message modèle.
• Toujours formater sans "+" et sans espaces/tracés. Exemple : 6281234567890 (Indonésie), 60123456789 (Malaisie). Pour les groupes, utilise le JID complet avec le suffixe `@g.us`.
• Itération MVP : le téléchargement de fichiers binaires via multipart/form-data n'est pas encore pris en charge. Pour envoyer des médias, utilise method=template avec un modèle qui a déjà une image configurée dans le panneau.

API d'intégration vs API du panneau interne

cshub garde délibérément deux chemins d'envoi de messages. L'API d'intégration est destinée aux développeurs tiers et à l'automatisation ; l'API interne alimente le panneau web cshub et l'application mobile. Public différent, auth différent, forme de réponse différente.