Condividi tramite

Creare una segnalazione

  • Articolo

Questo articolo illustra come creare una segnalazione. Sono disponibili due tipi di ReferralType:

  • Indipendente: dove una segnalazione è visibile a un partner.

  • Condiviso: dove una segnalazione è visibile a due parti che lavorano insieme. Se ad esempio Microsoft e un partner collaborano a una trattativa di co-selling, una segnalazione può essere condivisa tra entrambe le parti. Per altre informazioni, vedi la sezione Creare una segnalazione condivisa.

    Nota

    L'idoneità macC e le funzionalità di corrispondenza dei clienti non sono disponibili con l'uso dell'integrazione api.

Tipi di trattative

Esistono tre tipi di opportunità di co-selling (o trattative o segnalazioni) che possono essere create dal Centro per i partner: trattative private, led per partner e co-selling. In genere, dall'interfaccia utente del Centro per i partner, queste scelte vengono presentate all'utente, ma durante la creazione di queste dall'API, esistono alcuni altri passaggi da eseguire. Dall'interfaccia utente delle segnalazioni del Centro per i partner, quando si crea un nuovo accordo, è disponibile una guida necessaria nella sezione Microsoft , in cui queste scelte vengono presentate all'utente.

  • Trattativa privata: si sceglie di non condividere la trattativa con Microsoft, selezionare "Nessun aiuto necessario" e rispondere "no" alla domanda" "Condividere la trattativa con i venditori Microsoft?"
  • Il partner ha guidato: scegliere "Nessun aiuto necessario", ma rispondere "sì" alla domanda" "Condividere la trattativa con i venditori Microsoft?"
  • Co-selling: si sceglie di ottenere assistenza da Microsoft e rispondere anche a "sì" alla domanda" "Condividere la trattativa con i venditori Microsoft?"

Prerequisiti

Richiesta REST

Sintassi della richiesta

metodo URI della richiesta
POST https://api.partner.microsoft.com/v1.0/engagements/referrals

Intestazioni delle richieste

Testo della richiesta

Questa tabella descrive le proprietà di una segnalazione nel corpo della richiesta per una nuova segnalazione.

Proprietà Type Descrizione
Nome string Nome della segnalazione.
ExternalReferenceID string Identificatore esterno della segnalazione. ad esempio il tuo ID opportunità o cliente potenziale di Dynamics 365.
Status ReferralStatus Enumerazione con valori che indicano lo stato della segnalazione.
Stato secondario ReferralSubstatus Enumerazione con valori che indicano lo stato secondario della segnalazione.
StatusReason string Messaggio descrittivo sullo stato, ad esempio una spiegazione del motivo per cui la segnalazione è andata persa.
ReferralType ReferralType Rappresenta il tipo di segnalazione. Obbligatorio.
Qualification ReferralQualification Rappresenta la qualità della segnalazione.
CustomerProfile CustomerProfile Informazioni sul contatto del cliente. Obbligatorio.
Consenso Consenso Flag di consenso sulla condivisione di informazioni con altre organizzazioni e che consentono loro di contattare gli utenti. Obbligatoria.
Dettagli ReferralDetails Dettagli del cliente, note, valore della trattativa, data di chiusura della valuta. Obbligatorio.
Team Member Rappresenta gli utenti nelle organizzazioni coinvolte nell'accordo di partner.
InviteContext InviteContext Rappresenta altre informazioni che un utente può fornire quando invita un'altra organizzazione nel coinvolgimento dei partner.
Target ReferralTarget Rappresenta altre informazioni che un utente può fornire quando invita un'altra organizzazione nel coinvolgimento dei partner.
Ruolo partner Obbligatorio solo per le segnalazioni di co-selling dei servizi Può essere uno dei valori seguenti: prevendita, progettazione di soluzioni, modello di verifica, strategia aziendale, servizi di distribuzione, adozione e gestione delle modifiche, transazione, servizi gestiti
Area soluzione Obbligatorio solo per le segnalazioni di co-selling dei servizi L'area Soluzione del cliente deve avere l'opportunità. Per i valori, vedere la tabella seguente.
Riproduzione della soluzione Obbligatorio solo per le segnalazioni di co-selling dei servizi Il gioco della soluzione del cliente ha bisogno nell'opportunità. Per i valori, vedere la tabella seguente.

