Brancher un agent Vapi

Créez un outil MCP avec l’adresse (server.url) et l’en-tête Authorization (server.headers) ; Vapi joint seul l’identifiant de l’appel (X-Call-Id) et, à chaque appel d’outil, le numéro de l’appelant (X-Customer-Number), seul destinataire possible du lien : rien à mettre dans le prompt. Lors d’un appel web, ou si le numéro est masqué, ce numéro manque et start_session est refusé. Portez server.timeoutSeconds à 130 : à 20 secondes, la valeur par défaut, take_photo, record_video et l’attente du client sont coupés. Pour la fin d’appel, pointez l’URL serveur de l’assistant sur l’adresse de fin d’appel, avec un identifiant HMAC (sha256) dont vous donnez le secret à Vizalia, et activez les réessais.

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. L’outil MCP. Tools, Create Tool, type MCP :

   Champ	Valeur
   Server URL (server.url)	https://mcp.vizalia.ai/mcp
   En-tête (server.headers)	Authorization: Bearer vz_<préfixe>_…
   Délai (server.timeoutSeconds)	130 secondes

   À 20 secondes, la valeur par défaut, take_photo, record_video et l’attente du client sont coupés. Ajoutez ensuite l’outil à l’assistant.

2. Rien d’autre à joindre. Vapi envoie seul l’identifiant de l’appel (X-Call-Id) et, à chaque appel d’outil, le numéro de l’appelant (X-Customer-Number), seul destinataire possible du lien. Le numéro n’a rien à faire dans le prompt.

3. La fin d’appel. Dans l’assistant, pointez l’URL serveur (Server URL) sur l’adresse de fin d’appel de l’agent, avec un identifiant HMAC (SHA256) dont vous donnez le secret à Vizalia. Envoyez au moins les messages serveur end-of-call-report et status-update, et activez les réessais, que Vapi ne fait pas d’office.

4. Le numéro. Affectez à l’assistant le numéro qui recevra les appels.

La clé va dans les en-têtes

Un identifiant HMAC de Vapi n’agit pas sur un outil MCP : la clé Vizalia se met dans server.headers de l’outil, en en-tête Authorization. De même, une URL serveur passée en ligne (assistant en ligne, assistantOverrides) ne reçoit plus l’identifiant de l’organisation Vapi pour les organisations créées depuis le 23/09/2026 : mettez-y aussi l’en-tête Authorization dans server.headers.

Tester

Testez par un vrai appel téléphonique vers l’assistant : un appel web depuis le tableau de bord de Vapi, ou un appel au numéro masqué, n’a pas de numéro d’appelant, et start_session y est refusé. Avec une clé vz_test_…, aucun SMS ne part : ouvrez vous-même le lien que renvoie start_session.

Le prompt

Partez de la trame de la page Agents vocaux, et complétez-la avec votre métier. Vapi joint le numéro de l’appelant de lui-même : ne le mettez pas dans le prompt.