Partager via


Blackbaud Raisers Edge NXT Prospects

Blackbaud Raiser’s Edge NXT est une solution logicielle complète de collecte de fonds et de gestion des donateurs basée sur le cloud conçue spécifiquement pour les organisations à but non lucratif et l’ensemble de la bonne communauté sociale. Utilisez le connecteur Prospects pour gérer les prospects, les opportunités et les évaluations.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Prise en charge de Blackbaud
URL https://www.blackbaud.com/support
Messagerie électronique skyapi@blackbaud.com
Métadonnées du connecteur
Éditeur Blackbaud, Inc.
Site internet https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt
Politique de confidentialité https://www.blackbaud.com/privacy-shield
Catégories Ventes et CRM ; Productivité

Raiser’s Edge NXT est une solution complète de collecte de fonds et de gestion des donateurs basée sur le cloud conçue spécifiquement pour les organisations à but non lucratif et l’ensemble de la bonne communauté sociale.

Ce connecteur est basé sur l’API SKY de Blackbaud, et fournit des opérations pour aider à gérer les prospects et les entités associées trouvées dans le NXT edge de The Raiser, notamment :

  • Perspectives
  • Possibilités
  • Évaluations
  • et bien plus encore...

Pour plus d’informations, consultez la documentation.

Prerequisites

Pour utiliser ce connecteur, vous devez disposer d’un compte Blackbaud ID avec accès à un ou plusieurs environnements Blackbaud.

En outre, l’administrateur de votre organisation doit également effectuer une action au niveau de l’administrateur au sein du système pour permettre à ce connecteur d’accéder à votre environnement Blackbaud. Vous trouverez plus d’informations sur ces prérequis dans la documentation de configuration initiale .

Comment obtenir des informations d’identification ?

L’administrateur de votre organisation vous enverra une invitation à l’environnement Edge NXT de l’organisation de l’organisation et configurera les autorisations de votre compte d’utilisateur dans l’environnement. Aucune information d’identification supplémentaire n’est requise pour utiliser ce connecteur.

Problèmes connus et limitations

Le connecteur fonctionne dans le contexte de votre compte d’utilisateur et sera donc soumis à vos autorisations utilisateur dans l’environnement.

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Créer un champ personnalisé d’opportunité

Crée un champ personnalisé d’opportunité.

Créer une opportunité

Crée une nouvelle opportunité.

Créer une pièce jointe d’opportunité

Crée une pièce jointe d’opportunité.

Créer une évaluation constituante

Crée une évaluation constituante.

Mettre à jour un champ personnalisé d’opportunité

Met à jour un champ personnalisé d’opportunité.

Mettre à jour une opportunité

Met à jour une opportunité.

Mettre à jour une pièce jointe d’opportunité

Met à jour une pièce jointe d’opportunité.

Obtenir l’état des prospects constituants

Retourne l’état actuel des prospects pour un constituant.

Obtenir une opportunité

Retourne des informations sur une opportunité. Remarque : ce point de terminaison retourne la propriété d’état avec une latence d’environ 10 minutes.

Répertorier les champs personnalisés d’opportunité

Répertorie les champs personnalisés pour une opportunité.

Répertorier les opportunités

Retourne une liste d’opportunités.

Répertorier les pièces jointes d’opportunité

Répertorie les pièces jointes pour une opportunité.

Répertorier les évaluations des constituants

Retourne la liste des évaluations d’un constituant.

Créer un champ personnalisé d’opportunité

Crée un champ personnalisé d’opportunité.

Paramètres

Nom Clé Obligatoire Type Description
body
body True dynamic

Objet qui représente le champ personnalisé à créer.

Retours

Pièce jointe d’opportunité créée

Créer une opportunité

Crée une nouvelle opportunité.

Paramètres

Nom Clé Obligatoire Type Description
ID constituant
constituent_id True string

ID d’enregistrement système de la constituante associée à l’opportunité.

Objectif
purpose True string

Utilisation prévue pour toute somme levée suite à l’opportunité.

Nom
name True string

Nom qui identifie l’opportunité tout au long du programme, par exemple dans les listes ou dans les dossiers constituants. Limite de caractères : 255.

Statut
status string

Le statut qui indique où se trouve l’opportunité dans le processus de sollicitation.

Échéance
deadline date-time

Date d’objectif de l’occasion de produire un cadeau (par exemple : '2020-09-18T04:13:56Z').

Demander la date
ask_date date-time

Date à laquelle la sollicitation a été faite (ex : '2020-09-18T04:13:56Z').

value
value double