Valori dell'area della soluzione e del gioco della soluzione

La tabella seguente illustra i valori per i campi Area soluzione e Play soluzione per FY 24.

Area soluzione Riproduzione della soluzione
Applicazioni aziendali Accelerare l'innovazione con low code
Applicazioni aziendali Accelerare la generazione dei ricavi
Applicazioni aziendali Modernizzare il servizio
Applicazioni aziendali Ottimizzare finanza e supply chain
Applicazioni aziendali Operazioni aziendali di scalabilità SMB
Dati e intelligenza artificiale Decisioni aziendali avanzate con Analisi su scala cloud
Dati e intelligenza artificiale Creare e modernizzare le app di intelligenza artificiale
Innovazione digitale e applicativa Eseguire la migrazione di app aziendali
Innovazione digitale e applicativa Creare e modernizzare le app di intelligenza artificiale
Innovazione digitale e applicativa Accelerare la produttività degli sviluppatori
Innovazione digitale e applicativa Accelerare l'innovazione con Integration Services
Infrastruttura Eseguire la migrazione e proteggere Windows Server e SQL Server
Infrastruttura Eseguire la migrazione di SAP
Infrastruttura Innovazione con HPC, infrastruttura di intelligenza artificiale
Infrastruttura Eseguire la migrazione di Linux Estate
Infrastruttura Eseguire la migrazione di Oracle
Lavoro moderno Operatori sul campo
Lavoro moderno Esperienza dipendente
Lavoro moderno Produttività sicura
Lavoro moderno Comunicazioni convergenti
Lavoro moderno Endpoint cloud
Lavoro moderno Modernizzare con Surface
Sicurezza Protezione dalle minacce con XDR e SIEM
Sicurezza Sicurezza multi-cloud
Sicurezza Sicurezza dei dati
Sicurezza Governance dei dati
Sicurezza Operazioni sec moderne
Sicurezza Proteggere l'identità e prendere okta e ping
Supporto unificato Creare una solida base con Unified
Supporto unificato Favorire il successo del cloud con soluzioni avanzate

Stati di transizione di stato e stato secondario

Status Transizione di stato consentita Stato secondario consentito
Nuovo New, Active, Closed Pending, Received
Attive Active, Closed Accettata
Chiuso Chiuso Won, Lost, Declined, Expired

Esempio di richiesta

