Conjunto de permissões e configuração de acesso
Para conectar a Cooby ao Salesforce com sucesso e garantir que os chats do WhatsApp sejam sincronizados corretamente entre os dois sistemas, os usuários precisam ter o perfil e as configurações de permissão corretos.
Se você ainda não atribuiu os conjuntos de permissões necessários, siga primeiro as etapas do nosso guia de Configuração do administrador para concluir a configuração.
Se você já atribuiu o Cooby Admin/Member Permission Set e o Cooby Required Field Permission Set ao usuário da integração, mas ainda vê a mensagem de erro “You are unable to access the Salesforce integration.” no WhatsApp Web, isso pode indicar que o usuário não tem acesso suficiente para que o sistema conclua a configuração.
Este artigo explica como resolver esse problema em dois cenários comuns.
I. Se o perfil do usuário puder ser alterado
Na maioria dos casos, esse erro aparece quando o usuário tem um perfil de acesso limitado, como Read Only ou Minimum Access – Salesforce.
Esses tipos de perfil não oferecem acesso suficiente para que a integração da Cooby com o Salesforce funcione corretamente.
Como corrigir:
- Acesse Configuração (Setup) no Salesforce.
- Abra o Perfil do usuário afetado.
- Altere para Standard User ou para um perfil personalizado equivalente com permissões suficientes.
- Salve as alterações e reconecte a Cooby ao Salesforce.
Após a atualização, a conexão deve funcionar normalmente.
II. Se o perfil do usuário não puder ser alterado
Se não for possível alterar o tipo de perfil do usuário, verifique se ele tem todas as permissões de Objeto e de Campo necessárias.
Etapa 1. Verificar as permissões de objeto
Para administradores
Nome do objeto | Permitir criação | Permitir exclusão | Permitir edição | Permitir leitura | Modificar todos os registros | Exibir todos os registros |
|---|---|---|---|---|---|---|
Contact | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Lead | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Account | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
Opportunity | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
User | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
Message__c | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
Message_Attachment__c | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
WhatsApp_user__c | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
WhatsApp_chat__c | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
Para membros
Nome do objeto | Permitir criação | Permitir exclusão | Permitir edição | Permitir leitura | Modificar todos os registros | Exibir todos os registros |
|---|---|---|---|---|---|---|
Contact | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Lead | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Account | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
Opportunity | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
User | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
Message__c | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Message_Attachment__c | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
WhatsApp_user__c | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
WhatsApp_chat__c | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Etapa 2. Verificar as permissões de campo
Cada objeto deve seguir os mesmos requisitos de permissão de campo das permissões de objeto acima.
Seja o usuário administrador ou membro, verifique se os seguintes campos têm o acesso adequado:
Nome do objeto | Nome do campo | Editar | Ler |
|---|---|---|---|
Contact | AccountId | ✅ | ✅ |
Contact | Description | ✅ | ✅ |
Contact | ✅ | ✅ | |
Contact | HomePhone | ✅ | ✅ |
Contact | LeadSource | ✅ | ✅ |
Contact | MobilePhone | ✅ | ✅ |
Contact | OtherPhone | ✅ | ✅ |
Contact | Phone | ✅ | ✅ |
Contact | First_message_from_contact_1to1__c | ✅ | ✅ |
Contact | First_message_from_contact_all__c | ✅ | ✅ |
Contact | First_message_from_contact_group__c | ✅ | ✅ |
Contact | First_message_from_team_1to1__c | ✅ | ✅ |
Contact | First_message_from_team_all__c | ✅ | ✅ |
Contact | First_message_from_team_group__c | ✅ | ✅ |
Contact | Formatted_Phone__c | ✅ | ✅ |
Contact | Last_WhatsApp_properties_sync_time__c | ✅ | ✅ |
Contact | Last_message_from_contact_1to1__c | ✅ | ✅ |
Contact | Last_message_from_contact_all__c | ✅ | ✅ |
Contact | Last_message_from_contact_group__c | ✅ | ✅ |
Contact | Last_message_from_team_1to1__c | ✅ | ✅ |
Contact | Last_message_from_team_all__c | ✅ | ✅ |
Contact | Last_message_from_team_group__c | ✅ | ✅ |
Contact | WhatsApp_Formatted_Phone__c | ✅ | ✅ |
Contact | WhatsApp_user__c | ✅ | ✅ |
Lead | Address | ✅ | ✅ |
Lead | AnnualRevenue | ✅ | ✅ |
Lead | Description | ✅ | ✅ |
Lead | DoNotCall | ✅ | ✅ |
Lead | ✅ | ✅ | |
Lead | Industry | ✅ | ✅ |
Lead | LeadSource | ✅ | ✅ |
Lead | MobilePhone | ✅ | ✅ |
Lead | NumberOfEmployees | ✅ | ✅ |
Lead | Phone | ✅ | ✅ |
Lead | Rating | ✅ | ✅ |
Lead | Title | ✅ | ✅ |
Lead | Website | ✅ | ✅ |
Lead | First_message_from_contact_1to1__c | ✅ | ✅ |
Lead | First_message_from_contact_all__c | ✅ | ✅ |
Lead | First_message_from_contact_group__c | ✅ | ✅ |
Lead | First_message_from_team_1to1__c | ✅ | ✅ |
Lead | First_message_from_team_all__c | ✅ | ✅ |
Lead | First_message_from_team_group__c | ✅ | ✅ |
Lead | Formatted_Phone__c | ✅ | ✅ |
Lead | Last_WhatsApp_properties_sync_time__c | ✅ | ✅ |
Lead | Last_message_from_contact_1to1__c | ✅ | ✅ |
Lead | Last_message_from_contact_all__c | ✅ | ✅ |
Lead | Last_message_from_contact_group__c | ✅ | ✅ |
Lead | Last_message_from_team_1to1__c | ✅ | ✅ |
Lead | Last_message_from_team_all__c | ✅ | ✅ |
Lead | Last_message_from_team_group__c | ✅ | ✅ |
Lead | WhatsApp_Formatted_Phone__c | ✅ | ✅ |
Lead | WhatsApp_user__c | ✅ | ✅ |
Message_Attachment__c | Size__c | ✅ | ✅ |
Message_Attachment__c | Type__c | ✅ | ✅ |
Message_Attachment__c | Url__c | ✅ | ✅ |
Message_Attachment__c | WhatsApp_Message__c | ✅ | ✅ |
Message__c | External_Id__c | ✅ | ✅ |
Message__c | Is_Manually_Synced__c | ✅ | ✅ |
Message__c | Is_Sent_by_Target_user__c | ❌ | ✅ |
Message__c | Message_Id__c | ✅ | ✅ |
Message__c | Message_body__c | ✅ | ✅ |
Message__c | Related_Account__c | ✅ | ✅ |
Message__c | Related_Contact__c | ✅ | ✅ |
Message__c | Related_Lead__c | ✅ | ✅ |
Message__c | Related_Opportunity__c | ✅ | ✅ |
Message__c | Related_Task__c | ✅ | ✅ |
Message__c | Sender_Phone__c | ❌ | ✅ |
Message__c | Sent_Datetime__c | ❌ | ✅ |
Message__c | Sent_time__c | ✅ | ✅ |
User | Phone__c | ✅ | ✅ |
WhatsApp_chat__c | Is_Group_Chat__c | ✅ | ✅ |
WhatsApp_chat__c | Syncer__c | ✅ | ✅ |
WhatsApp_user__c | First_Name__c | ✅ | ✅ |
WhatsApp_user__c | Picture_URL__c | ✅ | ✅ |
Etapa 3. Reatribuir ou atualizar os conjuntos de permissões
Se você atualizou as permissões ou criou um novo conjunto de permissões, reatribua-o aos usuários afetados para que as alterações entrem em vigor.
- Acesse Configuração → Conjuntos de permissões (Setup → Permission Sets) no Salesforce.
- Selecione o conjunto de permissões atualizado (por exemplo,
Custom Permission Set for Cooby). - Clique em Gerenciar atribuições → Adicionar atribuições.
- Selecione os usuários que precisam de acesso.
- Clique em Atribuir e depois em Concluído.
Depois de salvar, peça ao usuário para reconectar a Cooby ao Salesforce para concluir a atualização.
Esperamos que este documento ajude você a entender melhor como a Cooby funciona. Para qualquer dúvida sobre a integração com o Salesforce, envie um e-mail para support@cooby.co 💜
Actualizado em: 16/10/2026
Obrigado!