Valeur monétaire.

Date attendue
expected_date date-time

Date à laquelle la perspective devrait donner suite à l’opportunité (par exemple : '2020-09-18T04:13:56Z').

value
value double

Valeur monétaire.

Date de financement
funded_date date-time

Date à laquelle la perspective a donné suite à l’opportunité (par exemple : '2020-09-18T04:13:56Z').

value
value double

Valeur monétaire.

ID de campagne
campaign_id string

ID d’enregistrement système de la campagne associée à l’opportunité. La campagne définit les objectifs globaux de collecte d’argent.

ID du fonds
fund_id string

ID d’enregistrement système du fonds associé à l’opportunité. Le fonds désigne l’objectif financier spécifique d’un cadeau et identifie le compte financier de ce cadeau.

ID constituant
constituent_id string

ID d’enregistrement système du constituant associé à la collecte de fonds.

value
value double

Valeur monétaire.

Inactif?
inactive boolean

L’opportunité est-elle inactive ?

Retours

Opportunité créée

Créer une pièce jointe d’opportunité

Crée une pièce jointe d’opportunité.

Paramètres

Nom Clé Obligatoire Type Description
ID d’opportunité
parent_id True string

ID d’enregistrement système de l’opportunité associée à la pièce jointe.

Type
type True string

Type de pièce jointe. Les pièces jointes physiques sont des fichiers chargés tels que des images, des fichiers PDF ou des documents Word enregistrés localement ou sur le réseau. Ils sont stockés et gérés dans le système. Les pièces jointes de liens sont des liens vers des fichiers tels que des images, des billets de blog ou des vidéos YouTube en ligne ou dans un compte de stockage cloud. Ils sont stockés et gérés en externe.

Nom
name string

Nom de fichier de la pièce jointe Limite de caractères : 150.

Date
date date-time

Date de la pièce jointe (par exemple : '2020-09-18T04:13:56Z'). Ce champ est défini par défaut sur la date et l’heure actuelles s’il n’est pas fourni.

URL
url string

URL de la pièce jointe. Cela est requis pour les pièces jointes de lien et non applicables aux pièces jointes physiques.

Nom de fichier
file_name string

Le nom du fichier. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.

ID de fichier
file_id string

L’identificateur du fichier. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.

ID de miniature
thumbnail_id string

Identificateur de la miniature. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.

Étiquettes
tags array of string

Balises associées à la pièce jointe.

Retours

Pièce jointe d’opportunité créée

Créer une évaluation constituante

Crée une évaluation constituante.

Paramètres

Nom Clé Obligatoire Type Description
body
body True dynamic

Objet qui représente l’évaluation à créer.

Retours

Évaluation constituante créée

Mettre à jour un champ personnalisé d’opportunité

Met à jour un champ personnalisé d’opportunité.

Paramètres

Nom Clé Obligatoire Type Description
ID de champ personnalisé
custom_field_id True string

ID d’enregistrement système du champ personnalisé à mettre à jour.

body
body True dynamic

Objet qui représente les propriétés du champ personnalisé à mettre à jour.

Mettre à jour une opportunité

Met à jour une opportunité.

Paramètres

Nom Clé Obligatoire Type Description
ID d’opportunité
opportunity_id True string

ID d’enregistrement système de l’opportunité de mise à jour.

Objectif
purpose string

Utilisation prévue pour toute somme levée suite à l’opportunité.

Nom
name string

Nom qui identifie l’opportunité tout au long du programme, par exemple dans les listes ou dans les dossiers constituants. Limite de caractères : 255.

Statut
status string

Le statut qui indique où se trouve l’opportunité dans le processus de sollicitation.

Échéance
deadline date-time

Date d’objectif de l’occasion de produire un cadeau (par exemple : '2020-09-18T04:13:56Z').

Demander la date
ask_date date-time

Date à laquelle la sollicitation a été faite (ex : '2020-09-18T04:13:56Z').

value
value double

Valeur monétaire.

Date attendue
expected_date date-time

Date à laquelle la perspective devrait donner suite à l’opportunité (par exemple : '2020-09-18T04:13:56Z').

value
value double

Valeur monétaire.

Date de financement
funded_date date-time

Date à laquelle la perspective a donné suite à l’opportunité (par exemple : '2020-09-18T04:13:56Z').

value
value double

Valeur monétaire.

ID de campagne
campaign_id string

ID d’enregistrement système de la campagne associée à l’opportunité. La campagne définit les objectifs globaux de collecte d’argent.

ID du fonds
fund_id string