POST https://api.partner.microsoft.com/v1.0/engagements/referrals HTTP/1.1
Authorization: Bearer <token>
Host: api.partner.microsoft.com
Content-Type: application/json

 {
    "name": "Test Cosell Invite_20",
    "status": "New",
    "substatus": "Pending",
    "statusReason": "Customer engagement was a success!",
    "qualification": "SalesQualified",
    "type": "Shared",
    "target": [
        {
            "type": "SolutionProfile",
            "id": "SOL-34104-EBB"
        }
    ],
    "customerProfile": {
        "name": "Contoso Customer Inc",
        "address": {
            "addressLine1": "One Microsoft Way",
            "addressLine2": "34",
            "city": "Redmond",
            "state": "WA",
            "postalCode": "98052",
            "country": "US"
        },
        "size": "10to50employees",
        "team": [
            {
                "contactPreference": {
                    "locale": "en-us",
                    "disableNotifications": false
                },
                "firstName": "Sue",
                "lastName": "Smith",
                "phoneNumber": "1234567890",
                "email": "sue.smith@contoso.com"
            },
            {
                "contactPreference": {
                    "locale": "en-us",
                    "disableNotifications": false
                },
                "firstName": "Joe",
                "lastName": "Hansen",
                "phoneNumber": "4035698759",
                "email": "joe.hansen@contoso.com"
            }
        ],
        "ids": []
    },
    "consent": {
        "consentToToShareInfoWithOthers": true,
        "consentToContact": true
    },
    "details": {
        "notes": "Customer is looking to leverage Dynamics 365 to manage their supply chain. There's also a need to leverage a set of custom apps to enable their business processes.",
        "dealValue": 50000,
        "currency": "USD",
        "closingDateTime": "2018-11-14T00:00:00Z",
        "requirements": {
            "industries": [
                {
                    "id": "Manufacturing"
                }
            ],
            "products": [
                {
                    "id": "Dynamics365Enterprise"
                }
            ],
            "services": [
                {
                    "id": "DeploymentOrMigration"
                }
            ],
            "solutions": [
                {
                    "name": "Dynamics 365 for Field Service",
                    "type": "Category",
                    "id": "Dynamics365forFieldService"
                }
            ]
        }
    },
    "team": [
        {
            "contactPreference": {
                "locale": "en-us",
                "disableNotifications": false
            },
            "firstName": "John",
            "lastName": "Doe",
            "phoneNumber": "1231231234",
            "email": "john.doe@microsoft.com"
        }
    ],
    "inviteContext": {
        "notes": "Hi ABC Partner, hoping you can help this customer. Thanks, John @ Microsoft",
        "invitedBy": {
            "organizationId": "msft"
        }
    }
}

Risposta REST

Se ha esito positivo, questo metodo restituisce la risorsa di segnalazione popolata nel corpo della risposta.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

{
    "id": "4111fffc-f9ee-4d53-bba6-569135228642",
    "engagementId": "37ef26aa-1d15-4533-9f93-a69bd33ab1e5",
    "organizationId": "7d23e5ca-19dc-4eaa-aac8-5e6b559f0d1d",
    "organizationName": "Contoso Company",
    "name": "Test Cosell Invite_20",
    "externalReferenceId": null,
    "createdDateTime": "2019-02-23T02:05:23.2931817Z",
    "updatedDateTime": "2019-02-23T02:05:23.2931817Z",
    "expirationDateTime": null,
    "status": "Active",
    "substatus": "Accepted",
    "statusReason": "Customer engagement was a success!",
    "qualification": "SalesQualified",
    "type": "Shared",
    "eTag": "\"00006d10-0000-0000-0000-5c70aa630000\"",
    "target": [
        {
            "type": "SolutionProfile",
            "id": "SOL-34104-EBB"
        }
    ],
    "customerProfile": {
        "name": "Contoso Customer Inc",
        "address": {
            "addressLine1": "One Microsoft Way",
            "addressLine2": "34",
            "city": "Redmond",
            "state": "WA",
            "postalCode": "98052",
            "country": "US"
        },
        "size": "10to50employees",
        "team": [
            {
                "contactPreference": {
                    "locale": "en-us",
                    "disableNotifications": false
                },
                "firstName": "Sue",
                "lastName": "Smith",
                "phoneNumber": "1234567890",
                "email": "sue.smith@contoso.com"
            },
            {
                "contactPreference": {
                    "locale": "en-us",
                    "disableNotifications": false
                },
                "firstName": "Joe",
                "lastName": "Hansen",
                "phoneNumber": "4035698759",
                "email": "joe.hansen@contoso.com"
            }
        ],
        "ids": []
    },
    "consent": {
        "consentToToShareInfoWithOthers": true,
        "consentToContact": true
    },
    "details": {
        "notes": "Customer is looking to leverage Dynamics 365 to manage their supply chain. There is also a need to leverage a set of custom apps to enable their business processes.",
        "dealValue": 50000,
        "currency": "USD",
        "requirements": {
            "industries": [
                {
                    "id": "Manufacturing"
                }
            ],
            "products": [
                {
                    "id": "Dynamics365Enterprise"
                }
            ],
            "services": [
                {
                    "id": "DeploymentOrMigration"
                }
            ],
            "solutions": [
                {
                    "name": "Dynamics 365 for Field Service",
                    "type": "Category",
                    "id": "Dynamics365forFieldService"
                }
            ]
        }
    },
    "team": [
        {
            "contactPreference": {
                "locale": "en-us",
                "disableNotifications": false
            },
            "firstName": "John",
            "lastName": "Doe",
            "phoneNumber": "1231231234",
            "email": "john.doe@microsoft.com"
        }
    ],
    "inviteContext": {
        "notes": "Hi ABC Partner, hoping you can help this customer. Thanks, John @ Microsoft",
        "invitedBy": {
            "organizationId": "msft"
        }
    },
    "links": {
        "relatedReferrals": {
            "uri": "https://api.partner.microsoft.com/v1.0/engagments/referrals?$filter=engagementId eq '37ef26aa-1d15-4533-9f93-a69bd33ab1e5'",
            "method": "GET"
        },
        "self": {
            "uri": "https://api.partner.microsoft.com/v1.0/engagments/referrals/4111fffc-f9ee-4d53-bba6-569135228642",
            "method": "GET"
        }
    }
}

