Difference between revisions of "Protemos add-on to Gmail"

From Protemos Wiki
Jump to: navigation, search
(How to start using the add-on)
 
(114 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
<span style="color:red">This page is not completed yet.</span>
 
 
 
Using this Gmail add-on, you can quickly convert email messages from your clients into quotes and projects in your Protemos Enterprise account without manual copy-paste work. You can also create client profiles and contact persons based on email messages.
 
Using this Gmail add-on, you can quickly convert email messages from your clients into quotes and projects in your Protemos Enterprise account without manual copy-paste work. You can also create client profiles and contact persons based on email messages.
  
 +
=='''How to start using add-on'''==
  
=='''Step-by step instruction on how to start using the add-on'''==
+
1. You need to use Gmail as a browser mail client. So please add your mailbox to Gmail.
  
1. You need to use Gmail as mail client. So please add your mailbox to Gmail.
+
2. Once logged in, please click the “+” icon to the right of the message list area:
  
2. Once logged in, please press “+” icon to the right of the message list area:
+
[[File:Add-on installation1.png|border|150px]]
  
[[File:Addon1.png|border|200px]]
+
3. Search for the Protemos add-on:
 
 
3. Search for Protemos add-on:
 
 
 
[[File:Addon2.png|border|750px]]
 
  
 +
[[File:Add-on installation2.png|border|1000px]]
  
 
4. Install it:
 
4. Install it:
  
[[File:Addon3.png|border|750px]]
+
[[File:Add-on installation3.png|border|1000px]]
 
 
 
 
5. Now, once the add-on is installed, open an email message that you want to convert into a project, and click Protemos icon to the right:
 
 
 
[[File:Addon4.png|border|750px]]
 
  
 +
5. Now, once the add-on is installed, open an email message that you want to convert into a quote or project, and click the Protemos icon to the right:
  
6. The system will ask you to enter API key. You can find it on your account page https://cloud.protemos.com/account/view:
+
[[File:Add-on installation4.1.png|border|1000px]]
  
[[File:Addon5.png|border|750px]]
+
6. The system will ask you to enter an API key. You can find it on your [https://cloud.protemos.com/account/view account page]:
  
Note: an owner of the company is the only manager who has access to API key.
+
[[File:Add-on installation5.png|border|1000px]]
 
  
7. Enter the key and press Enter:
+
::<span style="color:red">'''Note:'''</span> an account owner is the only manager who has access to API key.
  
[[File:Addon6.png|border|750px]]
+
7. Enter the key and click Enter:
  
 +
[[File:Add-on installation6.png|border|400px]]
  
Once API key is entered, you can start using it.
+
Once the API key is entered, you can start using the add-on.
  
 
=='''Create new quote'''==
 
=='''Create new quote'''==
  
If the contact is already in your Protemos database, you can create a quote for this client using the add-on. To do it press the “Create quote” button.
+
If the contact is already in your Protemos database, you can create a quote for this client using the add-on. To do it, click the “Create Quote” button:
  
[[File:Addon11.png|border|750px]]
+
[[File:Creating quote with addon1.png|border|1000px]]
  
 
Fill in the compulsory fields that are marked with an asterisk and click “Submit”:
 
Fill in the compulsory fields that are marked with an asterisk and click “Submit”:
  
 +
[[File:Creating quote with addon2.2.png|border|300px]]
  
[[File:Addon8.png|border|500px]]
+
The system will show you the URL of the created quote:
  
 +
[[File:Creating quote with addon3.png|border|300px]]
  
The system will show you the URL of the created quote:
+
Click on the link, and it will bring you to the quote page on Protemos.
  
[[File:Addon9.png|border|500px]]
+
=='''Create new project'''==
  
 +
If the contact is already in your Protemos database, you can create a project for this client using the add-on. To do it, click the "Create Project" button.
  
Click on the link and it will bring you to the quote page in Protemos.
+
[[File:Creating project with addon1.png|border|1000px]]
  
=='''Create new project'''==
+
Fill in the compulsory fields that are marked with an asterisk and click "Submit":
  
If the contact is already in your Protemos database, you can create a project for this client using the add-on. To do it press the “Create project” button.
+
[[File:Creating project with addon2.png|border|300px]]
  
[[File:Addon11.png|border|750px]]
+
The system will show you the URL of the created project:
  
Fill in the compulsory fields that are marked with an asterisk and click “Submit”:
+
[[File:Creating project with addon3.png|border|300px]]
  
[[File:Addon8.png|border|500px]]
+
Click on the link, and it will bring you to the project page on Protemos.
  
 +
==='''Using project templates'''===
  
The system will show you the URL of the created project:
+
When creating a project with the add-on, you can use a [[Project templates|project template]]. To do it, click on the "Template" field and select the project template from the drop-down list:
  
[[File:Addon9.png|border|500px]]
+
[[File:Selecting project template1.png|border|300px]]
  
 +
By default, the system uses the template values, but the corresponding add-on values will override it. For example:
  
Click on the link and it will bring you to the project page in Protemos.
+
If the language pairs aren't defined when creating the project with the add-on, then the ones from the selected template will be applied. It applies to all other fields.
  
==='''Using project templates'''===
+
::<span style="color:orange">'''Note:'''</span> If you specify one or more language pairs and select a template with predefined language pairs, then both the language pairs specified in the add-on and the ones from the template will be applied.
  
You can choose one of your project templates when creating a project using the add-on. However, please note that the way values are transferred to the project may vary. There are two possible options:
+
=='''Create new client'''==
  
1. If you define one or more language pairs and select a template with predefined language pairs, then the add-on will override values from the template. The same logic applies to selecting a client, contact person, and secondary manager.
+
If you receive an email message from someone who is not on your Protemos client list, the add-on will suggest you create a new client profile or contact person first:
 
 
2. If the language pairs aren't defined when creating the project, then the ones from the selected template will be applied.
 
  
<span style="color:red">'''Note:'''</span> using a template with jobs that have language pairs will not allow you to transfer any data defined in the add-on fields.
+
[[File:Creating new client1.png|border|1000px]]
  
==='''Using project templates'''===
+
To create a new client profile, click the "Create Client" button:
  
When creating a project, you can use a [[Project templates|project template]].
+
[[File:Creating new client2.png|border|300px]]
 
::<span style="color:red">'''Note:'''</span> Temporarily, please do not use the templates with ''jobs with language pairs''. The add-on data will be ignored.
 
  
By default, the system uses the template values, but the corresponding add-on values will override it. It applies to "Language pairs", "Client", "Contact person", and "Secondary manager" fields.
+
Choose a legal entity, fill in information if needed and click the "Submit" button:
  
 +
[[File:Creating new client3.png|border|300px]]
  
=='''Create new client profile'''==
+
The new client profile will be created, and you will see the "Create Project" and "Create Quote" buttons:
  
If you receive an email message from someone who is not on your Protemos client list, the add-on will suggest you create a new client profile or contact person first:
+
[[File:Creating new client4.png|border|300px]]
  
 +
Follow instructions for creating the project or quote.
  
[[File:Addon10.png|border|500px]]
+
=='''Create new contact person'''==
  
To create a new client profile press the "New client" button.
+
You can create a new contact person for the already existing client. Click the "Create Contact" button to do it:
  
Choose a legal entity, press the "Submit" button.
+
[[File:Create new contact1.png|border|300px]]
1. If it’s the new client, click “New client” button. If it’s just a new contact of the existing client, click “Create contact”.
 
  
2. In the dialog that opens next, check the fields, modify if needed, and click “Submit”. It will create the client or contact in your Protemos database.
+
Choose a client, fill in information if needed and click the "Submit" button:
  
3. Once the client/contact is created, you’ll see “Create project” and “Create quote” buttons:
+
[[File:Create new contact2.png|border|300px]]
  
[[File:Addon11.png|border|750px]]
+
The new contact person will be created, and you will see the "Create Project" and "Create Quote" buttons:
  
 +
[[File:Creating new client4.png|border|300px]]
  
4. Follow project/quote instructions above.
+
Follow instructions for creating the project or quote.

Latest revision as of 11:27, 12 October 2022

Using this Gmail add-on, you can quickly convert email messages from your clients into quotes and projects in your Protemos Enterprise account without manual copy-paste work. You can also create client profiles and contact persons based on email messages.

How to start using add-on

1. You need to use Gmail as a browser mail client. So please add your mailbox to Gmail.

2. Once logged in, please click the “+” icon to the right of the message list area:

Add-on installation1.png

3. Search for the Protemos add-on:

Add-on installation2.png

4. Install it:

Add-on installation3.png

5. Now, once the add-on is installed, open an email message that you want to convert into a quote or project, and click the Protemos icon to the right:

Add-on installation4.1.png

6. The system will ask you to enter an API key. You can find it on your account page:

Add-on installation5.png

Note: an account owner is the only manager who has access to API key.

7. Enter the key and click Enter:

Add-on installation6.png

Once the API key is entered, you can start using the add-on.

Create new quote

If the contact is already in your Protemos database, you can create a quote for this client using the add-on. To do it, click the “Create Quote” button:

Creating quote with addon1.png

Fill in the compulsory fields that are marked with an asterisk and click “Submit”:

Creating quote with addon2.2.png

The system will show you the URL of the created quote:

Creating quote with addon3.png

Click on the link, and it will bring you to the quote page on Protemos.

Create new project

If the contact is already in your Protemos database, you can create a project for this client using the add-on. To do it, click the "Create Project" button.

Creating project with addon1.png

Fill in the compulsory fields that are marked with an asterisk and click "Submit":

Creating project with addon2.png

The system will show you the URL of the created project:

Creating project with addon3.png

Click on the link, and it will bring you to the project page on Protemos.

Using project templates

When creating a project with the add-on, you can use a project template. To do it, click on the "Template" field and select the project template from the drop-down list:

Selecting project template1.png

By default, the system uses the template values, but the corresponding add-on values will override it. For example:

If the language pairs aren't defined when creating the project with the add-on, then the ones from the selected template will be applied. It applies to all other fields.

Note: If you specify one or more language pairs and select a template with predefined language pairs, then both the language pairs specified in the add-on and the ones from the template will be applied.

Create new client

If you receive an email message from someone who is not on your Protemos client list, the add-on will suggest you create a new client profile or contact person first:

Creating new client1.png

To create a new client profile, click the "Create Client" button:

Creating new client2.png

Choose a legal entity, fill in information if needed and click the "Submit" button:

Creating new client3.png

The new client profile will be created, and you will see the "Create Project" and "Create Quote" buttons:

Creating new client4.png

Follow instructions for creating the project or quote.

Create new contact person

You can create a new contact person for the already existing client. Click the "Create Contact" button to do it:

Create new contact1.png

Choose a client, fill in information if needed and click the "Submit" button:

Create new contact2.png

The new contact person will be created, and you will see the "Create Project" and "Create Quote" buttons:

Creating new client4.png

Follow instructions for creating the project or quote.