Twilio

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Limites du système

Le connecteur Twilio peut traiter 25 transactions par seconde et par nœud, et limite les transactions au-delà de ce seuil. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.

Exemples

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister tous les enregistrements

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Enregistrements" dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Récupérer un seul enregistrement

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Enregistrements" dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "Récupérer un seul enregistrement". Pour définir l'ID d'entité, dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez RE2e915e78549694bd0a0742d2d39454e5 dans le champ Valeur par défaut.

Exemple : Supprimer un appel

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Appels" dans la liste Entity.
3. Sélectionnez l'opération Delete, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "Supprimer un appel". Pour définir l'ID d'entité, dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez CAaa4a99c300bd9d1bcc0d1ae9dcd248c6 dans le champ Valeur par défaut.

Exemple : Créer un commentaire sur un appel

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Feedback" dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
                       "Sid": "CAdefbf2b4caa7df11dc48106385e32345",
                       "QualityScore": 5
                     }

   L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

   {
                       "Sid": "CAdefbf2b4caa7df11dc48106385e32345"
                     }

Exemple : Créer un récapitulatif des commentaires sur un appel

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "FeedbackSummary" dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
                       "StartDate": "2014-06-01",
                       "EndDate": "2014-06-04"
                     }

   L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

   {
                       "Sid": "FS11f26a89d7260fb8cef070b768fcf5d1"
                     }

Exemple : Créer un message

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Messages" dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
                       "To": "whatsapp:+9178923*****",
                       "Sender": "whatsapp:+14155238886",
                       "Body": "Message is sent from Google Cloud"
                     }

   L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

   {
                       "Sid": "SMdfde81ab903c0a9e67f932f9bef91090"
                     }

Exemple : Mettre à jour un message

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Messages" dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "Mettre à jour un message". Pour définir l'ID d'entité, dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez SM3ad97d41e786c02bca47c8ce1745053b dans le champ Valeur par défaut.
5. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
                       "Body": ""
                     }

Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur SM3ad97d41e786c02bca47c8ce1745053b.

L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

{}

Exemple : Mettre à jour un IncomingPhoneNumbers

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "IncomingPhoneNumbers" dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "Update a IncomingPhoneNumbers". Pour définir l'ID d'entité, dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez PN4047ac009a15885690a50a1d388b8411 dans le champ Valeur par défaut.
5. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
                       "Name": "name of IncomingPhoneNumber is getting updated"
                     }

Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur PN4047ac009a15885690a50a1d388b8411.

L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

{
                    "Sid": "PN4047ac009a15885690a50a1d388b8411"
                  }

Exemple : Mettre à jour un OutgoingCallerIds

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "OutgoingCallerIds" dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "Mettre à jour un OutgoingCallerIds". Pour définir l'ID d'entité, dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez PN6f5f9bf39cb1801a6e21a5a80d274bdd dans le champ Valeur par défaut.
5. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
                       "Name": "Name Updated for 99025*****"
                     }

Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur PN6f5f9bf39cb1801a6e21a5a80d274bdd.

L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

{
                    "Sid": "PN6f5f9bf39cb1801a6e21a5a80d274bdd"
                  }