ID d’enregistrement système du fonds associé à l’opportunité. Le fonds désigne l’objectif financier spécifique d’un cadeau et identifie le compte financier de ce cadeau.

ID constituant
constituent_id string

ID d’enregistrement système du constituant associé à la collecte de fonds.

value
value double

Valeur monétaire.

Inactif?
inactive boolean

L’opportunité est-elle inactive ?

Mettre à jour une pièce jointe d’opportunité

Met à jour une pièce jointe d’opportunité.

Paramètres

Nom Clé Obligatoire Type Description
ID de pièce jointe
attachment_id True string

ID d’enregistrement système de la pièce jointe à mettre à jour.

Nom
name string

Nom de fichier de la pièce jointe Limite de caractères : 150.

Date
date date-time

Date de la pièce jointe (par exemple : '2020-09-18T04:13:56Z').

URL
url string

URL de la pièce jointe. Cela est requis pour les pièces jointes de lien et non applicables aux pièces jointes physiques.

Étiquettes
tags array of string

Balises associées à la pièce jointe.

Obtenir l’état des prospects constituants

Retourne l’état actuel des prospects pour un constituant.

Paramètres

Nom Clé Obligatoire Type Description
ID constituant
constituent_id True string

ID d’enregistrement système de la constituante pour laquelle l’état de prospect doit être récupéré.

Retours

État des prospects

Obtenir une opportunité

Retourne des informations sur une opportunité. Remarque : ce point de terminaison retourne la propriété d’état avec une latence d’environ 10 minutes.

Paramètres

Nom Clé Obligatoire Type Description
ID d’opportunité
opportunity_id True string

ID d’enregistrement système de l’opportunité d’obtenir.

Retours

Opportunité

Répertorier les champs personnalisés d’opportunité

Répertorie les champs personnalisés pour une opportunité.

Paramètres

Nom Clé Obligatoire Type Description
ID d’opportunité
opportunity_id True string

ID d’enregistrement système de l’opportunité.

Retours

Champs personnalisés

Répertorier les opportunités

Retourne une liste d’opportunités.

Paramètres

Nom Clé Obligatoire Type Description
Liste
list_id string

Définit un identificateur de liste utilisé pour filtrer l’ensemble d’opportunités pour ceux inclus dans la liste spécifiée. Si cette valeur est définie, d’autres filtres spécifiés sont ignorés.

ID constituant
constituent_id string

Représente une liste séparée par des virgules d’ID d’enregistrement système constituants pour filtrer les résultats. Par exemple, « 280 1232 » retourne uniquement les opportunités de la constituante 280 ou constituante 1232.

Limit
limit integer

Représente le nombre d’enregistrements à retourner. La valeur par défaut est 500. La valeur maximale est de 5 000.

Décalage
offset integer

Représente le nombre d’enregistrements à ignorer. Pour une utilisation avec la pagination.

Inclure inactif ?
include_inactive boolean

Inclure des opportunités inactives ?

Ajouté ou après
date_added date-time

Filtrez les résultats sur les opportunités créées ou après la date spécifiée (par exemple : « 2020-09-18T04:13:56Z »).

Modifié sur ou après
last_modified date-time

Filtrez les résultats sur les opportunités modifiées ou après la date spécifiée (par exemple : « 2020-09-18T04:13:56Z »).

Retours

Possibilités

Répertorier les pièces jointes d’opportunité

Répertorie les pièces jointes pour une opportunité.

Paramètres

Nom Clé Obligatoire Type Description
ID d’opportunité
opportunity_id True string

ID d’enregistrement système de l’opportunité.

Retours

Attachments

Répertorier les évaluations des constituants

Retourne la liste des évaluations d’un constituant.

Paramètres

Nom Clé Obligatoire Type Description
ID constituant
constituent_id True string

ID d’enregistrement système de la constituante

Inclure inactif ?
include_inactive boolean

Inclure des évaluations inactives ?

Seulement le plus récent ?
most_recent_only boolean

Incluez uniquement les évaluations les plus récentes ?

Retours

Évaluations

Définitions

ConstituentApi.ApiCollectionOfRatingRead

Évaluations

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre d’éléments disponibles pour la récupération dans la collection après l’application de paramètres de requête. Les paramètres de limite et de décalage n’affectent pas le nombre, mais pour faciliter la pagination, ils peuvent affecter le nombre d’éléments dans le jeu de résultats de valeur.

value
value array of ConstituentApi.RatingRead

Ensemble d’éléments inclus dans la réponse. Il peut s’agir d’un sous-ensemble des éléments de la collection.

