# Fiche connecteur Quo Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno. Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur. ## Quo URL : https://get-bruno.com/features/connectors/openphone Référence texte : https://get-bruno.com/features/connectors/openphone/reference.txt Origine : Catalogue Pipedream Statut : Catalogue Pipedream — connexion à vérifier Catégories : Communication Description : Quo est un service de téléphonie d’entreprise pour gérer les contacts, les tâches, les conversations, les appels et les messages. Son périmètre dans ce catalogue couvre la consultation, la création, la mise à jour et la suppression d’objets de travail, ainsi que des déclencheurs instantanés sur les appels et les messages. Authentification : API key Présentation : Quo est un service de téléphonie d’entreprise pour gérer les contacts, les tâches, les conversations, les appels et les messages. Son périmètre dans ce catalogue couvre la consultation, la création, la mise à jour et la suppression d’objets de travail, ainsi que des déclencheurs instantanés sur les appels et les messages. Usage : Créer un contact pour un nouveau client Exemple de demande : Je veux créer un contact pour Atelier Martin avec le numéro mobile +15551234567. Résultat attendu : Un contact est créé avec l’identifiant et les champs fournis. À préciser : Le prénom et/ou le nom du contact ; Au moins un numéro de téléphone à enregistrer Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/openphone/actions/create-contact Usage : Retrouver une conversation puis la marquer comme traitée Exemple de demande : Je veux retrouver la conversation liée à Atelier Martin puis la marquer comme terminée une fois le suivi fait. Résultat attendu : La conversation repérée via les listes de conversations ou de messages est mise au statut done, open ou read. À préciser : L’identifiant de la conversation, ou un repérage préalable via les conversations ou les messages ; Un statut cible parmi done, open ou read Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/openphone/actions/list-conversations ; https://pipedream.com/apps/openphone/actions/list-messages ; https://pipedream.com/apps/openphone/actions/update-conversation Usage : Créer une tâche de suivi pour un appel de démonstration Exemple de demande : Je veux créer une tâche de suivi pour un appel de démonstration avec Atelier Martin, avec la note Rappeler pour valider le devis. Résultat attendu : Une tâche liée à la conversation est créée avec le titre et la description fournis. À préciser : L’identifiant de la conversation obtenu via les conversations ou les messages ; Un titre de tâche court ; Une description de suivi rédigée Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/openphone/actions/create-task ; https://pipedream.com/apps/openphone/actions/list-conversations ; https://pipedream.com/apps/openphone/actions/list-messages Limites propres au service : Les listes d’appels et de messages exigent un identifiant de numéro de téléphone et un participant. La récupération d’un appel peut renvoyer un résumé et une transcription à null si OpenPhone ne les a pas encore générés. La suppression d’un contact ou d’une tâche est irréversible. La mise à jour d’une tâche ne modifie que le titre et la description ; l’échéance et l’assignation passent par d’autres endpoints. Vocabulaire français : Créer un contact — Crée un nouveau contact dans OpenPhone à partir des champs fournis. (https://pipedream.com/apps/openphone/actions/create-contact) Vocabulaire français : Créer une tâche — Crée une tâche liée à une conversation OpenPhone. (https://pipedream.com/apps/openphone/actions/create-task) Vocabulaire français : Supprimer un contact — Supprime définitivement un contact à partir de son identifiant. (https://pipedream.com/apps/openphone/actions/delete-contact) Vocabulaire français : Supprimer une tâche — Supprime définitivement une tâche à partir de son identifiant. (https://pipedream.com/apps/openphone/actions/delete-task) Vocabulaire français : Obtenir un appel — Récupère un appel précis avec, si disponible, son résumé et sa transcription. (https://pipedream.com/apps/openphone/actions/get-call) Vocabulaire français : Lister les appels — Retourne une liste paginée d’appels filtrée par numéro de téléphone et participant. (https://pipedream.com/apps/openphone/actions/list-calls) Vocabulaire français : Lister les contacts — Retourne une liste paginée de contacts, avec filtres éventuels sur les identifiants externes ou les sources. (https://pipedream.com/apps/openphone/actions/list-contacts) Vocabulaire français : Lister les conversations — Retourne une liste paginée de conversations, filtrable par utilisateur ou numéros de téléphone. (https://pipedream.com/apps/openphone/actions/list-conversations) Vocabulaire français : Lister les options d’expéditeur — Retourne les numéros OpenPhone disponibles pour servir de valeur d’expéditeur dans l’envoi d’un message texte. (https://pipedream.com/apps/openphone/actions/list-from-options) Vocabulaire français : Lister les messages — Retourne une liste paginée de messages filtrée par numéro de téléphone, participant et éventuellement conversation. (https://pipedream.com/apps/openphone/actions/list-messages) Vocabulaire français : Lister les numéros de téléphone — Retourne les numéros de téléphone du workspace et les utilisateurs associés. (https://pipedream.com/apps/openphone/actions/list-phone-numbers) Vocabulaire français : Lister les tâches — Retourne une liste paginée de tâches, avec filtre possible par conversation. (https://pipedream.com/apps/openphone/actions/list-tasks) Vocabulaire français : Lister les utilisateurs — Retourne la liste paginée des utilisateurs du workspace. (https://pipedream.com/apps/openphone/actions/list-users) Vocabulaire français : Envoyer un message texte — Envoie un SMS depuis un numéro OpenPhone vers un destinataire. (https://pipedream.com/apps/openphone/actions/send-message) Vocabulaire français : Mettre à jour un contact — Met à jour un ou plusieurs champs d’un contact existant. (https://pipedream.com/apps/openphone/actions/update-contact) Vocabulaire français : Mettre à jour le statut d’une conversation — Change le statut d’une conversation en done, open ou read. (https://pipedream.com/apps/openphone/actions/update-conversation) Vocabulaire français : Mettre à jour une tâche — Met à jour le titre et la description d’une tâche existante. (https://pipedream.com/apps/openphone/actions/update-task) Vocabulaire français : Nouvel enregistrement d’appel terminé — Déclenche un événement lorsqu’un enregistrement d’appel est terminé. (https://pipedream.com/apps/openphone/triggers/new-call-recording-completed-instant) Vocabulaire français : Nouvel appel entrant terminé — Déclenche un événement lorsqu’un appel entrant se termine, même sans réponse ou avec messagerie vocale. (https://pipedream.com/apps/openphone/triggers/new-incoming-call-completed-instant) Vocabulaire français : Nouveau message reçu — Déclenche un événement lorsqu’un nouveau message est reçu. (https://pipedream.com/apps/openphone/triggers/new-message-received-instant) Vocabulaire français : Nouvel appel sortant terminé — Déclenche un événement lorsqu’un appel sortant se termine. (https://pipedream.com/apps/openphone/triggers/new-outgoing-call-completed-instant) - action : Create Contact — Create a new contact in OpenPhone. Example: call with firstName="Jane", lastName="Doe", phoneNumbers= [{"name": "Mobile", "value": "+15551234567"}] → returns the created contact record, including its id . See the documentation (https://pipedream.com/apps/openphone/actions/create-contact) - action : Create Task — Create a task tied to an OpenPhone conversation. Example: call with conversationId="CN123abc", title="Follow up with customer re: onboarding", description="Customer asked about pricing tiers." → returns the created task record, including its id . Use List Conversations or List Messages to find the conversationId . See the documentation (https://pipedream.com/apps/openphone/actions/create-task) - action : Delete Contact — Permanently delete a contact by ID. This cannot be undone. Example: call with contactId from List Contacts → the contact is removed and the response confirms deletion. See the documentation (https://pipedream.com/apps/openphone/actions/delete-contact) - action : Delete Task — Permanently delete a task by ID. This cannot be undone. Use List Tasks to find task IDs. Example: call with taskId="TK123abc" → the task is removed and the response confirms deletion. See the documentation (https://pipedream.com/apps/openphone/actions/delete-task) - action : Get Call — Retrieve a single call by its ID, including its summary and transcript when available. Summary and transcript are fetched from OpenPhone's separate /summary and /transcript endpoints and merged into the result; they are null if OpenPhone has not yet generated them. Use List Calls to find call IDs. Example: call with callId="AC123abc" → returns the call record with summary and transcript fields merged in. See the documentation (https://pipedream.com/apps/openphone/actions/get-call) - action : List Calls — Retrieve a paginated list of calls from OpenPhone. Requires both a phone number ID and a participant to scope the results — the API rejects calls missing either. Use List Phone Numbers to find valid phone number IDs. Example: call with phoneNumberId="PN123abc", participants="+15551234567" → returns up to 10 recent calls between that number and that participant. Use fields to return only specific fields per call. See the documentation (https://pipedream.com/apps/openphone/actions/list-calls) - action : List Contacts — Retrieve a paginated list of contacts. Optionally filter by external IDs and/or sources. All contacts for the organization are returned only when neither externalIds nor sources is provided. Example: call with no filters → returns up to 10 contacts for the organization. Use fields to return only specific fields per contact. See the documentation (https://pipedream.com/apps/openphone/actions/list-contacts) - action : List Conversations — Retrieve a paginated list of conversations. Can be filtered by user and/or phone numbers. Defaults to all conversations in the organization. Results are returned in descending order based on the most recent conversation. Example: call with no filters → returns up to 10 of the most recently active conversations. Use fields to return only specific fields per conversation. See the documentation (https://pipedream.com/apps/openphone/actions/list-conversations) - action : List From Options — List your OpenPhone phone numbers as selectable sender options, for use as the from value in Send a Text Message . Example: call with no inputs → returns a list of {label, value} pairs, one per phone number, where value is the phone number ID to pass as from . See the documentation (https://pipedream.com/apps/openphone/actions/list-from-options) - action : List Messages — Retrieve a paginated list of messages from OpenPhone, scoped to a phone number and a participant — both are required by the API. Optionally narrow further to one conversation with conversationId . Example: call with phoneNumberId="PN123abc", participants=["+15551234567"] → returns up to 10 recent messages between that number and that participant. Use fields to return only specific fields per message. See the documentation (https://pipedream.com/apps/openphone/actions/list-messages) - action : List Phone Numbers — Retrieve the list of phone numbers and users associated with your OpenPhone workspace. Example: call with no inputs → returns each phone number's id , number , name , and the users assigned to it. See the documentation (https://pipedream.com/apps/openphone/actions/list-phone-numbers) - action : List Tasks — Retrieve a paginated list of tasks, optionally filtered by conversation. Use List Conversations or List Messages to find a conversationId . Example: call with no filters → returns up to 50 recent tasks across the organization. Use fields to return only specific fields per task. See the documentation (https://pipedream.com/apps/openphone/actions/list-tasks) - action : List Users — Retrieve a paginated list of users in your OpenPhone workspace. Use this to find a user's ID before assigning a task or filtering calls/messages/conversations by userId . Example: call with no inputs → returns up to 10 users, each with id , name , and email . See the documentation (https://pipedream.com/apps/openphone/actions/list-users) - action : Send a Text Message — Send a text message from one of your OpenPhone numbers to a recipient. Use List Phone Numbers (or List From Options ) to find a valid from value. Example: call with from="PN123abc", to="+15551234567", content="Hi, following up on your request." → sends the message and returns the created message record. See the documentation (https://pipedream.com/apps/openphone/actions/send-message) - action : Update Contact — Update one or more fields on an existing contact. Only the fields you provide are changed; omitted fields are left as-is. Run List Contacts to find a contactId. Example: call with contactId from List Contacts and company="Acme Corp" → updates just the company field and returns the updated contact record. See the documentation (https://pipedream.com/apps/openphone/actions/update-contact) - action : Update Conversation Status — Update the status of an OpenPhone conversation. Set conversationStatus to done , open , or read ; the action routes to the corresponding OpenPhone endpoint ( mark-as-done , mark-as-open , mark-as-read ). Use List Conversations or List Messages to find the conversationId . Example: call with conversationId="CN123abc", conversationStatus="done" → marks the conversation done and returns the updated conversation. See the documentation (https://pipedream.com/apps/openphone/actions/update-conversation) - action : Update Task — Update an existing task's title and description by ID. NOTE: the OpenPhone update endpoint only modifies title and description (both required on every update); due date and assignee are managed via other endpoints. Use List Tasks to find task IDs. Example: call with taskId="TK123abc", title="Follow up (urgent)", description="Customer asked about pricing tiers." → updates both fields and returns the updated task record. See the documentation (https://pipedream.com/apps/openphone/actions/update-task) - trigger : New Call Recording Completed (Instant) — Emit new event when a call recording has finished. (https://pipedream.com/apps/openphone/triggers/new-call-recording-completed-instant) - trigger : New Incoming Call Completed (Instant) — Emit new event when an incoming call is completed, including calls not picked up or voicemails left. (https://pipedream.com/apps/openphone/triggers/new-incoming-call-completed-instant) - trigger : New Message Received (Instant) — Emit new event when a new message is received (https://pipedream.com/apps/openphone/triggers/new-message-received-instant) - trigger : New Outgoing Call Completed (Instant) — Emit new event when an outgoing call has ended. (https://pipedream.com/apps/openphone/triggers/new-outgoing-call-completed-instant)