Passer à la navigation
ElevenAgentsCampagnes

Créer une campagne d’appels sortants

Crée une campagne sortante qui appelle ou contacte chaque destinataire par message avec l’agent, durant les plages d’appel de la politique, en effectuant de nouvelles tentatives et des suivis dans les limites autorisées. Renvoie 201 pour une nouvelle campagne. Une requête répétée, identifiée par idempotency_key ou par son corps, renvoie la campagne existante avec created défini sur false.

En-têtes

xi-api-keystringOptionnel

Requête

This endpoint expects an object.
call_namestringRequis1-256 characters
Nom de la campagne.
agent_idstringRequis1-256 characters
Agent qui passe les appels.
recipientslist of objectsRequis

Personnes à appeler. Chaque destinataire devient un prospect de la campagne.

channel_configobjectRequis
scheduled_time_unixinteger or nullOptionnel>=0

Date et heure auxquelles commencer à appeler ; omettez ce champ pour commencer immédiatement. Les appels attendent toutefois la prochaine plage d’appel.

timezonestring or nullOptionnel

Fuseau horaire IANA dans lequel interpréter les plages d’appel, remplaçant celui de la politique.

branch_idstring or nullOptionnel<=256 characters

Branche de l’agent à utiliser pour appeler.

environmentstring or nullOptionnel<=256 characters

Environnement dans lequel résoudre les variables d’environnement de l’agent.

target_concurrency_limitinteger or nullOptionnel>=1

Nombre maximal d’appels à passer simultanément.

idempotency_keystring or nullOptionnel1-256 characters

Permet de répéter la requête sans risque : une répétition avec la même clé renvoie la campagne qu’elle a créée.

outcomeobject or nullOptionnel

Le résultat considéré comme une réussite pour les appels de la campagne.

policyobject or nullOptionnel

Politique à capturer dans l’instantané de la campagne. Lorsqu’elle est définie, elle prévaut sur la valeur par défaut du Workspace et sur tout remplacement par agent ; lorsqu’elle est omise, la configuration du Workspace doit exister et fournit la politique.

variantenum or nullOptionnel

simple effectue une tentative par destinataire avec des plages d’appel toujours actives et sans collecte de données ; il ne peut pas être combiné avec policy. advanced utilise policy ou la configuration du Workspace et constitue la valeur par défaut des campagnes téléphoniques.

Valeurs autorisées:

Réponse

Réponse réussie

campaignobject
createdboolean

False lorsque la requête répète une requête antérieure et renvoie sa campagne.

within_calling_windowboolean

Indique si les appels commencent immédiatement plutôt que lors de la prochaine plage d’appel.

Erreurs

422
Unprocessable Entity Error