ConstituantApi.CreatedConstituentRating

Évaluation constituante créée

Nom Chemin d’accès Type Description
ID
id string

ID de l’évaluation constituante nouvellement créée.

ConstituentApi.ProspectStatusRead

État des prospects

Nom Chemin d’accès Type Description
Statut
status string

État actuel des prospects de la constituante.

Jours écoulés
days_elapsed integer

Nombre total de jours dans l’état actuel des prospects en fonction de la date de début.

Date de début
start date-time

Date de début de l’état du prospect.

Commentaires
comments string

Commentaires sur l’état des prospects.

ConstituentApi.RatingRead

Notation

Nom Chemin d’accès Type Description
ID
id string

ID d’enregistrement système de l’évaluation.

ID constituant
constituent_id string

ID d’enregistrement système de la constituante associée à l’évaluation.

Origine
source string

Source de la nouvelle évaluation.

Catégorie
category string

Catégorie de l’évaluation.

Date
date date-time

Date de l’évaluation.

Descriptif
value

Valeur de l’évaluation.

Commentaires
comment string

Commentaire sur l’évaluation.

Inactif?
inactive boolean

L’évaluation est-elle inactive ?

Type
type string

Ce champ calculé indique le type de données que l’évaluation représente en fonction de la propriété de catégorie.

OpportunityApi.ApiCollectionOfOpportunityAttachmentRead

Attachments

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre d’éléments disponibles pour la récupération dans la collection après l’application de paramètres de requête. Les paramètres de limite et de décalage n’affectent pas le nombre, mais pour faciliter la pagination, ils peuvent affecter le nombre d’éléments dans le jeu de résultats de valeur.

value
value array of OpportunityApi.OpportunityAttachmentRead

Ensemble d’éléments inclus dans la réponse. Il peut s’agir d’un sous-ensemble des éléments de la collection.

OpportunityApi.ApiCollectionOfOpportunityCustomFieldRead

Champs personnalisés

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre d’éléments disponibles pour la récupération dans la collection après l’application de paramètres de requête. Les paramètres de limite et de décalage n’affectent pas le nombre, mais pour faciliter la pagination, ils peuvent affecter le nombre d’éléments dans le jeu de résultats de valeur.

value
value array of OpportunityApi.OpportunityCustomFieldRead

Ensemble d’éléments inclus dans la réponse. Il peut s’agir d’un sous-ensemble des éléments de la collection.

OpportunityApi.ApiCollectionOfOpportunityRead

Possibilités

Nom Chemin d’accès Type Description
Nombre
count integer

Nombre d’éléments disponibles pour la récupération dans la collection après l’application de paramètres de requête. Les paramètres de limite et de décalage n’affectent pas le nombre, mais pour faciliter la pagination, ils peuvent affecter le nombre d’éléments dans le jeu de résultats de valeur.

value
value array of OpportunityApi.OpportunityRead

Ensemble d’éléments inclus dans la réponse. Il peut s’agir d’un sous-ensemble des éléments de la collection.

OpportunityApi.CreatedOpportunity

Opportunité créée

Nom Chemin d’accès Type Description
ID
id string

ID de l’opportunité nouvellement créée.

OpportunityApi.CreatedOpportunityAttachment

Pièce jointe d’opportunité créée

Nom Chemin d’accès Type Description
ID
id string

ID de la pièce jointe d’opportunité nouvellement créée.

OpportunityApi.CreatedOpportunityCustomField

Pièce jointe d’opportunité créée

Nom Chemin d’accès Type Description
ID
id string

ID de la pièce jointe d’opportunité nouvellement créée.

OpportunityApi.Collecte de fonds

Collecte de fonds

Nom Chemin d’accès Type Description
ID constituant
constituent_id string

ID d’enregistrement système du constituant associé à la collecte de fonds.

value
credit_amount.value double

Valeur monétaire.

OpportunityApi.OpportunityAttachmentRead

Attachment

Nom Chemin d’accès Type Description
ID
id string

ID d’enregistrement système de la pièce jointe.

ID d’opportunité
parent_id string

ID d’enregistrement système de l’opportunité associée à la pièce jointe.

Type
type string

Type de pièce jointe. Les pièces jointes physiques sont des fichiers chargés tels que des images, des fichiers PDF ou des documents Word enregistrés localement ou sur le réseau. Ils sont stockés et gérés dans le système. Les pièces jointes de liens sont des liens vers des fichiers tels que des images, des billets de blog ou des vidéos YouTube en ligne ou dans un compte de stockage cloud. Ils sont stockés et gérés en externe.

