Accademia no-code Accademia no-code

Risorsa no-code #1 per i professionisti della vendita

API semplificata per implementazione aziendale

Un'API (Application Programming Interface) viene generalmente utilizzata dagli sviluppatori per creare integrazioni tra più app. Generalmente con il no-code non usi le API (in quanto troppo complesse) ma usi Zapier o Make.

A volte, non tutte le azioni disponibili in noCRM.io sono disponibili in Zapier o Make. È qui che entra in gioco la nostra API semplificata. Se l'azione che stai cercando, come spostare un'opportunità al passaggio successivo nella pipeline di vendita, non è disponibile nativamente in Zapier o Make ma è disponibile nella nostra API semplificata, allora puoi chiamare la nostra API da Zapier o Make. Ti facciamo vedere come.

Come utilizzare l'API semplificata

Sebbene la nostra API semplificata possa essere utilizzata dagli sviluppatori nello stesso modo della nostra normale API, l'abbiamo creata principalmente per essere utilizzata tramite Zapier e Make da non-sviluppatori. Il vantaggio dell'API semplificata è che ci consente di aggiungere facilmente nuove azioni e renderle disponibili all'uso temporaneamente. Quindi, se desideri utilizzare un'azione che non è ancora disponibile nella nostra API semplificata, saremo lieti di aggiungerla in modo da creare i tuoi flussi di lavoro per ottimizzare il tuo processo di vendita.

Zapier

In Zapier, per usare un'azione a partire dall'API semplificata, devi selezionare l'evento dell'azione "Call Simplified API" e selezionare quale azione vuoi dall'elenco dell'API Semplificata.

Make

In Make, c'è una funzionalità che ti permette di chiamare direttamente un'API. Devi prima creare un nuovo modulo, scegliere noCRM.io come app e poi selezionare "Make an API Call".

Dopodiché, devi solo incollare l'URL dell'API semplificata per l'azione che vuoi eseguire.

L'utilizzo dell'API semplificata in Make è un pò meno intuitivo rispetto a Zapier. Richiede di capire cos'è un URL e quali sono i parametri. Tuttavia, grazie ai nostri tutorial capirai passo dopo passo e molto velocemente come funziona.

Esempio: Assegna un'opportunità, invia una mail, sposta l'opportunità al passaggio successivo nella pipeline di vendita e passala In Attesa pianificando l'azione successiva da svolgere.

Elenco delle azioni disponibili

In questa sezione troverai un elenco di tutte le azioni disponibili nell'API semplificata e la documentazione su come usarle in Make, una delle app no-code che usiamo con noCRM.

Ecco un breve elenco di tutte le azioni disponibili:

Quando utilizzi l'API semplificata, devi sostituire gli elementi in rosso con le informazioni corrette trovate nel tuo account noCRM.io.

Scopri come impostare i parametri nelle richieste HTTP di seguito
Tutto quello che segue il punto interrogativo "?" nell'URL qui sotto è un parametro. Un parametro è ciò che puoi configurare/definire nella query o direttamente nell'URL.

Esempio: Supponiamo di voler assegnare le opportunità in arrivo ad un utente specifico nell'account utilizzando Make.

1. Incolleremo il seguente URL nel modulo:

/simple/leads/LEAD_ID/assign?user_id=YourEmail@maildomain.com

Puoi definire il valore del parametro "user_id" direttamente nell'URL come mostrato sopra con l'ID dell'utente trovato nella sezione ID del tuo account noCRM.io (Pannello di controllo > API > ID). Questo indica a Make a quale utente dell'account deve assegnare le opportunità in arrivo.

2. In alternativa, è possibile definire il valore del parametro "user_id" nella Query invece dell'URL:
Questo metodo richiede di rimuovere il parametro dall'URL e aggiungerlo invece nella query:

/simple/leads/LEAD_ID/assign

Query:

La chiave è: user_id
Il valore è: YourEmail@maildomain.com

N.B.: Tutte le richieste sono sempre fatte con il protocollo "GET". Non preoccuparti se non sai cosa significa. Queste sono solo informazioni aggiuntive per i curiosi o sono nel campo dello sviluppo. Per gli sviluppatori puristi: sì, non dovrebbe essere il metodo GET, ma ecco perché è un'API semplificata e non la nostra REST API completa ?


Cambiare lo stato dell'opportunità in 'In Attesa'

