Twilio

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Limitazioni di sistema

Il connettore Twilio può elaborare 25 transazioni al secondo, per nodo, e limita qualsiasi transazione oltre questo limite. Per impostazione predefinita, Integration Connectors alloca due nodi (per una migliore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.

Esempi

Questa sezione descrive come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elencare tutte le registrazioni

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Registrazioni dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.

Esempio: recupera una singola registrazione

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Registrazioni dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Imposta l'ID entità su Get single Recording. Per impostare l'ID entità, nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci RE2e915e78549694bd0a0742d2d39454e5 nel campo Valore predefinito.

Esempio: eliminare una chiamata

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Chiamate dall'elenco Entity.
3. Seleziona l'operazione Delete, quindi fai clic su Fine.
4. Imposta l'ID entità su Elimina una chiamata. Per impostare l'ID entità, nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci CAaa4a99c300bd9d1bcc0d1ae9dcd248c6 nel campo Valore predefinito.

Esempio: creare un feedback sulla chiamata

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Feedback dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
                       "Sid": "CAdefbf2b4caa7df11dc48106385e32345"
                     }

Esempio: creare un riepilogo del feedback sulle chiamate

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona FeedbackSummary dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
                       "Sid": "FS11f26a89d7260fb8cef070b768fcf5d1"
                     }

Esempio: creare un messaggio

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Messaggi dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
                       "Sid": "SMdfde81ab903c0a9e67f932f9bef91090"
                     }

Esempio: aggiornare un messaggio

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Messaggi dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Imposta l'ID entità su Aggiorna un messaggio. Per impostare l'ID entità, nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci SM3ad97d41e786c02bca47c8ce1745053b nel campo Valore predefinito.
5. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
                       "Body": ""
                     }

In alternativa, anziché specificare entityId, puoi anche impostare filterClause su SM3ad97d41e786c02bca47c8ce1745053b.

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

{}

Esempio: aggiorna un IncomingPhoneNumbers

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona IncomingPhoneNumbers dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Imposta l'ID entità su Aggiorna un IncomingPhoneNumbers. Per impostare l'ID entità, nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci PN4047ac009a15885690a50a1d388b8411 nel campo Valore predefinito.
5. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

In alternativa, anziché specificare entityId, puoi anche impostare filterClause su PN4047ac009a15885690a50a1d388b8411.

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

{
                    "Sid": "PN4047ac009a15885690a50a1d388b8411"
                  }

Esempio: aggiorna un OutgoingCallerIds

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona OutgoingCallerIds dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Imposta l'ID entità su Aggiorna un OutgoingCallerIds. Per impostare l'ID entità, nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci PN6f5f9bf39cb1801a6e21a5a80d274bdd nel campo Valore predefinito.
5. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

In alternativa, anziché specificare entityId, puoi anche impostare filterClause su PN6f5f9bf39cb1801a6e21a5a80d274bdd.

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

{
                    "Sid": "PN6f5f9bf39cb1801a6e21a5a80d274bdd"
                  }