Eseguire l'aggiornamento da trattative private/partner a co-selling

Per creare una trattativa di co-selling tramite l'API, devi prima creare un accordo privato o guidato dal partner e quindi creare la seconda segnalazione e connetterla con la prima. I passaggi sono descritti nella sezione seguente.

Passaggio 1: Creare un'offerta guidata dal partner visibile ai venditori Microsoft

Prima di tutto, creare un'offerta guidata dal partner visibile ai venditori Microsoft usando il payload della richiesta seguente.

POST https://api.partner.microsoft.com/v1.0/engagements/referrals

{
    "name": "TEST Contoso Cosell Deal",
    "externalReferenceId": "",
    "campaignId": "",
    "customerProfile": {
        "isMatchingComplete": true,
        "name": "Contoso Test Test",
        "address": {
            "addressLine1": "One Microsoft Way",
            "addressLine2": "",
            "city": "Redmond",
            "state": "",
            "region": "",
            "country": "US"
        },
        "size": "",
        "team": [
            {
                "firstName": "John",
                "lastName": "Doe",
                "phoneNumber": "123345667",
                "email": "john@doe.com",
                "title": "",
                "phoneValidationStatus": "None",
                "emailValidationStatus": "None",
                "contactPreference": {
                    "disableNotifications": true
                }
            }
        ],
        "ids": [
            {
                "profileType": "external",
                "id": "9-XIPFFGUQI"
            }
        ],
        "type": ""
    },
    "consent": {
        "ConsentToToShareInfoWithOthers": true,
        "ConsentToContact": true,
        "ConsentToMicrosoftToContactSpecificPartners": true,
        "consentToShareReferralWithMicrosoftSellers": true
    },
    "details": {
        "dealValue": 100000,
        "currency": "USD",
        "closingDateTime": "2024-11-23T18:30:00.000Z",
        "notes": "",
        "requirements": {
            "solutions": [
                {
                    "type": "Name",
                    "id": "SOL-8163-XCJ",
                    "name": "Contoso Solution",
                    "publisherName": "Contoso-ISV",
                    "price": null,
                    "currency": null,
                    "quantity": null,
                    "solutionType": "3P"
                }
            ],
            "additionalRequirements": {
                "iot": {},
                "attributes": [
                    {
                        "id": "HaveNotDecided",
                        "type": "CustomerMarketplaceIntent"
                    }
                ]
            }
        }
    },
    "team": [
        {
            "firstName": "John",
            "lastName": "Doe",
            "phoneNumber": "12345667",
            "email": "john@doe.com",
            "title": "",
            "phoneValidationStatus": "None",
            "emailValidationStatus": "None"
        }
    ],
    "type": "Shared",
    "qualification": "SalesQualified",
    "attributes": {
        "objectType": "Referral"
    },
    "target": [],
    "mpnId": "<ENTER PARTNER_MPN_ID>",
    "trackingInfo": {}
}

