Dynamics 365

Visão geral

O Dynamics 365 da Microsoft combina aplicações de CRM, ERP e produtividade para agilizar vendas, marketing, atendimento ao cliente e operações em uma plataforma integrada. Com a integração no SquadOS, seus agentes podem criar e atualizar registros de contas, contatos, leads, oportunidades, faturas, cases e pedidos de vendas diretamente no Dynamics CRM via Web API — automatizando fluxos comerciais de ponta a ponta sem intervenção manual.

• Site oficial: https://www.microsoft.com/dynamics-365/
• Documentação na Composio: docs.composio.dev/toolkits/dynamics365

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

Você vai precisar autorizar o acesso à sua conta Microsoft/Dynamics 365 pelo fluxo OAuth gerenciado pela Composio. Nenhuma chave de API manual é necessária — a Composio cuida da obtenção e renovação do token de acesso.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Dynamics 365.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso à sua conta Microsoft com as permissões necessárias do Dynamics 365.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Criar conta

DYNAMICS365_DYNAMICSCRM_CREATE_ACCOUNT

Cria um novo registro de entidade de conta no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Não	O nome da nova conta a ser criada.
revenue	number	Não	A receita associada à conta.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
description	string	Não	Uma descrição da conta.
creditonhold	boolean	Não	Indica se a conta está com crédito suspenso.
accountcategorycode	integer	Não	O código de categoria da conta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar case

DYNAMICS365_DYNAMICSCRM_CREATE_CASE

Cria um novo registro de entidade de case (incidente) no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
title	string	Não	O assunto ou título do case.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
account_id	string	Não	Referência à conta relacionada. Formato: ‘/accounts(GUID)‘
contact_id	string	Não	Referência ao contato relacionado. Formato: ‘/contacts(GUID)‘
description	string	Não	Descrição detalhada do problema ou solicitação.
prioritycode	integer	Não	Nível de prioridade do case (ex.: 1 para Baixo, 2 para Normal, 3 para Alto).
caseorigincode	integer	Não	Origem do case. Valores válidos: 1 (Telefone), 2 (E-mail), 3 (Web).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar contato

DYNAMICS365_DYNAMICSCRM_CREATE_CONTACT

Cria um novo registro de entidade de contato no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
jobtitle	string	Não	O cargo do contato.
lastname	string	Não	O sobrenome do contato.
firstname	string	Não	O nome do contato.
telephone1	string	Não	O número de telefone principal do contato.
mobilephone	string	Não	O número de celular do contato.
address1_city	string	Não	A cidade do endereço do contato.
emailaddress1	string	Não	O endereço de e-mail principal do contato.
address1_country	string	Não	O país do endereço do contato.
address1_postalcode	string	Não	O CEP/código postal do endereço do contato.
address1_stateorprovince	string	Não	O estado ou província do endereço do contato.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar fatura

DYNAMICS365_DYNAMICSCRM_CREATE_INVOICE

Cria um novo registro de entidade de fatura no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Não	O nome ou número da fatura.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
account_id	string	Não	Referência à conta relacionada. Formato: ‘/accounts(GUID)‘
currency_id	string	Não	Referência à moeda da transação. Formato: ‘/transactioncurrencies(GUID)‘
description	string	Não	Descrição da fatura.
price_level_id	string	Não	Referência à lista de preços. Formato: ‘/pricelevels(GUID)‘

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar lead

DYNAMICS365_DYNAMICSCRM_CREATE_LEAD

Cria um novo registro de entidade de lead no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
subject	string	Não	Breve descrição ou título do lead.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado. Defina explicitamente ao criar leads em nome de outros usuários em fluxos multi-usuário ou automatizados.
lastname	string	Não	Sobrenome do lead.
firstname	string	Não	Nome do lead.
telephone1	string	Não	Número de telefone principal do lead.
companyname	string	Não	Nome da empresa associada ao lead. Pode ser obrigatório em algumas configurações de CRM; omiti-lo pode fazer a requisição ser rejeitada.
emailaddress1	string	Não	Endereço de e-mail principal do lead.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar oportunidade

DYNAMICS365_DYNAMICSCRM_CREATE_OPPORTUNITY

Cria um novo registro de entidade de oportunidade no Dynamics CRM usando a Web API. Algumas configurações de CRM exigem estimatedclosedate e uma moeda de transação no nível do servidor, mesmo que sejam opcionais no schema; omiti-los pode causar rejeição da requisição.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	O nome ou título da oportunidade. Este é um campo obrigatório.
description	string	Não	Breve descrição da oportunidade.
estimatedvalue	number	Não	A receita prevista da oportunidade.
estimatedclosedate	string	Não	Data prevista de fechamento da oportunidade no formato ‘YYYY-MM-DD’.
customer_account_id	string	Não	O GUID da conta relacionada (sem chaves). Opcional.
customer_contact_id	string	Não	O GUID do contato relacionado (sem chaves). Opcional.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar pedido de vendas

DYNAMICS365_DYNAMICSCRM_CREATE_SALES_ORDER

Cria um novo registro de entidade de pedido de vendas no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Não	O nome do pedido de vendas.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
account_id	string	Não	Referência à conta relacionada. Formato: ‘/accounts(GUID)‘
currency_id	string	Não	Referência à moeda da transação. Formato: ‘/transactioncurrencies(GUID)‘
description	string	Não	Descrição do pedido de vendas.
price_level_id	string	Não	Referência à lista de preços. Formato: ‘/pricelevels(GUID)‘

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter fatura