Utilizza la seguente richiesta HTTP per pianificare la prossima azione da svolgere entro una tot data. Il parametro "giorni" è obbligatorio. Il parametro "activity_id" è facoltativo, la richiesta funzionerà con o senza.

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/standby?days=XX&activity_id=YY

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/standby?days=15
https://nocrmcorp.nocrm.io/api/simple/leads/145676/standby?days=15&activity_id=23


Modificare lo stato dell'opportunità in 'Acquisita' e inserire un importo

Use the following HTTP request to change the status of a lead to Won.
Opzionale: Puoi anche inserire l'importo dell'opportunità

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/won?amount=XX


Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/won?amount=155.34


Cambiare lo stato dell'opportunità in 'Cancellata'

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/cancelled

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/cancelled


Cambiare lo stato dell'opportunità in 'Persa'

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/lost

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/lost


Cambiare lo stato dell'opportunità in 'Da fare'

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/todo

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/todo


Assegnare un'opportunità ad un utente di tua scelta

Usa la seguente richiesta HTTP per assegnare un'opportunità ad un utente nel tuo account noCRM.io.

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/assign?user_id=EmailADDRESS

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/assign?user_id=YourEmail@maildomain.com https://nocrmcorp.nocrm.io/api/simple/leads/145676/assign?user_id=09846


Assegnare un'opportunità casualmente ad un utente

Usa la seguente richiesta HTTP per assegnare un'opportunità in modo casuale ad un utente del tuo account noCRM.io.

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/assign/random

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/assign/random


Assegnare un'opportunità casualmente ad un utente non-amministratore

Usa la seguente richiesta HTTP per assegnare un'opportunità in modo casuale ad un utente nel tuo account noCRM che non è un amministratore.

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/assign/random?no_admin=true

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/assign/random?no_admin=true


Assegnare un'opportunità casualmente ad un utente di un team specifico

Utilizza la seguente richiesta HTTP per assegnare un'opportunità in modo casuale ad un utente di un team specifico.

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/assign/random_in_a_team?team_id=TeamID

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/assign/random_in_a_team?team_id=24


Spostare un'opportunità al passaggio successivo della pipeline

Usa la seguente richiesta HTTP per spostare un'opportunità al passaggio successivo nella pipeline di vendita in cui si trova.

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/next_step

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/next_step


Spostare un'opportunità al passaggio di tua scelta

Usa la seguente richiesta HTTP per spostare un'opportunità nello step di vendita che vuoi.

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/move_to_step?step_id=StepID

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/move_to_step?step_id=23


Aggiungere un tag ad un'opportunità

Utilizza la seguente richiesta HTTP per aggiungere uno o più tag ad un'opportunità

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/add_tag?tag=TagName

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/add_tag?tag=ProductA

Puoi anche aggiungere più tag contemporaneamente, separali semplicemente con virgole.
Esempio: add_tag?tag=tag1,tag2,tag3


Inviare un modello d'email

Utilizza la seguente richiesta HTTP per inviare il modello d'email che vuoi. Una mail verrà inviata all'indirizzo mail nell'opportunità e le variabili verranno sostituite dalle informazioni del contatto.

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/send_email_from_template?email_template_id=TemplateID&from_user_id=EmailADDRESS

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/send_email_from_template?email_template_id=12&from_user_id=rana@xyzcorp.com

Il parametro from_user_id è l'ID dell'utente o l'indirizzo mail che invia la mail.

⚠️Importante: Non sarà inviata la mail se:

  1. l'utente non può accedere al modello d'email (è possibile utilizzare solo modelli condivisi)
  2. ci sono ancora variabili nell'oggetto o nel corpo dopo la sostituzione
  3. l'indirizzo mail non c'è
  4. l'utente mittente non ha sincronizzato la propria casella di posta con il proprio account noCRM.io

Registrare un'azione svolta

Utilizza la richiesta HTTP seguente per registrare un'azione svolta in commento dell'opportunità.

https://AccountName.nocrm.io/api/simple/leads/LEAD_ID/add_activity?activity_id=ActivityID&user_id=EmailADDRESS&content=XXXXX

Esempio
https://nocrmcorp.nocrm.io/api/simple/leads/145676/add_activity?activity_id=45&user_id=35&content=Demo

Il parametro content è facoltativo. Il parametro id_attività è obbligatorio invece.


Lettura successiva: Strumenti no-code interni per connettere il gestionale aziendale