Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilisation d'un CRM antérieur avec intégration Amazon S3
**Important**
AWS Partner Central a cessé d'accepter de nouvelles demandes pour ce type d'intégration en 2024. Cette section s'applique uniquement aux partenaires utilisant Amazon S3.
Pour commencer à utiliser une nouvelle intégration CRM personnalisée, consultez le manuel [AWS Partner Central API Reference](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html).
**Topics**
+ [Mise à niveau d'un CRM avec intégration Amazon S3 vers l'API Partner Central](upgrade-crm-api.md)
+ [Configuration du connecteur pour un CRM avec intégration Amazon S3](s3-config.md)
+ [Ressources d'intégration](resources.md)
+ [Partage de prospects](custom-lead-sharing.md)
+ [Partage d'opportunités](custom-opportunity-sharing.md)
+ [Cartographie des champs](custom-field-mapping.md)
+ [Création de plannings de synchronisation](crm-connector-scheduling.md)
+ [Bonnes pratiques](best-practices.md)
+ [Quotas](quotas.md)
+ [Historique des versions](version-history.md)
+ [FAQs](faqs.md)
# Mise à niveau d'un CRM avec intégration Amazon S3 vers l'API Partner Central
**Note**
Les rubriques de cette section supposent que vous avez rempli les conditions requises pour une intégration AWS Partner Central, une intégration AWS Marketplace, ou les deux. Pour plus d'informations, reportez-vous à [Prérequis pour l'intégration](crm-integration-setting-up.md) la section [Prise en main](crm-integration-getting-started.md) précédente de ce guide.
Les étapes décrites dans les sections suivantes expliquent comment passer d'un CRM antérieur intégrant Amazon S3 à l'API AWS Partner Central. La mise à niveau élimine le besoin de répondre à plusieurs exigences ACE, telles que le besoin d'un utilisateur d'intégration et la nécessité de configurer des calendriers de synchronisation.
**Topics**
+ [Caractéristiques de mise à niveau](api-upgrade-features.md)
+ [Configurer des informations d'identification nommées](set-up-api-credentials.md)
+ [Ajoutez le bouton État d'approbation à la page Opportunity Lightning Record](add-approval-status-button.md)
+ [Ajoutez les boutons restants](add-remaining-buttons.md)
+ [Actualisez l'onglet Offres de solutions](refresh-the-solutions-from-the-solution-offerings-tab.md)
# Caractéristiques de mise à niveau
La mise à niveau fournit les fonctionnalités suivantes :
+ Vous n'avez plus besoin d'un ensemble d'autorisations utilisateur pour l'intégration ACE dans Salesforce.
+ Il n'est plus nécessaire de créer un calendrier pour les opportunités ACE dans Salesforce.
+ L'API Partner Central fournit également un ensemble de boutons qui permettent d'effectuer les actions suivantes sur votre page **Opportunity Lightning Record** :
+ **État d'approbation** — Acceptez ou rejetez AWS les opportunités recommandées.
**Note**
Ce bouton remplace la liste des **statuts d'acceptation des partenaires**. Vous devez utiliser le bouton pour accepter les opportunités AWS créées.
+ **Partager avec AWS** — Créez et mettez à jour des opportunités.
+ **Associer ou dissocier : associez** ou dissociez une opportunité aux solutions, AWS produits et AWS Marketplace offres des partenaires tout au long du cycle de vie de l'opportunité.
+ **Attribuer** : réattribuez une opportunité à un autre utilisateur de votre compte Partner Central.
Vous ajoutez les boutons après avoir configuré des informations d'identification nominatives. Les rubriques suivantes expliquent comment effectuer ces tâches.
# Configurer des informations d'identification nommées
Pour passer à l'API Partner Central, vous devez d'abord configurer des informations d'identification nominatives. Le connecteur CRM utilise les informations d'identification de votre organisation Salesforce pour s'authentifier auprès de Partner Central.
**Pour configurer les informations d'identification**
1. Connectez-vous à Salesforce en tant qu'administrateur système.
1. Sous **Informations d'identification nommées**, sélectionnez **Nouveau plus tôt**.
1. Dans le formulaire **Nouvel identifiant nommé**, entrez les valeurs du tableau suivant.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/set-up-api-credentials.html)
1. Choisissez **Enregistrer**.
1. Retournez à la page **de configuration AWS guidée**. Dans la section **Détails de l'authentification**, choisissez **Vérifier** et confirmez les informations d'identification.
# Ajoutez le bouton État d'approbation à la page Opportunity Lightning Record
Les étapes suivantes expliquent comment ajouter le bouton **État d'approbation** à votre page Opporuntiy Lightning Record. Le bouton vous permet de voir le statut de vos opportunités au fur et à mesure qu'elles passent par le processus d'approbation.
**Pour ajouter le bouton**
1. Connectez-vous à votre organisation Salesforce en tant qu'administrateur système.
1. Accédez à la page **Opportunity Lightning Record**.
1. Choisissez le panneau surligné pour ouvrir le volet des propriétés.
1. Sélectionnez **Mettre à niveau maintenant**.
1. Sélectionnez **Migrer les actions existantes**, puis sélectionnez la mise en page à partir de laquelle vous souhaitez mettre à niveau les actions.
—OU—
Partez de zéro et ajoutez les actions manuellement.
1. Dans la liste **Actions**, sélectionnez **État d'approbation**.
1. Choisissez **Enregistrer**.
**Note**
Vous ne devez effectuer les étapes 4 et 5 qu'une seule fois.
Le bouton **État d'approbation** apparaît uniquement sur la page **Opportunity Lightning Record** pour les opportunités AWS recommandées.
# Ajoutez les boutons restants
Vous pouvez ajouter certains ou tous les boutons répertoriés dans les étapes suivantes.
**Pour ajouter les boutons**
1. Connectez-vous à votre organisation Salesforce en tant qu'administrateur système.
1. Accédez à la **page d'enregistrement d'Opportunity Lightning**.
1. Choisissez le panneau surligné pour ouvrir le volet des propriétés.
1. **Choisissez Affecter dans Actions**, puis sélectionnez certains ou tous les éléments suivants :
+ **Partagez avec AWS**
+ **Associer ou dissocier**
+ **Attribuer**
Pour plus d'informations sur le rôle de chaque bouton, reportez-vous à la [Caractéristiques de mise à niveau](api-upgrade-features.md) section précédente de ce guide.
1. Choisissez **Enregistrer**.
# Actualisez l'onglet Offres de solutions
Les étapes suivantes expliquent comment actualiser les données dans l'onglet **Offres de solutions**.
1. Connectez-vous à votre organisation Salesforce en tant qu'administrateur système.
1. Accédez à l'onglet **Offres de solutions**.
1. Sélectionnez **Actualiser les solutions**.
# Configuration du connecteur pour un CRM avec intégration Amazon S3
**Important**
À partir de 2024, AWS Partner Central a rendu ce type d'intégration inaccessible aux nouveaux utilisateurs.
**Note**
Les rubriques de cette section supposent que vous avez rempli les conditions requises pour une intégration AWS Partner Central, une intégration AWS Marketplace, ou les deux. Pour plus d'informations, reportez-vous à [Prérequis pour l'intégration](crm-integration-setting-up.md) la section [Prise en main](crm-integration-getting-started.md) précédente de ce guide.
Le CRM obsolète avec intégration Amazon S3 utilise un compartiment Amazon S3 pour transférer les prospects et les opportunités. Nous vous recommandons d'utiliser l'intégration de l'API Partner Central comme indiqué dans la section précédente pour créer et gérer des opportunités. Toutefois, vous pouvez utiliser cette configuration si vous souhaitez utiliser le connecteur pour gérer les prospects dans Salesforce.
**Topics**
+ [Saisie des informations d'authentification de connexion](#apn-s3-authentication-details)
+ [Saisie des paramètres de configuration du système](#apn-s3-config-settings)
+ [Test de la connexion](#apn-s3-testing)
+ [Envoyer et recevoir des opportunités et des prospects](#sending-receiving-opportunities-leads)
+ [Liste de contrôle de production](ace-production-checklist.md)
+ [Mise à niveau du connecteur AWS Partner CRM vers le nouveau modèle de données](connector-upgrade-plan.md)
+ [Tests en bac à sable avec les objets ACE Opportunity et ACE Lead personnalisés](custom-ace-opportunity.md)
+ [Lier les offres AWS Marketplace privées aux opportunités ACE](#linking-private-offers-to-ace)
## Saisie des informations d'authentification de connexion
Les partenaires démarrent le processus d'intégration en saisissant les informations nécessaires pour se connecter à leur point de terminaison Amazon S3. Suivez chaque série d'étapes dans l'ordre indiqué et terminez chaque série avant de passer à la suivante.
Les tâches suivantes sont effectuées à partir de l'onglet de **configuration AWS guidée**. Pour plus d'informations sur l'utilisation de l'onglet, reportez-vous à la section [Utilisation de la configuration guidée](use-guided-setup.md) précédente de ce guide.
**Pour saisir les informations d'authentification**
1. Dans Salesforce, ouvrez l'onglet de **configuration AWS guidée**. Pour plus d'informations sur l'ouverture de cet onglet, reportez-vous à la section [Utilisation de la configuration guidée](use-guided-setup.md) précédente de ce guide.
1. Développez **Étape 1 : détails de l'authentification de AWS connexion** et choisissez **Démarrer.**
1. Sur la page **Informations d'identification nommées**, choisissez **Nouveau plus tôt**.
1. Dans le formulaire **Nouvel identifiant nommé**, entrez les valeurs du tableau suivant.
| **Champ** | **Valeur** |
| --- | --- |
| Étiquette | Connexion API APN |
| URL | [https://s3.us-west-2.amazonaws.com](https://s3.us-west-2.amazonaws.com) |
| Type d'identité | Principal nommé |
| Protocole d'authentification | AWS version 4 de signature |
| AWS ID de clé d'accès | Cloud-Ops fournit l'identifiant lors des étapes préalables |
| AWS clé d'accès secrète | Cloud-Ops fournit la clé d'accès lors des étapes préalables |
| AWS Région | us-west-2 |
| AWS web | s3 |
| Générer un en-tête d'autorisation | checked |
| Autoriser les champs de fusion dans l'en-tête HTTP | incontrôlé |
| Autoriser les champs de fusion dans le corps HTTP | incontrôlé |
1. Choisissez **Enregistrer**.
1. Retournez à la page **de configuration AWS guidée**. Dans la section **Détails de l'authentification**, choisissez **Vérifier** et confirmez les informations d'identification.
1. Gardez la page de **configuration AWS guidée** ouverte et passez aux étapes suivantes.
## Saisie des paramètres de configuration du système
Les étapes suivantes expliquent comment saisir les paramètres de configuration système appropriés pour l'intégration.
1. Développez **l'étape 2 : Paramètres de configuration du système** et choisissez **Démarrer.**
1. Localisez les **paramètres du connecteur AWS Partner CRM**, puis choisissez **Gérer**.
1. Choisissez **Nouveau**, puis entrez les valeurs requises dans le tableau suivant.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/s3-config.html)
1. Choisissez **Enregistrer**.
1. Retournez à la page **de configuration AWS guidée**. Dans la section **Détails de l'authentification**, choisissez **Vérifier** et confirmez les informations d'identification.
## Test de la connexion
Avant de tester la connexion, assurez-vous de suivre les étapes décrites dans les sections précédentes.
**Pour tester la connexion**
1. Étendre **l'étape 3 : tester la configuration de l'API APN.**
1. Sélectionnez **Tester)**.
Si la connexion aboutit, vous recevez un message de confirmation.
## Envoyer et recevoir des opportunités et des prospects
Vous envoyez et recevez des opportunités et des prospects en les synchronisant avec Partner Central. Pour synchroniser une opportunité ou un prospect, vous devez définir le champ **Synchroniser avec Partner Central** sur **True**. Les champs clés supplémentaires pour l'intégration incluent la **date de dernière synchronisation APN** et les champs **éligibles à la synchronisation avec l'APN.**
Ces champs sont inclus pour les opportunités et les prospects standard. Toutefois, vous devez les créer et les mapper pour tous les objets source personnalisés.
+ **Synchronisation avec Partner Central** : incluse dans l'application pour les opportunités et les prospects standard. Si un AWS Partner choisit de mapper vers des objets personnalisés, un champ booléen personnalisé doit être créé et mappé dans les mappages d'opportunités et de prospects, respectivement.
+ **Date de dernière synchronisation avec APN** — Indique la dernière fois que l'enregistrement a été envoyé ou reçu avec succès par APN. Ce champ est défini automatiquement lorsque l'enregistrement est envoyé avec succès à l'APN ou qu'une mise à jour est reçue de l'APN.
+ **Éligibilité à la synchronisation avec l'APN** : champ de formule qui détermine si l'enregistrement est destiné à être envoyé à l'APN lors de la prochaine tâche planifiée. Calculé en fonction du fait que l'enregistrement a été modifié depuis la dernière exécution du calendrier de sortie et qu'il a été mis à jour par un utilisateur autre que l'utilisateur d'intégration désigné pour AWS Partner l'organisation.
# Liste de contrôle de production
Suivez ces étapes pour terminer l'installation de production de votre connecteur AWS Partner CRM.
1. Confirmez que vous avez terminé le [processus d'intégration](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-getting-started.html) pour l'intégration CRM. Au cours de l'[étape 6](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) de ce processus, vous configurez votre environnement de production et effectuez la migration des données afin de pouvoir gérer les opportunités et les prospects tout au long de l'intégration.
1. Installez et configurez le connecteur CRM. Pour plus d’informations, consultez [Installation du connecteur](install-connector.md).
1. Cartographiez les opportunités et les objets principaux en choisissant l'une des options de mappage suivantes. Pour référence, consultez cette liste de [champs obligatoires](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) sur GitHub.
+ Utilisez l'objet personnalisé AWS ACE Opportunity fourni avec le connecteur AWS Partner CRM pour enregistrer les opportunités et les partager avec elles AWS. Cette option vous permet de mapper automatiquement AWS les champs aux champs Salesforce.
+ Utilisez l'objet Salesforce standard et mappez les AWS champs obligatoires.
+ Utilisez un objet d'opportunité personnalisé ACE. Vous créez d'abord un flux de travail pour remplir un tableau intermédiaire des objets d'opportunité ACE, puis vous mappez les champs Salesforce avec. AWS
1. Pour plus de détails et des conseils sur les options de mappage, reportez-vous à[Cartographie des objets ACE](crm-connector-mapping.md).
1. (Facultatif) Configurez des calendriers de synchronisation entrante et sortante entre le AWS Partner réseau et Salesforce. Pour plus de détails, reportez-vous à[Création de plannings de synchronisation](crm-connector-scheduling.md).
1. Pour valider une opportunité créée par un partenaire en production, soumettez un [dossier d'assistance](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-faq.html#troubleshooting) auprès de Partner Central Operations (PCO) sur votre compte Partner Central. Au cours de ce processus, vous créez une opportunité fictive, vous la synchronisez avec AWS et demandez à l'agent de AWS support de confirmer qu'elle a bien AWS reçu l'opportunité. À la fin du test, demandez à votre agent de AWS support de rejeter la demande d'opportunité afin de pouvoir la supprimer de votre côté.
1. (Facultatif) Effectuez le remblayage des données. Ce processus garantit que les opportunités proposées par AWS le partenaire et celles proposées par le partenaire pourront être identifiées lors des futures mises à jour. Pour plus d'informations, reportez-vous à l'[étape 6 : approbation de la production](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) dans le processus d'intégration du CRM.
1. Activez l'intégration de production pour permettre l'échange de fichiers via le compartiment Amazon S3. Pour plus de détails, reportez-vous à [Étape 7 : Lancement](https://docs.aws.amazon.com/partner-central/latest/crm/stage-7-launch.html).
# Mise à niveau du connecteur AWS Partner CRM vers le nouveau modèle de données
**Important**
Testez et approuvez la mise à niveau du nouveau modèle de données dans votre organisation Salesforce sandbox avant de mettre à niveau votre environnement de production. Pour le nouveau modèle de données et les modifications entre l'ancien et le nouveau modèle, reportez-vous au document [partner-crm-integration-samplesaws-samples/](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/opportunity-samples) on suivant : GitHub
**Opportunité- FieldsAndStandardValues - DiffWithPrevVersion -v14.3.xlsx**
**Opportunity-Fields.xlsx**
**Opportunité\$1-\$1 .xlsx StandardValues**
## Conditions préalables
+ Utilisez les définitions de champs pour les nouvelles directives relatives au modèle de données relatives à l'intégration d'ACE CRM, et migrez les opportunités ouvertes et les prospects requis vers le nouveau modèle de données.
+ Ajoutez ou supprimez des colonnes dans vos objets personnalisés ou standard (objets utilisés dans le mappage).
+ Assurez-vous d'utiliser la version 2.0 ou ultérieure du connecteur AWS Partner CRM.
**Pour passer au nouveau modèle de données**
1. Connectez-vous à votre organisation Salesforce en tant qu'administrateur système.
1. Désactivez tous les programmes actifs.
1. Choisissez **Configuration**, **Paramètres personnalisés, Paramètres** **du connecteur AWS Partner CRM**, puis mettez à jour la version vers la version **2.0** ou ultérieure.
**Note**
À partir de la version 2.0, le champ **Version** est obligatoire. Ce champ indique la version de charge utile utilisée par les partenaires pour interagir avec l'intégration CRM. Lorsque les partenaires passent à la version 2.0, ils doivent en adopter pleinement les spécifications. Il n'est pas permis de revenir aux versions précédentes.
1. Choisissez l'onglet **ACE Mapping**.
1. Créez, révisez et mettez à jour tous les mappages de champs et les détails requis. Pour les tests en sandbox, utilisez l'opportunité ACE personnalisée et l'objet principal ACE pour tester les nouvelles fonctionnalités du modèle de données. Pour plus d’informations, consultez [Tests en bac à sable avec les objets ACE Opportunity et ACE Lead personnalisés](custom-ace-opportunity.md).
1. Activez les plannings pour les opportunités et les prospects.
1. Consultez les journaux de synchronisation ACE pour détecter les erreurs de synchronisation et apportez les corrections nécessaires.
1. Passez en revue les opportunités et les prospects synchronisés pour vous assurer que la transformation des données est précise. Vous pouvez également examiner les opportunités et les pistes dans ACE pour vous assurer que les modifications du nouveau modèle de données sont capturées avec précision.
1. Suivez le processus de déploiement de votre produit pour migrer les modifications vers votre environnement de production Salesforce.
**Note**
Si vous avez besoin d'aide, reportez-vous à[Obtenir de l'aide](getting-help.md).
# Tests en bac à sable avec les objets ACE Opportunity et ACE Lead personnalisés
**Note**
Si vous utilisez déjà le connecteur CRM, reportez-vous à[Mise à niveau du connecteur AWS Partner CRM vers le nouveau modèle de données](connector-upgrade-plan.md).
1. Connectez-vous à votre organisation Salesforce en tant qu'administrateur système.
1. Choisissez **Configuration**, **Paramètres personnalisés, paramètres** **du connecteur AWS Partner CRM** et mettez à jour la version vers **2**.
1. Choisissez l'onglet **ACE Mapping**.
1. Pour **Opportunity**, associez-le à l'objet personnalisé **ACE Opportunity**.
1. Choisissez l'**objet Auto Map ACE**.
**Note**
Si vous souhaitez passer à la nouvelle version du connecteur CRM qui souhaite utiliser l'opportunité ACE personnalisée et les objets principaux ACE du connecteur pour les tests en sandbox, nous vous recommandons de supprimer manuellement tous les enregistrements disponibles de la base de données `Field Mappings` et les `Field Mapping Details` objets disponibles avant d'utiliser la fonctionnalité Auto Map ACE des objets. Vous n'avez besoin de le faire qu'une seule fois.
1. Passez en revue les mappages de champs et les valeurs de mappage de champs pour les listes de sélection et les listes de sélection multiples.
1. Activez les plannings pour les opportunités et les prospects.
1. Consultez les journaux ACE Sync pour détecter les erreurs de synchronisation et apportez les corrections nécessaires.
1. Passez en revue les opportunités et les prospects synchronisés pour vous assurer que la transformation des données est précise. Vous pouvez également examiner les opportunités et les pistes dans ACE pour vous assurer que les modifications du nouveau modèle de données ont été correctement capturées.
## Affichage des enregistrements détaillés du journal de synchronisation pour les opportunités ACE
Vous pouvez consulter les détails du journal de synchronisation pour les opportunités ACE AWS fournies dans l'onglet **Associé** de l'enregistrement des opportunités ACE.
**Note**
Ces étapes s'appliquent uniquement aux objets d'opportunité ACE AWS fournis. Si vous mappez des objets standard ou personnalisés dans votre organisation Salesforce, vous pouvez consulter les détails du journal de synchronisation dans l'onglet **ACE Sync Log**.
1. Connectez-vous à votre organisation Salesforce.
1. Dans le **lanceur d'applications**, choisissez le **connecteur AWS Partner CRM**.
1. Choisissez l'onglet **ACE Opportunities**.
1. Choisissez un enregistrement d'opportunité ACE.
1. Choisissez l'onglet **Associé** pour afficher les détails, notamment le **nom du journal de synchronisation**, **le statut**, le **message d'erreur** et la **date de création**.
## Lier les offres AWS Marketplace privées aux opportunités ACE
Vous pouvez lier les offres privées directement à partir de la page d'enregistrement des opportunités ACE AWS livrée.
1. Connectez-vous à votre organisation Salesforce.
1. Dans le **lanceur d'applications**, choisissez le **connecteur AWS Partner CRM**.
1. Choisissez l'onglet **ACE Opportunities**.
1. Choisissez un enregistrement d'opportunité ACE.
1. Choisissez **Link Private Offer**.
1. Dans **Offer ID Look Up**, choisissez l'offre privée.
1. Choisissez **Enregistrer**.
# Ressources d'intégration
AWS fournit les ressources suivantes pour vous aider à créer une intégration personnalisée.
**Topics**
+ [Définitions de champs](#custom-field-definitions)
+ [Valeurs standard](#standard-values)
+ [Exemples de fichiers entrants](#sample-inbound-files)
+ [Exemples de fichiers sortants](#sample-outbound-files)
+ [Exemples de résultats traités](#sample-processed-results)
+ [Exemples de cas de test](#sample-test-cases)
+ [Exemples d'extraits de code](#sample-code-snippets)
## Définitions de champs
Les liens des sections suivantes répertorient tous les champs, en expliquant leurs types de données, leur utilisation, ainsi que les contraintes ou règles de formatage applicables. Ils servent de référence pour garantir que lorsque des partenaires AWS échangent des données, celles-ci sont correctement formatées et comprises.
Les liens suivants vous redirigent vers GitHub.
+ [Opportunité](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [Plomb](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Valeurs standard
Ces listes présentent les valeurs standard et les énumérations pour les différents champs. Ils contribuent à maintenir la cohérence des données échangées et à garantir que les deux parties ont une compréhension commune des valeurs utilisées.
Les liens suivants vous redirigent vers GitHub.
+ [Opportunité](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity_-_StandardValues.csv)
+ [Plomb](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead_-_StandardValues.csv)
## Exemples de fichiers entrants
Les exemples de fichiers suivants montrent la structure de la charge utile JSON d'un fichier envoyé par un partenaire à AWS.
Les liens suivants vous redirigent vers GitHub.
+ [Opportunité](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Create-Inbound-Sample.json)
+ [Plomb](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Update-Inbound-Sample.json)
## Exemples de fichiers sortants
Les exemples de fichiers suivants montrent la structure de la charge utile JSON d'un fichier envoyé AWS à un partenaire.
Les liens suivants vous redirigent vers GitHub.
+ [Opportunité](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)
+ [Plomb](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Outbound-Sample.json)
## Exemples de résultats traités
Les fichiers suivants montrent un résultat typique après le traitement AWS d'une charge utile envoyée par un partenaire.
Les liens suivants vous redirigent vers GitHub.
+ [Opportunité](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Plomb](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
## Exemples de cas de test
Les liens suivants vous redirigent vers GitHub.
+ [Opportunité](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity%20-%20Testing%20Scenarios.xlsx)
+ [Plomb](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead%20-%20Testing%20Scenarios.xlsx)
## Exemples d'extraits de code
Les liens suivants vous redirigent vers GitHub.
+ [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ [APEX\$1SAMPLE\$1REST\$1 ode.cls API\$1C](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ [S3\$1Authentification.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ [Échantillon\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ [SFDC Apex S3 sample.txt](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/SFDC_apex_s3_sample.txt)
+ [APEX\$1Get\$1Files\$1From\$1S3\$1ACE\$1Partner\$1Test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_get_files_from_s3_ace_partner_test.cls)
+ [s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/s3_ace_partner_test.cls)
# Partage de prospects
## Comment AWS partage les prospects
1. **Exportations incrémentielles** : Amazon Web Services (AWS) exporte les nouveaux prospects (et les mises à jour) auxquels AWS il est fait référence, sur une base horaire.
1. **Création de fichiers** : AWS génère des fichiers principaux conformes à un format spécifique. Pour les spécifications détaillées des fichiers, reportez-vous à[Définitions de champs](resources.md#custom-field-definitions).
1. **Téléchargement de fichiers** : les fichiers principaux sont chargés `lead-outbound` dans le dossier.
## Consommer des prospects provenant de AWS
Pour utiliser efficacement les prospects AWS, créez une intégration personnalisée avec les fonctionnalités suivantes.
1. **Récupération de fichiers** :
+ Scannez régulièrement le `lead-outbound` dossier à l'aide d'une tâche planifiée à un intervalle de votre choix.
+ Récupérez les fichiers principaux pour les traiter.
1. **Transformation et cartographie des données** :
+ Après avoir lu le contenu de chaque fichier, transformez et associez les données aux enregistrements des prospects dans votre système de gestion de la relation client (CRM).
+ Pour obtenir des conseils sur la cartographie des champs, reportez-vous à[Cartographie des champs](custom-field-mapping.md).
1. **Identification du prospect** :
+ Identifiez de manière unique chaque prospect à l'aide de l'un `partnerCrmLeadId` ou de l'autre`apnCrmUniqueIdentifier`.
+ Si `partnerCrmLeadId` ce champ est vide et `apnCrmUniqueIdentifier` qu'il est présent, le prospect est une nouvelle recommandation de AWS Partner Network (APN) Customer Engagement (ACE).
+ Si les deux identifiants sont présents, l'enregistrement est traité comme une mise à jour provenant d'ACE.
1. **Ingestion de plomb** :
+ Ingérez de nouveaux prospects ou mettez à jour les prospects existants dans le système CRM.
1. **Gestion des fichiers** :
+ Après avoir traité avec succès chaque prospect et les données complètes du fichier, supprimez les fichiers du dossier sortant.
+ Chaque fichier est automatiquement archivé dans le `lead-outbound-archive` dossier.
**Intégration et référence au code** :
+ Pour lire les fichiers chargés dans le compartiment Amazon Simple Storage Service (Amazon S3), vous pouvez AWS Lambda utiliser ou lire directement depuis votre système CRM.
+ Utilisez les exemples de codes ci-dessous pour Lambda et l'API REST Salesforce afin de valider et de mettre à jour les enregistrements CRM.
+ **Lambda pour valider les fichiers** [: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ **API REST Salesforce** : [API\$1CAPEX\$1Sample\$1REST\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls) ode.cls.
+ Si vous utilisez un système CRM autre que Salesforce, vous devez fournir un code spécifique à votre système pour mettre à jour vos données.
## Partage de mises à jour sur les prospects avec AWS
1. **Identifiez les prospects** : localisez les prospects avec des mises à jour à partager avec AWS.
1. **Transformation des** données : convertissez les données AWS au format indiqué dans[Définitions de champs](resources.md#custom-field-definitions).
1. **Création de fichiers** :
+ Générez des fichiers de prospects au format JSON.
+ Ajoutez un horodatage à chaque fichier, en vous assurant que tous les noms de fichiers sont uniques et suivent le format :. `{name}_MMDDYYYY24HHMMSS.json`
1. **Authentifiez-vous et téléchargez** :
+ Authentifiez-vous auprès du compartiment ACE Amazon S3.
+ Téléchargez le fichier `lead-inbound` dans le dossier. Tous les fichiers partagés avec AWS sont automatiquement archivés dans le `lead-inbound-archive` dossier.
+ Lorsque vous chargez des fichiers sur S3, assurez-vous de fournir un accès complet au propriétaire du compartiment.
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
Consultez un exemple de résultat de l'exécution de cette commande dans [« Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json) ».
1. **Traitement des fichiers** :
+ Dès réception, traite AWS automatiquement les fichiers.
+ Les résultats du traitement sont chargés dans le `lead-inbound-processed-results` dossier du compartiment Amazon S3. Cela inclut l'état des réussites et des erreurs, ainsi que les éventuels messages d'erreur pour chaque prospect.
+ Ces résultats traités sont également archivés dans le `lead-inbound-processed-results-archive` dossier.
+ Pour plus d'informations, reportez-vous au[FAQ technique : pistes et opportunités](technical-faq-leads-and-opps.md).
1. **Gestion des réponses** :
+ Vous devez développer une logique pour utiliser ces réponses, examiner les enregistrements erronés, corriger les erreurs et renvoyer les données à ACE.
+ Vous trouverez des exemples d'erreurs dans les sections FAQ et Résolution des problèmes.
+ Pour charger un fichier sur Amazon S3 depuis le CRM, procédez comme suit :
+ Référencez la version de la AWS signature.
+ Utilisez une requête HTTPS pour télécharger le fichier.
+ À titre de référence, utilisez les fichiers suivants pour charger un fichier dans le compartiment Amazon S3 :
+ **[Pour authentifier un compartiment S3 : S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)**
+ **Pour télécharger des fichiers dans un compartiment S3** : [AceOutboundBatchSample\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) .cls
+ **REMARQUE :** La taille des fichiers ne doit pas dépasser 1 Mo et les fichiers dupliqués ne seront pas traités.
# Partage d'opportunités
## Comment AWS partage les opportunités
1. **Exportations incrémentielles** : Amazon Web Services (AWS) exporte les nouvelles opportunités (et mises à jour) référencées AWS, sur une base horaire.
1. **Création de fichiers** : AWS génère des fichiers d'opportunités conformes à un format spécifique. Pour les spécifications détaillées des fichiers, reportez-vous à la section [Définitions des champs Opportunité](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv).
1. **Téléchargement de fichiers** : les fichiers Opportunity sont chargés `opportunity-outbound` dans le dossier.
## Opportunités de consommation provenant de AWS
Pour exploiter efficacement les opportunités qui s'offrent à vous AWS, vous devez créer une intégration personnalisée avec ces fonctionnalités.
1. **Récupération de fichiers** :
+ Utilisez une tâche planifiée pour scanner régulièrement le `opportunity-outbound` dossier, à un intervalle de votre choix.
+ Récupérez les fichiers d'opportunités à traiter.
1. **Transformation et cartographie des données** :
+ Après avoir lu le contenu de chaque fichier, transformez et associez les données aux dossiers d'opportunités de votre système de gestion de la relation client (CRM).
+ Pour obtenir des conseils sur la cartographie des champs, reportez-vous à[Cartographie des champs](custom-field-mapping.md).
1. **Identification des opportunités** :
+ Identifiez de manière unique chaque opportunité à l'aide de l'un `partnerCrmOpportunityId` ou de l'autre`apnCrmUniqueIdentifier`.
+ Si `partnerCrmOpportunityId` ce champ est vide et `apnCrmUniqueIdentifier` qu'il est présent, l'opportunité est une nouvelle recommandation de AWS Partner Network (APN) Customer Engagement (ACE).
+ Si les deux identifiants sont présents, l'enregistrement est traité comme une mise à jour provenant d'ACE.
1. **Ingestion des opportunités** : Ingérez de nouvelles opportunités ou mettez à jour les opportunités existantes dans le système CRM.
1. **Gestion des fichiers** :
+ Après avoir traité avec succès chaque opportunité et les données complètes des fichiers, supprimez les fichiers du dossier sortant.
+ Chaque fichier est automatiquement archivé dans le `opportunity-outbound-archive` dossier.
**Intégration et référence au code** :
+ Pour lire les fichiers chargés dans le compartiment Amazon Simple Storage Service (Amazon S3), vous pouvez AWS Lambda utiliser ou lire directement depuis votre système CRM.
+ Utilisez les exemples de codes ci-dessous pour Lambda et l'API REST Salesforce afin de valider et de mettre à jour les enregistrements CRM.
+ **Lambda pour valider les fichiers** [: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ **API REST Salesforce** : [API\$1CAPEX\$1Sample\$1REST\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls) ode.cls.
+ Si vous utilisez un système CRM autre que Salesforce, vous devez fournir un code spécifique à votre système pour mettre à jour vos données.
## Partage de mises à jour sur les opportunités avec AWS
1. **Identifiez les opportunités** : localisez les opportunités avec des mises à jour à partager avec AWS.
1. **Transformation des** données : convertissez les données AWS au format indiqué dans[Définitions de champs](resources.md#custom-field-definitions).
1. **Création de fichiers** :
+ Générez des fichiers d'opportunités au format JSON.
+ Ajoutez un horodatage à chaque fichier, en vous assurant que tous les noms de fichiers sont uniques et suivent le format :. `{name}_MMDDYYYY24HHMMSS.json`
1. **Authentifiez-vous et téléchargez** :
+ Authentifiez-vous auprès du compartiment ACE Amazon S3.
+ Téléchargez le fichier `opportunity-inbound` dans le dossier. Tous les fichiers partagés avec AWS sont automatiquement archivés dans le `opportunity-inbound-archive` dossier.
+ Lorsque vous chargez des fichiers sur S3, assurez-vous de fournir un accès complet au propriétaire du compartiment :
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
Consultez un exemple de résultat de l'exécution de cette commande dans [Opportunity Results Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json).
1. **Traitement des fichiers** :
+ Dès réception, traite AWS automatiquement les fichiers.
+ Les résultats du traitement sont chargés dans le `lead-inbound-processed-results` dossier du compartiment Amazon S3. Cela inclut l'état des réussites et des erreurs, ainsi que les éventuels messages d'erreur pour chaque opportunité.
+ Ces résultats traités sont également archivés dans le `opportunity-inbound-processed-results-archive` dossier.
+ Pour plus d'informations, reportez-vous au[FAQ technique : pistes et opportunités](technical-faq-leads-and-opps.md).
1. **Gestion des réponses** :
+ Vous devez développer une logique pour utiliser ces réponses, examiner les enregistrements erronés, corriger les erreurs et renvoyer les données à ACE.
+ Vous trouverez des exemples d'erreurs dans les sections FAQ et Résolution des problèmes.
+ Pour charger un fichier sur Amazon S3 depuis le CRM :
+ Référencez la version de la AWS signature.
+ Utilisez une requête HTTPS pour télécharger le fichier.
+ À titre de référence, utilisez les fichiers suivants pour charger un fichier dans le compartiment Amazon S3 :
+ **[Pour authentifier un compartiment S3 : S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)**
+ **Pour télécharger des fichiers dans un compartiment S3** : [AceOutboundBatchSample\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) .cls
+ **REMARQUE :** La taille des fichiers ne doit pas dépasser 1 Mo et les fichiers dupliqués ne seront pas traités.
# Cartographie des champs
La cartographie des champs est une étape essentielle du processus d'intégration au cours de laquelle les partenaires alignent les champs de leur système de gestion de la relation client (CRM) sur ceux définis par Amazon Web Services (AWS). Cela garantit que les deux parties échangent et comprennent correctement les données. Vous trouverez ci-dessous des directives pour vous aider dans ce processus.
## Mappage des champs obligatoires
+ Associez chaque champ obligatoire au champ correspondant dans votre système CRM. Pour un échange de données réussi, il est essentiel de vous assurer que tous les champs obligatoires sont mappés. Pour plus d'informations, reportez-vous à [Définitions de champs](resources.md#custom-field-definitions)
+ [Opportunité](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [Plomb](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Gestion des champs facultatifs
+ Comprenez le rôle des champs facultatifs dans le processus d'intégration. Décidez si vous souhaitez mapper ces champs en fonction des besoins de votre entreprise, et soyez conscient des conséquences possibles s'ils ne sont pas mappés.
## Cartographie des valeurs
+ Alignez chaque valeur de champ de votre CRM avec la valeur de la liste d'engagement client (ACE) requise AWS Partner Network (APN), comme indiqué dans[Définitions de champs](resources.md#custom-field-definitions). Cela est important pour maintenir la cohérence et l'intégrité des données.
## Validation du type et du format des données
+ Vérifiez que les types de données et les formats des champs de votre système CRM correspondent à ceux spécifiés dans les *définitions des AWS champs*. Il est essentiel de maintenir la cohérence des types et des formats de données afin de prévenir la corruption des données et de garantir une intégration fluide.
## Longueur du champ et limites
+ Notez les restrictions relatives à la longueur des champs et autres limitations. Assurez-vous que les données de votre système CRM correspondent aux champs correspondants AWS sans être tronquées ni provoquer d'erreurs.
## Validation du type et du format des données
+ Vérifiez que les types et formats de données de terrain de votre système CRM correspondent à ceux spécifiés dans[Définitions de champs](resources.md#custom-field-definitions). Il est essentiel de prévenir la corruption des données et de garantir une intégration fluide avec une cohérence des types et des formats de données.
## Révision et mise à jour périodiques
+ Passez régulièrement en revue et mettez à jour vos mappages de champs pour tenir compte de l'évolution de votre système CRM ou de vos AWS exigences. Cette approche proactive garantit la précision et l'efficacité continues des échanges de données.
## Documentation de cartographie des champs
+ Maintenez une documentation complète sur la cartographie des champs. Cette pratique facilite le dépannage, les futures mises à jour et garantit la clarté de la manière dont les données sont transférées entre les systèmes.
## Tests et validation
+ Effectuez des tests de mappage de terrain approfondis pour valider que les données sont transférées et transformées avec précision. Corrigez immédiatement toute anomalie ou tout problème afin de garantir l'intégrité des données.
## Gestion des remplacements indésirables
+ Pour éviter que les AWS données ne remplacent des champs CRM spécifiques, tenez compte des points suivants :
+ Création d'un champ CRM personnalisé pour les données que vous souhaitez protéger.
+ Faire examiner ce champ personnalisé par un représentant commercial.
+ Une fois le champ personnalisé approuvé, ajoutez-le à l'enregistrement des opportunités et au pipeline.
+ Ceci est particulièrement important pour des domaines tels que le `MRR` ou`Stage`, surtout s'ils indiquent qu'un produit a été lancé.
## Gestion des dépendances en aval
+ Si certaines dépendances en aval de votre système reposent sur l'échange de données, tenez compte des points suivants :
+ Création de nouveaux champs dans votre CRM pour accueillir les AWS données.
+ Réaligner vos processus métier selon les besoins pour garantir une intégration et un flux de données fluides.
# Création de plannings de synchronisation
**Note**
Les rubriques de cette section supposent que vous avez rempli les conditions requises pour une intégration AWS Partner Central, une intégration AWS Marketplace, ou les deux. Pour plus d'informations, reportez-vous à [Prérequis pour l'intégration](crm-integration-setting-up.md) la section [Prise en main](crm-integration-getting-started.md) précédente de ce guide.
Vous pouvez créer des plannings de synchronisation entrants et sortants entre Salesforce et AWS Partner Central. Les étapes décrites dans les sections suivantes expliquent comment procéder.
**Topics**
+ [Prérequis](#scheduling-prerequisites)
+ [Création d'un calendrier](#creating-a-schedule)
+ [Désactivation d'une tâche planifiée](#deactivating-a-scheduled-job)
+ [Afficher tous les horaires](#viewing-all-schedules)
## Prérequis
Assurez-vous d'effectuer les opérations suivantes avant de créer un calendrier de synchronisation :
+ [Mappez](crm-connector-mapping.md) tous les champs obligatoires sur au moins un objet, une opportunité ou un prospect.
+ Créez un [utilisateur d'intégration du système](#system-integration-user) dans Salesforce.
### Création d'un utilisateur d'intégration du système
Avant de créer un calendrier de synchronisation, vous devez utiliser Salesforce pour créer un utilisateur d'intégration du système doté des autorisations d'intégration APN. Pour créer des plannings de synchronisation, vous devez vous connecter à Salesforce en tant qu'utilisateur de l'intégration du système. La création d'un calendrier sans les autorisations des utilisateurs d'intégration APN peut interrompre l'intégration APN.
**Pour créer un utilisateur d'intégration du système**
1. Connectez-vous à votre organisation Salesforce en tant qu'administrateur système.
1. Créez un utilisateur dans votre organisation Salesforce. Attribuez un profil à l'utilisateur ayant accès aux objets requis dans votre organisation Salesforce. Pour plus d'informations, reportez-vous à la section [Ajouter un seul utilisateur](https://help.salesforce.com/s/articleView?id=sf.adding_new_users.htm).
1. Attribuez à l'utilisateur l'ensemble d'autorisations **utilisateur d'intégration APN**. Pour plus d'informations, reportez-vous à la section [Attribuer un ensemble d'autorisations aux utilisateurs](https://help.salesforce.com/s/articleView?id=sf.assign_permission_set_to_user.htm).
## Création d'un calendrier
Une fois les [prérequis remplis](#scheduling-prerequisites), vous pouvez créer des plannings de synchronisation entre Salesforce et APN.
**Pour créer un calendrier de synchronisation avec APN**
1. Connectez-vous à Salesforce en tant qu'utilisateur disposant d'autorisations d'intégration au système.
1. Dans l'**onglet** Programmes, choisissez **Nouveau**.
1. Choisissez les objets à planifier. Vous pouvez configurer des plannings pour les prospects et les opportunités, ou pour un seul objet.
1. Choisissez la fréquence du programme, d'un minimum toutes les cinq minutes à un maximum d'une fois par jour.
1. Sélectionnez **Programme**.
**Note**
Un seul planning par objet peut être actif à la fois. La création d'un nouveau planning pour le même objet désactive le planning existant.
Pour désactiver l'intégration entrante lors de la création d'un calendrier, choisissez **Désactiver l'intégration entrante,** Planifier.
La création d'un calendrier sans les autorisations des utilisateurs d'intégration APN peut interrompre l'intégration APN.
## Désactivation d'une tâche planifiée
1. Sur la page **Planification**, choisissez **Désactiver toutes les tâches** pour désactiver les planifications actives.
1. Passez par l'écran de confirmation pour désactiver le calendrier de synchronisation.
## Afficher tous les horaires
Dans l'onglet **Planifications**, utilisez les filtres d'affichage de liste pour basculer entre les planifications **actives**, **inactives** et **toutes les planifications de synchronisation**.
# Bonnes pratiques
Utilisez ces meilleures pratiques pour optimiser le développement et la maintenance de votre intégration personnalisée.
## Bonnes pratiques d'ordre général
1. Mappez tous les champs *obligatoires* car ils sont obligatoires dans le formulaire de soumission AWS Partner Network (APN) Customer Engagement (ACE).
1. Connectez-vous à votre utilisateur actuel d'ACE Pipeline Manager pour comprendre à quoi ressemble le processus. Capturez toutes processes/field les utilisations uniques afin de pouvoir les intégrer à votre expérience.
1. Envisagez de créer des étapes de pipeline de ventes distinctes pour les étapes de vente déclarées par Amazon Web Services (AWS) (exemple : étape, date de clôture cible, AWS chiffre d'affaires mensuel attendu, prochaines étapes). Si nous avons des définitions d'étapes différentes, il est possible que nous remplacions vos étapes de vente. Lorsque vous créez des étapes de vente distinctes, cela vous permet de gérer votre pipeline de manière appropriée, tout en gardant une visibilité sur ce qui AWS est projeté.
1. Pour les opportunités recommandées par des partenaires, l'équipe ACE doit approve/reject les obtenir avant d'accepter toute mise à jour.
1. Pour les opportunités AWS référées, le partenaire doit les accepter ou les rejeter.
## Protocoles d'échange de données
1. **Conventions de saisie** : séparez les entrées de la liste de sélection multiple par des points-virgules et omettez les espaces.
1. **Attention portée aux détails** : les noms et les valeurs des champs distinguent les majuscules des minuscules, donc veillez à ce qu'ils soient précis.
1. **Procédures de suppression** : exécutez la suppression du champ en transmettant `null` la valeur du champ choisi.
1. **Synchronisation** : les processus de synchronisation fonctionnent toutes les heures, ce qui peut entraîner des retards dans les réflexions sur les données. Les mises à jour AWS peuvent prendre jusqu'à une heure pour être prises en compte dans le système de gestion de la relation AWS client (CRM). Évitez d'envoyer plusieurs documents par heure.
## Bonnes pratiques spécifiques au domaine
1. **Modifications entrantes** : pour protéger l'intégrité de vos données, désactivez les modifications pour les champs tels que `stage``closedDate`, et`closedLostReason`. Pour suivre AWS les valeurs sans affecter vos valeurs Salesforce locales, utilisez les champs en lecture seule suivants : `awsStage``awsCloseDate`, et. `awsClosedLostReason`
1. **Cartographie et validation des clients** : assurez-vous de l'exactitude du site Web du client, car c'est essentiel pour la cartographie AWS CRM. Associez-le au nom du client pour une meilleure cartographie des comptes CRM.
1. **Clarté de la description du projet** : fournissez une description claire détaillant les défis des clients et les alignements de solutions. AWS l'utilise pour valider l'opportunité.
1. **Provisionnement** : (Facultatif) Lorsque vous fournissez les coordonnées du client final, cela permet de AWS retracer les prospects et les campagnes. Cela conduit à des verdicts de financement renforcés.
## Bonnes pratiques supplémentaires
1. Respectez les dernières directives de définition des champs de charge utile.
1. Maintenez la cohérence de la dénomination des compartiments sandbox avec le format spécifié.
1. Utilisez le modèle de dénomination recommandé pour le bucket de production.
1. Donnez la priorité aux tests de l'environnement sandbox avant le déploiement en direct.
1. Conservez des identifiants distincts pour les enregistrements entre AWS et partenaires CRMs.
1. Après le traitement, supprimez les fichiers du dossier sortant Amazon Simple Storage Service (Amazon S3). Les originaux sont conservés dans les archives.
1. Pour éviter les erreurs, configurez les validations au niveau des champs à la source.
# Quotas
## Fichier entrant vers Amazon Web Services ()AWS
| Opération | Limite |
| --- | --- |
| Opportunités maximales | 500 par fichier |
| Taille maximale du fichier | 1 Mo |
| Fréquence de synchronisation | Quasi-temps réel |
| Nombre maximum de fichiers soumis | 10 000 par période de 24 heures |
## Fichier sortant vers le partenaire
| Opération | Limite |
| --- | --- |
| Taille maximale du fichier | 5 Mo |
| Fréquence de synchronisation | Par heure |
# Historique des versions
Version actuelle des champs : 14 (15 novembre 2023)
Le tableau suivant décrit les modifications importantes apportées aux champs d'intégration personnalisés pour les prospects et les opportunités après 2020. Pour être informé des futures mises à jour, abonnez-vous au fil RSS.
| Modification | Version | Date |
| --- | --- | --- |
| Mettre à jour les quotas Amazon S3 | 14 | 17/01/2024 |
| **Modifications apportées aux champs d'opportunités d'intégration :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) | 14 | 15/11/2023 |
| **Modifications apportées aux champs d'opportunités d'intégration :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) | 13 | 29/03/2023 |
| **Modifications apportées aux champs d'opportunités d'intégration :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) **Modifications apportées aux valeurs standard en cas d'opportunité :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) | 12 | 01/09/2022 |
| **Modifications apportées aux champs d'opportunités d'intégration :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) **Modifications apportées aux valeurs standard des champs d'opportunité :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) | 11 | 21/03/2022 |
| **Modifications apportées aux champs d'opportunités d'intégration :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) **Modifications apportées aux valeurs standard en cas d'opportunité :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) | 10 | 26/01/2022 |
| **Modifications apportées aux valeurs standard des champs de plomb :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) **Modifications apportées aux champs principaux d'intégration :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) **Modifications apportées aux champs d'opportunités d'intégration :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/partner-central/latest/crm/version-history.html) | 9 | 16/09/2021 |
| Mettre à jour les codes de motif fermés et perdus | 8 | 24/06/2021 |
# FAQs
Utilisez ces questions et réponses courantes pour faciliter l'intégration personnalisée.
**Topics**
+ [FAQ générales](general-faq.md)
+ [FAQ technique—Champs](technical-faq-fields.md)
+ [FAQ technique—Amazon S3](technical-faq-s3.md)
+ [FAQ technique : pistes et opportunités](technical-faq-leads-and-opps.md)
+ [FAQ technique : gestion des versions et rétrocompatibilité](technical-faq-versioning.md)
# FAQ générales
## Comment fonctionne l'intégration ?
**Q : Puis-je accéder au bucket Amazon Simple Storage Service (Amazon S3) utilisé pour envoyer et recevoir les fichiers ?**
Oui. Les partenaires peuvent accéder par programmation au compartiment Amazon S3 à l'aide de la secret/access clé Gestion des identités et des accès AWS (IAM) qui a accès au compartiment. Les partenaires n'auront pas accès à la console aux compartiments Amazon S3 car ces compartiments se trouvent sur le propre compte d'Amazon Web Services (AWS).
**Q : De quelles compétences le développeur du partenaire a-t-il besoin ?**
Le développeur du partenaire doit être familiarisé avec son système de gestion de la relation client (CRM) et Amazon S3.
**Q : Les fichiers d'exemple de code incluent-ils le code complet ou le partenaire doit-il écrire le code ?**
Le partenaire doit écrire le code sur la base des exemples de fichiers de code fournis.
**Q : Si le partenaire développe sa solution en Python, en Golang ou dans tout autre langage, est-ce que AWS Partner Network (APN) Customer Engagement (ACE) fournit un kit de développement logiciel (SDK) dans ces langages pour cette intégration ?**
Non.
**Q : Quel est le processus de synchronisation entre le compartiment Amazon S3 et l'ACE interne ?**
Toutes les heures, un traitement par lots est exécuté pour récupérer les fichiers et synchroniser les informations. Toute mise à jour apportée par l'équipe AWS commerciale au dossier peut prendre jusqu'à une heure pour être envoyée au bucket du partenaire. Les partenaires peuvent recevoir immédiatement une notification par e-mail concernant les mises à jour, mais les mises à jour AWS peuvent tout de même être retardées d'une heure.
**Q : Quelle est la fréquence des téléchargements de fichiers de prospects et d'opportunités par ACE ?**
ACE envoie les données relatives aux prospects et aux opportunités toutes les heures.
**Q : Existe-t-il un environnement sandbox pour ACE ?**
Oui. Nous disposons d'un environnement sandbox pour ACE, mais nous ne pouvons pas fournir d'accès aux partenaires pour des raisons de sécurité. Soumettez un dossier d'assistance sur Partner Central si vous souhaitez que de nouvelles opportunités ou prospects soient ajoutés à votre panier.
**Q : Comment conservons-nous les identifiants dans le CRM et l'APN du partenaire ?**
Pour offrir plus de flexibilité à nos partenaires, nous utilisons deux ensembles d'identifiants dans notre système.
1. `apnCrmUniqueIdentifier`: AWS gère cet identifiant. Cela commence par `OXXXXXX` les opportunités et `LXXXXXX` les prospects.
1. `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`: Le partenaire gère cet identifiant sur les opportunités et les prospects, respectivement, dans son CRM. Les partenaires doivent ajouter cet identifiant lorsqu'ils saisissent de nouvelles opportunités pour retracer les mises à jour de leur CRM.
Lorsqu'une opportunité est envoyée sans `apnCrmUniqueIdentifier` ou`partnerCrmUniqueIdentifier`, elle AWS est traitée comme une nouvelle opportunité et en attribue une nouvelle `apnCrmUniqueIdentifier` à l'opportunité.
Lorsqu'une opportunité est envoyée avec un `apnCrmUniqueIdentifier` or`partnerCrmUniqueIdentifier`, AWS elle est traitée comme une action de mise à jour et met à jour l'opportunité existante avec les données de charge utile.
**Q : Comment puis-je empêcher la création de doublons dans les deux systèmes ?**
Du côté du CRM partenaire, il doit y avoir un identifiant unique pour chaque enregistrement envoyé à ACE, qui est appelé`partnerCrmUniqueIdentifier`. De même, ACE conserve également un identifiant unique pour chaque enregistrement, qui est appelé`apnCrmUniqueIdentifier`. Lorsque les données sont envoyées, ACE et le partenaire doivent inclure ces deux champs, ce qui permet de déterminer si l'enregistrement est une nouvelle opportunité (s'il est vide) ou une opportunité existante (s'il est renseigné).
# FAQ technique—Champs
**Q : L'intégration prend-elle en charge le format CSV ?**
Non L'intégration accepte uniquement les formats de fichiers JSON.
**Q : Quand les fichiers doivent-ils être supprimés des dossiers sortants ?**
Supprimez les fichiers uniquement après les avoir traités avec succès.
**Q : Si je supprime accidentellement les fichiers des dossiers sortants, où puis-je trouver les fichiers d'origine ?**
Les fichiers sont disponibles dans les `lead-outbound-archive` dossiers `opportunity-outbound-archive` et.
**Q : Que dois-je faire pour obtenir de l'aide pendant le développement ?**
Pour obtenir de l'aide pendant le développement, contactez le support AWS Partner Network (APN) sur Partner Central.
**Q : Quelle est la différence entre `opportunityOwnerName` et `opportunityOwnerEmail` ?**
+ `opportunityOwnerName`: nom du propriétaire de l'opportunité dans l'organisation partenaire. Il doit s'agir d'un utilisateur de Partner Central.
+ `opportunityOwnerEmail`: e-mail du propriétaire de l'opportunité dans l'organisation partenaire. Il doit s'agir d'un utilisateur de Partner Central. Si elle n'est pas fournie, l'opportunité est créée avec le responsable de l'alliance Partner Central comme propriétaire.
**Q : Quel est le fuseau horaire de tous les champs de date (`targetCloseDate``lastModifiedDate`,`createdDate`, et`acceptBy`) ?**
Le fuseau horaire pour les champs de date est l'heure moyenne de Greenwich (GMT).
**Q : Les fichiers JSON entrants sont-ils versionnés ?**
Non Amazon Web Services (AWS) ne prend pas en charge la gestion des versions des fichiers. APN Customer Engagement (ACE) traite le fichier immédiatement après réception, puis le supprime une fois le traitement réussi. Si nous recevons à nouveau le même nom de fichier, il est rejeté.
**Q : Quels champs du fichier JSON Amazon Simple Storage Service (Amazon S3) indiquent la date de création et de dernière mise à jour d'un prospect ou d'une opportunité en particulier ?**
`createdDate` et `lastModifiedDate`.
**Q : Comment déterminez-vous si une opportunité est nouvelle ou existante ?**
Le champ `PartnerCrmUniqueIdentifier` est un identifiant unique pour chaque opportunité que nous demandons au partenaire. Cet identifiant doit être défini dans le CRM source du système du partenaire. Nous l'utilisons pour déterminer si une opportunité existe dans AWS. Si elle existe, nous mettons à jour l'opportunité avec les informations partagées. Si ce n'est pas le cas, nous créons une nouvelle opportunité.
Lorsque nous envoyons des données au partenaire, nous incluons à la fois `PartnerCrmUniqueIdentifier` et`apnCrmUniqueIdentifier`. Si l'opportunité partagée par AWS est envoyée pour la première fois, vous ne verrez aucune valeur pour`PartnerCrmUniqueIdentifier`. Cela vous permet de considérer l'opportunité comme une nouveauté d'ACE. Une fois que vous les avez intégrées dans votre CRM, vous nous renvoyez les mises à jour avec les deux `PartnerCrmUniqueIdentifier` et`apnCrmUniqueIdentifier`.
**Q : Est-il possible d'avoir plusieurs fichiers JSON sortants et de résultats dans Amazon S3 ?**
Oui. Parfois, nous pouvons générer plus de fichiers dans le dossier sortant. De même, si vous envoyez des fichiers dans le dossier entrant, nous les traitons et conservons les fichiers de résultats dans le dossier des résultats. Vous devez baliser ou supprimer les fichiers de résultats après le traitement.
**Q : Le fichier sortant contient-il plusieurs enregistrements ?**
Oui. Le fichier sortant peut contenir plusieurs enregistrements.
**Q : Si 20 opportunités entrantes sont envoyées dans un seul fichier JSON d'entrée dans la section opportunités et que l'une des opportunités n'est pas conforme à la norme APN, que se passe-t-il ?**
Si le format est incorrect, quel que soit le cas, le fichier entier est rejeté. Si le format est correct mais qu'une seule opportunité ne peut pas être traitée de notre côté, le fichier de résultats inclut les 20 opportunités et leur statut, ainsi que le message d'erreur relatif à l'opportunité ratée.
**Q : Quels sont les principaux attributs permettant de valider si le fichier JSON a été traité correctement ?**
Ce sont les principaux attributs qui vous aideront à comprendre si le fichier JSON a été traité correctement.
```
{
"inboundApiResults": [
{
"warnings": null, // no warnings
"partnerCrmUniqueIdentifier": "XXXX", //uniqueId from Partner side
"isSuccess": true, // file successfully processed
"errors": null, //no errors reported
"apnCrmUniqueIdentifier": "OXXXX" //uniqueId from AWS side
}
]
}
```
**Q : Que se passe-t-il si j'envoie un fichier JSON non valide ?**
Vous recevez cette réponse d'erreur : « n'`[{input JSON}]`est pas de type `object` ».
**Q : Combien d' lead/opportunity enregistrements peuvent être inclus dans un seul fichier JSON entrant ?**
Un seul fichier peut contenir un maximum de 50 enregistrements.
# FAQ technique—Amazon S3
**Q : Où puis-je obtenir la documentation de l'API REST Amazon Simple Storage Service (Amazon S3) ?**
Pour plus d'informations, consultez l'[introduction de l'API REST Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html).
**Q : Comment puis-je obtenir les informations clés Amazon Web Services AWS Key Management Service (AWS KMS) pour m'authentifier afin d'accéder au compartiment Amazon S3 ?**
AWS Partner Network (APN) partage une politique qui inclut le nom de la clé.
**Q : Comment authentifier Amazon S3 depuis Salesforce.com (SFDC) ?**
Utilisez le fichier d'exemple de code [S3\$1Authentication.cls pour authentifier](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) Amazon S3 auprès de SFDC.
**Q : Comment puis-je télécharger le fichier depuis le kit de développement AWS logiciel (SDK) vers S3 ?**
Utilisez la commande AWS CLI suivante pour télécharger le fichier sur S3.
```
aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control
```
Le fichier d'exemple de code [Sample\$1 AceOutboundBatch .cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) contient le code permettant de télécharger le fichier de données depuis SFDC.
**Q : À qui appartient le compartiment Amazon S3 ?**
AWS possède et gère le compartiment Amazon S3. Vous avez un accès programmatique à votre propre compartiment Amazon S3 avec l'utilisateur Gestion des identités et des accès AWS (IAM).
**Q : Existe-t-il des dossiers ou des compartiments distincts pour la réception et l'envoi de fichiers ?**
Il existe un compartiment contenant différents dossiers pour recevoir et envoyer les fichiers. Reportez-vous au guide de l'utilisateur pour plus de détails sur les dossiers.
**Q : Dois-je accéder au compartiment Amazon S3 à l'aide AWS Lambda du système de gestion de la relation client (CRM) ou puis-je y accéder directement à l'aide du système de gestion de la relation client (CRM) ?**
Vous pouvez y accéder dans les deux sens.
**Q : Le compartiment Amazon S3 est-il sécurisé ou chiffré ?**
Oui. Nous activons le mécanisme de chiffrement par défaut proposé par Amazon S3.
**Q : Est-il possible d'activer Amazon Simple Notification Service (Amazon SNS) pour écouter le compartiment Amazon S3, afin que je puisse uniquement agir en fonction de l'événement, au lieu de devoir effectuer des sondages périodiques ?**
Non Actuellement, APN Customer Engagement (ACE) ne prend pas en charge cette fonctionnalité.
**Q : À quels dossiers ai-je accès et quel est le but de chaque dossier ?**
Vous trouverez la liste des dossiers Amazon S3 dans[Prérequis pour l'intégration](crm-integration-setting-up.md).
# FAQ technique : pistes et opportunités
## Envoyez et recevez des prospects et des opportunités
**Q : Existe-t-il une convention de dénomination des fichiers ?**
Chaque nom de fichier doit être unique. Nous recommandons le nom du fichier`PartnerProvided FileName+{timestamp}.json`.
**Q : Quelle est la structure des résultats ?**
Les fichiers d'exemple contenant les résultats (réussite et erreur) peuvent être téléchargés depuis les emplacements suivants :
+ [Exemple de réussite des résultats principaux .json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
+ [Opportunity Results Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Résultats principaux contenant des erreurs Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json)
+ [L'opportunité se traduit par des erreurs Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json)
**Q : Quelle est la convention de dénomination des résultats ?**
`PartnerProvidedFileName_result.json`
**Q : Que se passe-t-il si je soumets un deuxième fichier JSON portant le même nom ?**
Nous ne traiterons pas le fichier et celui-ci est déplacé vers le dossier d'archive.
**Q : Quelle est la limite de taille des fichiers entrants ?**
La limite de taille des fichiers entrants est de 1 Mo.
**Q : Existe-t-il un nombre maximum d'opportunités et de prospects pouvant être regroupés dans un seul fichier JSON ?**
Compte tenu de la limite de 1 Mo, nous vous recommandons d'avoir une opportunité ou un prospect par fichier.
**Q : Je reçois un message d'erreur d'accès refusé. Je ne suis donc pas en mesure de télécharger les fichiers. Que dois-je faire ?**
Les partenaires reçoivent un message *d'accès refusé* pour deux raisons.
1. Vous avez chargé le fichier dans le `outbound` dossier plutôt que `inbound` dans le dossier. Téléchargez le fichier dans le `inbound` dossier.
1. Vous devez fournir une liste de contrôle d'accès (ACL). Utilisez la commande CLI Amazon Web Services (AWS) suivante pour télécharger le fichier de données :
```
aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control
```
**Q : Que se passe-t-il si des fichiers portant des extensions telles que `.pdf``.docx`, ou autre, `.json` sont téléchargés ?**
Nous rejetons les fichiers et générons un `*.error.json` fichier avec les détails de la raison.
**Q : Que dois-je faire après avoir reçu un message d'erreur concernant un problème de données en cours de production ?**
1. Si les données doivent être corrigées dans le système de gestion de la relation client (CRM) du partenaire, une fois les données corrigées, envoyez le fichier révisé à Amazon Simple Storage Service (Amazon S3).
1. Si des précisions sont nécessaires concernant les données, contactez votre responsable du développement des partenaires (PDM).
1. Pour toute autre assistance technique, soumettez un dossier de support AWS Partner Network (APN) sur le portail APN.
**Q : Où puis-je trouver les fichiers de résultats et combien de temps sont-ils disponibles ?**
Les fichiers de résultats se trouvent dans les `opportunity-inbound-results` dossiers `lead-inbound-results` et. Ils sont disponibles jusqu'à ce que vous les supprimiez. Vous pouvez supprimer les fichiers après une extraction réussie.
**Q : Si je dois retrouver un fichier de résultats après l'avoir supprimé, où le trouverons-nous ?**
Les fichiers de résultats se trouvent dans les `opportunity-inbound-results-archive/YYYY/MM/DD` dossiers `lead-inbound-results-archive/YYYY/MM/DD` et.
**Q : En cas d'échec du traitement du fichier par APN, comment en suis-je informé ?**
APN dispose d'alarmes qui créent automatiquement des tickets Sev2 pour suivre les erreurs de traitement. Nous les examinons, les résolvons et les communiquons aux partenaires.
**Q : Quels champs peuvent être mis à jour une fois l'opportunité lancée ?**
Les champs suivants ne peuvent être mis à jour que par les partenaires Independent Software Vendor (ISV) Accelerate :
+ `isThisForMarketplace`
+ `isNetNewBusinessForCompany`
+ `deliveryModel`
+ `awsFieldEngagement`
+ `additionalComments`
**Q : J'ai reçu un message d'erreur « *Enregistrement non modifiable* ». Qu'est-ce que cela signifie ?**
Lorsque vous envoyez une opportunité recommandée à un nouveau partenaire, celle-ci passe par le processus de validation et l'équipe ACE (APN Customer Engagement) doit l'approuver ou la rejeter. Pendant que l'opportunité est en cours de révision et n'a pas encore été validée, vous ne pouvez pas mettre à jour l'enregistrement et vous recevez cette erreur.
**Q : Que se passe-t-il s'il n'y a aucune activité de mon côté (exemple : je ne traite pas le fichier ou je n'envoie aucune opportunité entrante) ?**
Si vous n'envoyez aucune information ou si vous ne traitez pas les fichiers que nous fournissons, nous n'avons actuellement aucun mécanisme en place pour vous avertir. Nous vous encourageons à surveiller votre système pour vous assurer que les informations sont transmises à APN.
**Q : Dans quel délai les résultats JSON sont-ils disponibles dans le dossier des résultats après la soumission d'une opportunité/d'un new/updated prospect entrant ?**
Le traitement s'effectue quasiment en temps réel. Vous devriez recevoir les fichiers en moins de cinq minutes.
**Q : Si j'envoie un CRM d'opportunités entrantes qui ne respecte pas les format/length restrictions de la norme APN, comment le système le gère-t-il ? Génère-t-il le rapport d'erreur ?**
Si le fichier n'est pas au format de définition de champ, le fichier de résultats d'APN appelle le fichier.
**Q : Je n'ai pas d'identifiant de AWS compte au moment du lancement. Que dois-je faire ?**
Selon le processus ACE, `Launched` cela signifie que la charge de travail est terminée et que la facturation a commencé. Cela nécessite un identifiant de AWS compte. Pour plus d'informations, consultez le [programme ACE FAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ).
**Q : À la suite des tests d'acceptation par l'utilisateur (UAT), comment les données historiques doivent-elles être traitées lors du passage en production ?**
Par défaut, lorsque des mises à jour ont lieu dans ACE, nous envoyons ces opportunités au compartiment Amazon S3. Pour les données historiques que vous ne souhaitez pas traiter, vous devez `partnerCrmUniqueIdentifier` fournir des valeurs fictives, comme `X0001, X0002….X000N` dans l'extrait, pour ce que vous ne souhaitez pas traiter dans votre système. Vous devez écrire du code pour reconnaître ces identifiants et les traiter en conséquence. Les autres opportunités fournissent la `partnerCrmUniqueIdentifier` valeur correcte. Cela garantit que vous avez un contrôle total sur ce qu'il faut traiter et ce qu'il ne faut pas traiter dans votre système.
**Q : Le fichier sortant contient-il plusieurs enregistrements ?**
Oui. Le fichier sortant peut contenir plusieurs enregistrements.
**Q : Pourquoi les données sont-elles envoyées *Accepter pour afficher* certains champs ?**
Pour une opportunité AWS ou un prospect recommandé, tous les champs d'informations personnelles sont masqués par le libellé *Accepter pour les afficher jusqu'à* ce que vous acceptiez l'opportunité ou le prospect. Une fois accepté, vous recevrez tous les champs de données lors du prochain cycle de synchronisation.
**Q : Que dois-je faire lorsqu'une nouvelle opportunité AWS ou un nouveau prospect est synchronisé pour la première fois ?**
Lorsqu'une nouvelle opportunité ou un nouveau prospect est synchronisé pour la première fois, vous devez l'accepter ou le rejeter pour obtenir des données supplémentaires (exemple : contacts clients).
## Création et mise à jour d'opportunités/prospects
**Q : Comment intégrer de nouvelles opportunités proposées *par des partenaires* dans ACE grâce à l'intégration ?**
Pour créer de nouvelles opportunités dans ACE par le biais de l'intégration, vous devez intégrer dans le `opportunity-inbound` dossier les informations d'opportunité requises au format JSON défini. AWS traite ces informations, crée une nouvelle opportunité dans ACE et partage les résultats d'une opération de successful/failed création dans le `opportunity-inbound-processed-results` dossier.
**Q : Comment l'intégration fait-elle la différence entre les soumissions de nouvelles opportunités et les mises à jour ?**
Le champ `PartnerCrmUniqueIdentifier` de chaque opportunité est un identifiant unique obligatoire. Cet identifiant doit être défini dans le CRM source de votre système. AWS utilise ceci pour déterminer si une opportunité existe déjà dans ACE. Si elle est disponible dans ACE, nous utilisons les informations partagées pour mettre à jour l'opportunité, mais si elles ne sont pas disponibles dans ACE, nous utilisons les informations partagées pour créer une nouvelle opportunité.
**Q : Si j'ai déjà implémenté la fonctionnalité de mise à jour par le biais de l'intégration, que dois-je faire pour utiliser l'intégration afin de soumettre (créer) de nouvelles opportunités ?**
Vous devez apporter les modifications suivantes à l'intégration existante :
1. Commencez à ingérer de nouvelles opportunités de création dans le `opportunity-inbound` dossier. Fournissez les mises à jour dans le même dossier.
1. Assurez-vous que les champs obligatoires requis pour créer sont disponibles dans le JSON Opportunity partagé.
1. Vérifiez que chaque nouvelle opportunité possède un identifiant unique `PartnerCrmUniqueIdentifier` qui n'existe pas dans ACE/Partner Central. Une bonne pratique importante lors de la mise en service consiste à mapper et à mettre à jour les données existantes dans ACE pour chacune d'entre elles `PartnerCrmUniqueIdentifier` dans votre CRM afin de ne pas créer de doublons lorsque nous recevons des mises à jour. Pour obtenir de l'aide, contactez ACE.
**Q : Dans le cadre du processus de mise en service, comment puis-je mettre à jour les opportunités existantes dans ACE avec mon `PartnerCrmUniqueIdentifier` ?**
L'équipe ACE vous fournit une liste de toutes les opportunités ouvertes pour vous aider à préparer le lancement de la production. Vous devez associer ces opportunités existantes dans ACE à leurs opportunités respectives `PartnerCrmUniqueIdentifier` et renvoyer le fichier mis à jour à ACE pour intégration dans AWS le CRM.
Si vous choisissez de ne synchroniser qu'un sous-ensemble des opportunités AWS proposées, vous devez développer une logique permettant de contourner les AWS mises à jour pour les opportunités que vous ne souhaitez pas traiter. Cette approche devrait également être appliquée aux opportunités futures, après l'intégration. Vous devez fournir les informations associées `partnerCrmUniqueIdentifier` pour les opportunités qui doivent être harmonisées entre les deux CRMs. En outre, vous devez indiquer les opportunités que vous ne mettrez pas à jour (exemple : Marquer les opportunités clôturées perdues ou gagnées) pour les exclure des mises à jour. Il est important que toutes les opportunités ouvertes/actives AWS partagées, et que vous acceptez, se voient attribuer un. `partnerCrmUniqueIdentifier`
**Q : Puis-je mettre à jour uniquement des champs spécifiques dans l'opportunité ou le prospect ?**
Oui. Vous ne pouvez fournir que les champs qui nécessitent des mises à jour, ainsi que les identifiants nécessaires.
**Q : Est-il possible de modifier le *ApnCrmUniqueIdentifier***?
Non. Cet identifiant reste constant AWS et identifie de manière unique chaque opportunité.
**Q : Et si je fournis un *partnerCrmUniqueidentifiant* incorrect** ?
Si vous fournissez un identifiant incorrect, une nouvelle opportunité est créée. Garantissez la précision pour éviter la duplication des données.
**Q : Puis-je mettre à jour les opportunités AWS soumises ?**
Oui. Vous pouvez mettre à jour les opportunités AWS soumises en utilisant le bon`partnerCrmUniqueIdentifier`.
**Q : Dans combien de temps puis-je m'attendre à des résultats pour les opportunités soumises ?**
Le traitement s'effectue presque en temps réel et les résultats sont généralement disponibles en quelques minutes dans le `opportunity-inbound-processed-results` dossier.
**Q : Que dois-je faire en cas d'erreur de traitement pour les opportunités soumises ?**
Passez en revue les détails des erreurs dans les fichiers de résultats, résolvez les problèmes et demandez une assistance supplémentaire à l'équipe de support ACE.
**Q : Puis-je supprimer une opportunité par le biais de l'intégration ?**
Non. La suppression directe n'est pas prise en charge. Vous pouvez mettre à jour une opportunité pour qu'elle reflète le statut *Fermé*.
**Q : Que signifie l'erreur « *Enregistrement non modifiable* » ?**
Cette erreur se produit si vous essayez de mettre à jour une opportunité dans ACE review. Ces opportunités ne peuvent pas être modifiées tant qu'elles ne sont pas validées.
**Q : Et si je n'envoyais pas de mises à jour ou de nouvelles opportunités ?**
Aucune nouvelle donnée n'est reçue ni traitée si vous n'envoyez pas de mises à jour ou de nouvelles opportunités via l'intégration.
**Q : Pendant combien de temps les fichiers de résultats sont-ils disponibles ?**
Les fichiers de résultats sont disponibles pour une durée raisonnable. Vous devez les récupérer et les gérer rapidement.
# FAQ technique : gestion des versions et rétrocompatibilité
**Q : Qu'est-ce qu'une charge utile dans l'échange de données Amazon Web Services (AWS) ?**
Une charge utile est une donnée structurée formatée en JSON, envoyée soit en entrée, soit en provenance de AWS . AWS Chaque clé de cette structure JSON est appelée *champ*, et chaque champ est associé à une *valeur.*
**Q : Comment est déterminée la version de la charge utile ?**
La version de la charge utile est spécifiée dans le `version` champ de la charge utile elle-même. Les charges utiles conformes à la définition de champ v13 sont considérées comme des charges utiles version 1.0, tandis que celles qui suivent le format défini dans la définition de champ v14 ou supérieure sont appelées charge utile version 2.0.
**Q : Que signifie la rétrocompatibilité dans ce contexte, et comment est-elle gérée ?**
La rétrocompatibilité garantit que les opportunités existantes n'échouent pas lorsque de nouveaux champs obligatoires sont introduits dans les nouvelles versions de charge utile. AWS maintient cela en attribuant automatiquement des valeurs par défaut aux champs requis dans la nouvelle version. Vous remarquerez peut-être des valeurs dans l'interface utilisateur AWS Partner Network (APN) Customer Engagement (ACE) que vous n'avez pas explicitement fournies dans le cadre de l'intégration de la gestion de la relation client (CRM). Les détails et les conditions de chaque champ sont expliqués dans la description du champ ou dans des informations supplémentaires sur le champ.
**Q : La rétrocompatibilité est-elle une fonctionnalité permanente ?**
Non La rétrocompatibilité est limitée dans le temps, conçue pour vous permettre de planifier et de mettre en œuvre les modifications à venir en toute flexibilité. Il cesse de fonctionner au-delà d'une date limite spécifiée, qui sera annoncée plus tard dans l'année dans le cadre d'un lancement plus large.
**Q : Que se passe-t-il lorsque je commence à envoyer des charges utiles avec la version 2.0 ?**
Une fois que vous avez envoyé une charge utile avec la version 2.0, le système suppose que toutes les modifications nécessaires ont été mises en œuvre, et les validations pour la nouvelle version de charge utile s'appliquent à toutes les modifications ultérieures. Il est essentiel de ne pas implémenter partiellement les fonctionnalités entre les charges utiles de la version 1.0 et de la version 2.0.
**Q : Puis-je revenir à la version 1.0 de la charge utile après la mise à jour vers la version 2.0 ?**
Non La transition vers la version 2.0 de charge utile est un processus à sens unique. Une fois que vous avez effectué la mise à jour vers la version 2.0, vous ne pouvez pas revenir à la version 1.0 de la charge utile.