DYNAMICS365_DYNAMICSCRM_GET_A_INVOICE

Recupera os dados de uma fatura específica no Dynamics CRM pelo seu identificador.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
invoice_id	string	Sim	O ID da fatura a recuperar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter lead

DYNAMICS365_DYNAMICSCRM_GET_A_LEAD

Recupera os dados de um lead específico no Dynamics CRM pelo seu identificador.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
lead_id	string	Sim	O ID do lead a recuperar (formato GUID). Use o valor exatamente como retornado pelas ferramentas do Dynamics CRM — não reformate nem trunque.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar todos os leads

DYNAMICS365_DYNAMICSCRM_GET_ALL_LEADS

Retorna uma lista de leads do Dynamics CRM com suporte a paginação, filtros e ordenação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
top	integer	Não	Número máximo de leads a retornar.
skip	integer	Não	Número de leads a pular para paginação.
filter	string	Não	Critérios de filtro OData para leads (ex.: contains(fullname,'João')). Filtros de data exigem formato ISO 8601 (ex.: createdon gt 2024-01-01T00:00:00Z).
select	string	Não	Lista de campos separados por vírgula a retornar (ex.: fullname,emailaddress1).
orderby	string	Não	Campo de ordenação (ex.: createdon desc).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar case

DYNAMICS365_DYNAMICSCRM_UPDATE_CASE

Atualiza um registro de entidade de case (incidente) existente no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
title	string	Não	O assunto ou título do case.
case_id	string	Sim	O identificador único (GUID) do case a atualizar.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
statuscode	integer	Não	O status atual do case (ex.: 1 para Ativo, 2 para Em andamento, 3 para Resolvido).
description	string	Não	Descrição detalhada do problema ou solicitação.
prioritycode	integer	Não	Nível de prioridade do case (ex.: 1 para Alto, 2 para Normal, 3 para Baixo).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar fatura

DYNAMICS365_DYNAMICSCRM_UPDATE_INVOICE

Atualiza um registro de entidade de fatura existente no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Não	O nome ou número atualizado da fatura.
duedate	string	Não	A data de vencimento atualizada da fatura no formato YYYY-MM-DD.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
invoice_id	string	Sim	O identificador único (GUID) da fatura a atualizar.
description	string	Não	A descrição atualizada da fatura.
totalamount	number	Não	O valor total atualizado da fatura.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar lead

DYNAMICS365_DYNAMICSCRM_UPDATE_LEAD

Atualiza um registro de entidade de lead existente no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
lead_id	string	Sim	O identificador único (GUID) do lead a atualizar. Deve ser passado exatamente como retornado pelas ferramentas de consulta do Dynamics CRM — sem chaves adicionadas nem formatação de traços modificada.
subject	string	Não	Breve descrição ou título do lead.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
lastname	string	Não	Sobrenome do lead.
firstname	string	Não	Nome do lead.
telephone1	string	Não	Número de telefone principal do lead.
companyname	string	Não	Nome da empresa associada ao lead.
emailaddress1	string	Não	Endereço de e-mail principal do lead.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar oportunidade

DYNAMICS365_DYNAMICSCRM_UPDATE_OPPORTUNITY

Atualiza um registro de entidade de oportunidade existente no Dynamics CRM usando a Web API. Algumas atualizações podem ser rejeitadas se campos relacionais obrigatórios (ex.: moeda de transação) estiverem ausentes do registro, mesmo que não sejam parâmetros explícitos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Não	O nome ou título da oportunidade.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
description	string	Não	Breve descrição da oportunidade.
estimatedvalue	number	Não	A receita prevista da oportunidade.
opportunity_id	string	Sim	O identificador único (GUID) da oportunidade a atualizar. Use o GUID exatamente como retornado pelas ferramentas de consulta do CRM — reformatar o valor causará falha na atualização.
salesstagecode	integer	Não	O estágio de vendas atual (ex.: 1 para Qualificar, 2 para Desenvolver, 3 para Propor).
estimatedclosedate	string	Não	Data prevista de fechamento da oportunidade no formato ‘YYYY-MM-DD’.
opportunityratingcode	integer	Não	A avaliação da oportunidade (ex.: 1 para Frio, 2 para Morno, 3 para Quente).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar pedido de vendas

DYNAMICS365_DYNAMICSCRM_UPDATE_SALES_ORDER

Atualiza um registro de entidade de pedido de vendas existente no Dynamics CRM usando a Web API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Não	O nome atualizado do pedido de vendas.
user_id	string	Não	O ID do usuário ou ‘me’ para o usuário autenticado.
description	string	Não	A descrição atualizada do pedido de vendas.
freightamount	number	Não	O valor de frete ou envio atualizado do pedido.
salesorder_id	string	Sim	O identificador único (GUID) do pedido de vendas a atualizar.
discountamount	number	Não	O valor de desconto atualizado do pedido.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar todas as faturas

DYNAMICS365_GET_ALL_INVOICES_ACTION

Retorna uma lista de faturas do Dynamics CRM com suporte a paginação, filtros e ordenação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
top	integer	Não	Número máximo de faturas a retornar.
skip	integer	Não	Número de faturas a pular para paginação.
filter	string	Não	Critérios de filtro OData para faturas (ex.: contains(customerName,'Contoso')).
select	string	Não	Lista de campos separados por vírgula a retornar (ex.: invoiceid,name,totalamount).
orderby	string	Não	Campo de ordenação (ex.: createdon desc).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.