Nom
name string

Nom de fichier de la pièce jointe Limite de caractères : 150.

Date
date date-time

Date de la pièce jointe.

URL
url string

URL de la pièce jointe. Cela est requis pour les pièces jointes de lien et non applicables aux pièces jointes physiques.

Nom de fichier
file_name string

Le nom du fichier. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.

ID de fichier
file_id string

L’identificateur du fichier. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.

ID de miniature
thumbnail_id string

Identificateur de la miniature. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.

URL de miniature
thumbnail_url string

URL d’une miniature. Pour les pièces jointes physiques qui sont uniquement des images. Contient une signature limitée dans le temps qui limite l’accès à 60 minutes.

Type de contenu
content_type string

Type de contenu. Pour les pièces jointes physiques uniquement.

Taille du fichier
file_size integer

Taille du fichier en octets. Pour les pièces jointes physiques uniquement.

Étiquettes
tags array of string

Balises associées à la pièce jointe.

OpportunityApi.OpportunityCustomFieldRead

Champ personnalisé

Nom Chemin d’accès Type Description
ID
id string

ID d’enregistrement système du champ personnalisé.

ID d’opportunité
parent_id string

ID d’enregistrement système de l’opportunité associée au champ personnalisé.

Catégorie
category string

Catégorie de champ personnalisé.

Type
type string

Type de données que le champ personnalisé représente.

Valeur
value

Valeur du champ personnalisé.

Valeur de texte
text_value string

Valeur de texte du champ personnalisé.

Valeur numérique
number_value integer

Valeur numérique du champ personnalisé.

Valeur de date
date_value date

Valeur de date du champ personnalisé.

Valeur monétaire
currency_value double

Valeur monétaire du champ personnalisé.

Valeur booléenne
boolean_value boolean

Valeur booléenne du champ personnalisé.

Valeur d’entrée de table
codetableentry_value string

Valeur d’entrée de table du champ personnalisé.

Valeur d’ID constituante
constituentid_value string

Valeur d’ID constituante du champ personnalisé.

Jour
fuzzydate_value.d integer

Jour de la date floue.

month
fuzzydate_value.m integer

Mois à la date approximative.

année
fuzzydate_value.y integer

L’année dans la date approximative.

Date
date date

Date du champ personnalisé.

Commentaire
comment string

Commentaire sur le champ personnalisé. Limite de caractères : 50.

Date d’ajout
date_added date-time

Date de création du champ personnalisé.

Date de modification
date_modified date-time

Date de dernière modification du champ personnalisé.

OpportunityApi.OpportunityRead

Opportunité

Nom Chemin d’accès Type Description
ID
id string

ID d’enregistrement système de l’opportunité.

ID constituant
constituent_id string

ID d’enregistrement système de la constituante associée à l’opportunité.

Objectif
purpose string

Utilisation prévue pour toute somme levée suite à l’opportunité.

Nom
name string

Nom qui identifie l’opportunité tout au long du programme, par exemple dans les listes ou dans les dossiers constituants. Limite de caractères : 255.

Statut
status string

Le statut qui indique où se trouve l’opportunité dans le processus de sollicitation.

Échéance
deadline date-time

Date d’objectif pour l’occasion de donner un cadeau.

Demander la date
ask_date date-time

Date à laquelle la sollicitation a été faite.

value
ask_amount.value double

Valeur monétaire.

Date attendue
expected_date date-time

Date à laquelle la perspective devrait donner suite à l’opportunité.

value
expected_amount.value double

Valeur monétaire.

Date de financement
funded_date date-time

Date à laquelle la perspective a donné suite à l’opportunité.

value
funded_amount.value double

Valeur monétaire.

ID de campagne
campaign_id string

ID d’enregistrement système de la campagne associée à l’opportunité. La campagne définit les objectifs globaux de collecte d’argent.

ID du fonds
fund_id string

ID d’enregistrement système du fonds associé à l’opportunité. Le fonds désigne l’objectif financier spécifique d’un cadeau et identifie le compte financier de ce cadeau.

Collecte de fonds
fundraisers array of OpportunityApi.Fundraiser

Ensemble d’ID d’enregistrement système pour les collectes de fonds affectées à l’opportunité.

Inactif?
inactive boolean

L’opportunité est-elle inactive ?

linked_gifts
linked_gifts array of string

Le système enregistre les ID des cadeaux liés à l’opportunité.

Date d’ajout
date_added date-time

Date de création de l’opportunité.

Date de modification
date_modified date-time

Date de la dernière modification de l’opportunité.