Google Contacts
Consultar e administrar contatos do Google.
O que faz
Integre o Google Contacts ao fluxo. Cria, lê, atualiza, exclui, lista e busca contatos.
Quando usar: Use quando o seu fluxo precisar consultar e administrar contatos do Google.
Exemplo de situação: Organizar o processo e encaminhar cada caso para a etapa certa.
Antes de começar
Conexão necessária: OAuth.
Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
Passo a passo
- Adicione Google Contacts ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Criar contato | Cria contato com o bloco Google Contacts. |
| Obter contato | Obtém contato com o bloco Google Contacts. |
| Listar contatos | Lista contatos com o bloco Google Contacts. |
| Buscar contatos | Busca contatos com o bloco Google Contacts. |
| Atualizar contato | Atualiza contato com o bloco Google Contacts. |
| Excluir contato | Exclui contato com o bloco Google Contacts. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Criar contato · Obter contato · Listar contatos · Buscar contatos · Atualizar contato · Excluir contato
- Padrão:
- Criar contato
Conta do Google Contacts
ObrigatórioSeleciona a conta já conectada que autoriza o acesso ao serviço.
- Exemplo:
- (escolha a conta conectada)
Conta do Google Contacts
ObrigatórioEm campos adicionaisInforma manualmente a credencial usada pela integração no modo avançado.
Conta representada
E-mail do usuário a representar (para contas de serviço).
- Exemplo:
- cliente@exemplo.com
Nome
Obrigatório conforme a operaçãoDefine o nome ou título usado para identificar o recurso.
- Aparece em:
- Criar contato, Atualizar contato
- Exemplo:
- Exemplo de atendimento
Sobrenome
Define o nome ou título usado para identificar o recurso.
- Aparece em:
- Criar contato, Atualizar contato
- Exemplo:
- Exemplo de atendimento
E-mail
Informa o destinatário ou endereço de e-mail usado pela operação.
- Aparece em:
- Criar contato, Atualizar contato
- Exemplo:
- cliente@exemplo.com
Tipo de e-mail
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar contato, Atualizar contato
- Opções:
- Trabalho · Casa · Outro
- Padrão:
- Trabalho
Telefone
Identifica a conversa, o canal ou o telefone de destino.
- Aparece em:
- Criar contato, Atualizar contato
- Exemplo:
- +5511999999999
Tipo de telefone
Em campos adicionaisIdentifica a conversa, o canal ou o telefone de destino.
- Aparece em:
- Criar contato, Atualizar contato
- Opções:
- Celular · Casa · Trabalho · Outro
- Padrão:
- Celular
Empresa
Acme Ltda.
- Aparece em:
- Criar contato, Atualizar contato
- Exemplo:
- Acme Ltda
Cargo
Engenheiro de software.
- Aparece em:
- Criar contato, Atualizar contato
- Exemplo:
- Exemplo de atendimento
Observações
Em campos adicionaisObservações adicionais sobre o contato.
- Aparece em:
- Criar contato, Atualizar contato
- Exemplo:
- Observações adicionais sobre o contato
Nome do recurso (resourceName)
Obrigatório conforme a operaçãoDefine o nome ou título usado para identificar o recurso.
- Aparece em:
- Obter contato, Atualizar contato, Excluir contato
- Exemplo:
- Exemplo de atendimento
ETag
Obrigatório conforme a operaçãoETag obtido em uma consulta anterior ao contato.
- Aparece em:
- Atualizar contato
- Exemplo:
- ETag obtido em uma consulta anterior ao contato
Consulta de busca
Obrigatório conforme a operaçãoInforma a consulta usada para localizar ou transformar dados.
- Aparece em:
- Buscar contatos
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Itens por página
Em campos adicionaisDefine um valor numérico, quantidade ou limite da operação.
- Aparece em:
- Listar contatos, Buscar contatos
- Exemplo:
- 10
Token da página
Em campos adicionaisToken da listagem anterior.
- Aparece em:
- Listar contatos
- Exemplo:
- Token da listagem anterior
Ordem
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Listar contatos
- Opções:
- Última modificação (decrescente) · Última modificação (crescente) · Nome (crescente) · Sobrenome (crescente)
- Padrão:
- Última modificação (decrescente)
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <googlecontacts.content>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<googlecontacts.content> | string | Conteúdo da resposta da operação. |
<googlecontacts.metadata> | json | Metadados do contato ou dos contatos. |
Exemplo de uso
Objetivo: Organizar o processo e encaminhar cada caso para a etapa certa.
- Operação
- Criar contato
- Conta do Google Contacts
- (escolha a conta conectada)
- Conta representada
- cliente@exemplo.com
- Nome
- Exemplo de atendimento
- Sobrenome
- Exemplo de atendimento
- cliente@exemplo.com
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <googlecontacts.content>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Erro de autorização ou permissão (401/403)
- A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- Atualizar evento · Google CalendarAtualizar evento usando a conexão Google Calendar deste workspace.
- Atualizar tarefa · Google TasksAtualizar tarefa usando a conexão Google Tasks deste workspace.
- Compartilhar agenda · Google CalendarCompartilhar agenda usando a conexão Google Calendar deste workspace.
- Convidar participantes · Google CalendarConvidar participantes usando a conexão Google Calendar deste workspace.
- Criar agenda · Google CalendarCriar agenda usando a conexão Google Calendar deste workspace.
- Criar evento · Google CalendarCriar evento usando a conexão Google Calendar deste workspace.