Passaggio 2: Creare una segnalazione Microsoft usando i dettagli delle segnalazioni dei partner

Creare quindi la segnalazione Microsoft tramite un'altra chiamata API e collegarla alla segnalazione del partner usando il campo ID engagement restituito dal passaggio 1.

POST https://api.partner.microsoft.com/v1.0/engagements/referrals
{
    "engagementId": "<ENTER_ENGAGEMENT_ID_OF_PARTNER_REFERRAL>",
    "organizationId": "msft",
    "organizationName": "Microsoft",
    "name": "TEST Contoso Cosell Deal",
    "customerProfile": {
        "name": "Contoso Test Test",
        "size": "",
        "isMatchingComplete": true,
        "isMaccEligible": null,
        "address": {
            "addressLine1": "One Microsoft Way",
            "addressLine2": "",
            "city": "Redmond",
            "state": "",
            "postalCode": null,
            "country": "US",
            "region": ""
        },
        "team": [
            {
                "firstName": "John",
                "lastName": "Doe",
                "phoneNumber": "123345667",
                "email": "john@doe.com",
                "title": "",
                "emailValidationStatus": "None",
                "phoneValidationStatus": "None",
                "linkedInProfileUrl": null,
                "contactPreference": {
                    "disableNotifications": true
                }
            }
        ],
        "ids": [
            {
                "profileType": "External",
                "id": "9-XIPFFGUQI"
            }
        ],
        "activities": null
    },
    "consent": {
        "consentToToShareInfoWithOthers": true,
        "consentToContact": true,
        "consentToShareReferralWithMicrosoftSellers": true
    },
    "details": {
        "notes": "Test notes to Microsoft.",
        "dealValue": 100000,
        "currency": "USD",
        "closingDateTime": "2024-11-23T18:30:00Z",
        "requirements": {
            "solutions": [],
            "additionalRequirements": {
                "iot": {},
                "attributes": []
            }
        }
    },
    "team": [],
    "inviteContext": {
        "notes": "Proof of concept / Demo , Test notes to Microsoft.",
        "invitedBy": {
            "organizationId": "<PARTNER_ORGANIZATION_ID (ACCOUNT_ID GUID)>",
            "organizationName": "<INVITING_PARTNERS_ORGANIZATION_NAME>"
        },
        "assistanceRequestCode": "ProofOfConceptOrDemo"
    },
    "type": "Shared",
    "qualification": "SalesQualified",
    "attributes": {
        "objectType": "Referral"
    },
    "target": [],
    "dealSensitivity": "None",
    "trackingInfo": {}
}

Creare una segnalazione condivisa

Esistono due passaggi per creare una segnalazione del tipo di riferimento Condiviso:

  1. Creare una segnalazione condivisa
  2. Creare una segnalazione connessa per la seconda parte

Il diagramma di flusso seguente illustra questi due passaggi nella creazione di una segnalazione condivisa.

Diagramma di flusso che mostra una segnalazione condivisa con due segnalazioni connesse tramite l'API.

Creare una segnalazione

  1. Crea una segnalazione con ReferralType impostato su Shared.
  2. Copiare engagementID dalla risposta restituita.

Esempio di ReferralTarget per la segnalazione

"target": [
        {
            "type": "SolutionProfile",
            "id": "SOL-ABC-DEF"
        }
    ]

Creare una segnalazione connessa

  1. Crea un'altra segnalazione per Microsoft.
  2. Includere l'ID di ingestione dalla segnalazione in modo che siano collegati tra loro.

Esempio di ReferralTarget per segnalazione Microsoft

"target": [
        {
            "type": "BusinessProfileLocation",
            "id": "msft"
        }
    ]

Passaggi successivi