Brancher un agent ElevenLabs

Ajoutez à l’agent un serveur MCP personnalisé avec l’adresse. Le jeton secret (Secret Token) porte la valeur entière de l’en-tête Authorization, Bearer vz_<préfixe>_…. Trois en-têtes s’y ajoutent : X-ElevenLabs-Conversation-Id, rempli par la variable system__conversation_id ; X-ElevenLabs-Agent-Id, avec l’identifiant de l’agent ; X-ElevenLabs-Caller-Id, rempli par system__caller_id, le numéro de l’appelant. Hors appel téléphonique, dans le test du navigateur par exemple, ce numéro manque et start_session est refusé. Réglez l’approbation des outils sur « No Approval », ou en approbation fine qui laisse passer les outils Vizalia : pendant un appel, personne n’est là pour approuver. Laissez au serveur 90 secondes pour répondre. Pour la fin d’appel, envoyez les webhooks post-call vers l’adresse de fin d’appel et donnez leur secret HMAC à Vizalia.

Vizalia crée votre agent vocal dans son back-office et vous remet sa clé vz_<préfixe>_…, affichée une seule fois, avec l’adresse de fin d’appel de l’agent.

Pas à pas

1. Le secret. Dans les secrets du workspace ElevenLabs, créez un secret qui contient la valeur entière de l’en-tête : Bearer vz_<préfixe>_…. La clé ne va jamais dans le prompt.

2. Le serveur MCP. Tools, MCP Servers, Add custom MCP server :

   Champ	Valeur
   URL	https://mcp.vizalia.ai/mcp
   Transport	Streamable HTTP
   Secret Token	Le secret de l’étape 1
   En-tête X-ElevenLabs-Conversation-Id	La variable system__conversation_id
   En-tête X-ElevenLabs-Agent-Id	L’identifiant de votre agent
   En-tête X-ElevenLabs-Caller-Id	La variable system__caller_id, le numéro de l’appelant

3. L’approbation des outils. Le réglage par défaut, « Always Ask », bloque l’appel : personne n’est là pour approuver. Choisissez « No Approval », ou « Fine-Grained Tool Approval » avec les outils dont votre agent se sert approuvés d’office (start_session, session_status, analyze_frame, take_photo, record_video, submit_case, end_session), et get_agent désactivé : il ne sert qu’à l’agent de Vizalia.

4. Le délai. Laissez au serveur MCP 90 secondes pour répondre : record_video peut prendre jusqu’à 85 secondes.

5. La fin d’appel. Dans les réglages du workspace, créez un webhook HMAC vers l’adresse de fin d’appel de l’agent, sélectionnez-le comme webhook post-call de l’agent, et donnez son secret à Vizalia.

6. Le numéro. Affectez à l’agent le numéro de téléphone qui recevra les appels.

Tester

Le test dans le navigateur d’ElevenLabs liste les outils, mais n’a pas de numéro d’appelant : start_session y est refusé. C’est attendu ; testez par un vrai appel vers l’agent. Avec une clé vz_test_…, aucun SMS ne part : ouvrez vous-même le lien que renvoie start_session.

Astuce

Le numéro transmis par ElevenLabs est le seul destinataire possible du lien, quoi que dise le modèle : même détourné par un appelant, l’agent ne peut pas envoyer le lien à un autre numéro.

Le prompt

Partez de la trame de la page Agents vocaux, et complétez-la avec votre métier.