Connecter Vapi à Bitcall (trunk SIP sortant)

💡 À noter : Bitcall est aujourd'hui uniquement sortant — parfait pour les agents Vapi qui passent des appels (ventes, rappels, sondages, notifications). Les numéros entrants (DID) arrivent bientôt, et nous ajouterons ici les étapes pour l'entrant à ce moment-là.

Votre agent Vapi parle. Bitcall veille à ce que l'appel atteigne réellement un téléphone. Connectons-les — côté sortant.

• Un compte Vapi avec accès au tableau de bord et une clé API privée
• Un compte Bitcall avec un compte SIP (nom d'utilisateur + mot de passe) — voir Configurer votre premier compte SIP
• Un caller ID (CLI) sortant que vous êtes autorisé à présenter (les règles de numéro dépendent du pays de destination et de l'opérateur)
• Un peu de solde Bitcall (prépayé — rechargez par carte, PayPal ou crypto)

Depuis votre compte SIP Bitcall, vous utiliserez :

⚠️ Utilisez l'authentification par identifiant/mot de passe, pas l'auth IP. La documentation de Vapi indique que l'auth basée sur l'IP peut mal router sur des serveurs SIP partagés et n'est fiable que lorsqu'un fournisseur propose un serveur SIP dédié ou une URI de terminaison unique. L'identifiant/mot de passe est la voie propre pour Bitcall.

Vapi se connecte aux opérateurs externes via un credential de type byo-sip-trunk. Créez-le avec vos informations Bitcall (méthode API ci-dessous — il existe aussi une section SIP Trunk dans le tableau de bord Vapi) :

curl -X POST "https://api.vapi.ai/credential" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_VAPI_PRIVATE_KEY" \
  -d '{
    "provider": "byo-sip-trunk",
    "name": "Bitcall Outbound Trunk",
    "gateways": [{
      "ip": "gateway.bitcall.io",
      "inboundEnabled": false
    }],
    "outboundLeadingPlusEnabled": true,
    "outboundAuthenticationPlan": {
      "authUsername": "YOUR_BITCALL_SIP_USERNAME",
      "authPassword": "YOUR_BITCALL_SIP_PASSWORD"
    }
  }'

📋 Enregistrez le Credential ID retourné — vous en aurez besoin à l'étape suivante.

Remarque : inboundEnabled est sur false car Bitcall gère le sortant aujourd'hui. outboundLeadingPlusEnabled conserve les numéros au format +E.164 en sortie.

Vapi a besoin d'une ressource « phone number » à utiliser comme caller ID (numéro émetteur) sur les appels sortants. Comme Bitcall est uniquement sortant, c'est le CLI que vous voulez afficher — et non un DID Bitcall.

curl -X POST "https://api.vapi.ai/phone-number" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_VAPI_PRIVATE_KEY" \
  -d '{
    "provider": "byo-phone-number",
    "name": "Bitcall Outbound CLI",
    "number": "YOUR_OUTBOUND_CALLER_ID",
    "numberE164CheckEnabled": false,
    "credentialId": "YOUR_CREDENTIAL_ID"
  }'

📋 Enregistrez le Phone Number ID retourné pour votre appel de test.

Le caller ID sur les appels sortants dépend des règles du pays de destination et de l'opérateur — certaines routes transmettent votre CLI, d'autres le remplacent ou le nettoient. Définissez et gérez votre CLI ici : Modifier ou gérer votre caller ID.

🎲 Vous voulez alterner les caller IDs sur une campagne ? Vous pouvez présenter un CLI différent par appel depuis la logique de votre agent.

Depuis le tableau de bord Vapi, ou via l'API :

curl -X POST "https://api.vapi.ai/call/phone" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_VAPI_PRIVATE_KEY" \
  -d '{
    "assistantId": "YOUR_ASSISTANT_ID",
    "customer": { "number": "NUMBER_YOU_ARE_CALLING", "numberE164CheckEnabled": false },
    "phoneNumberId": "YOUR_PHONE_NUMBER_ID"
  }'

📞 Dring… dring… votre agent Vapi compose désormais via Bitcall. 🎉