# Leitura de entidades do Intercom
<a name="intercom-reading-from-entities"></a>

 **Pré-requisitos** 
+  Um objeto do Intercom do qual você deseja ler. Consulte a tabela de entidades compatíveis abaixo para verificar as entidades disponíveis. 

 **Entidades compatíveis** 


| Entidade | API\_Version | Pode ser filtrada | Oferece suporte a limite | Oferece suporte a Ordenar por | Oferece suporte a Selecionar \* | Oferece suporte a particionamento | 
| --- | --- | --- | --- | --- | --- | --- | 
| Admins | v2.5 | Não | Não | Não | Sim | Não | 
| Empresas | v2.5 | Não | Sim | Não | Sim | Não | 
| Conversas | v2.5 | Sim | Sim | Sim | Sim | Sim | 
| Atributos de dados | v2.5 | Não | Não | Não | Sim | Não | 
| Contatos | v2.5 | Sim | Sim | Sim | Sim | Sim | 
| Segmentos | v2.5 | Não | Não | Não | Sim | Não | 
| Tags | v2.5 | Não | Não | Não | Sim | Não | 
| Equipes | v2.5 | Não | Não | Não | Sim | Não | 

 **Exemplo** 

```
Intercom_read = glueContext.create_dynamic_frame.from_options(
    connection_type="Intercom",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "company",
        "API_VERSION": "V2.5"
    }
)
```

 **Detalhes das entidades e dos campos do Intercom** 


| Entidade | Campo | Tipo de dado | Operadores com suporte | 
| --- | --- | --- | --- | 
| Admins | type | String | NA | 
| Admins | id | String | NA | 
| Admins | avatar | Struct | NA | 
| Admins | nome | String | NA | 
| Admins | email | String | NA | 
| Admins | away\_mode\_enabled | Booleano | NA | 
| Admins | away\_mode\_reassign | Booleano | NA | 
| Admins | has\_inbox\_seat | Booleano | NA | 
| Admins | teams\_ids | Lista | NA | 
| Admins | job\_title | String | NA | 
| Empresas | type | String | NA | 
| Empresas | id | String | NA | 
| Empresas | app\_id | String | NA | 
| Empresas | created\_at | DateTime | NA | 
| Empresas | remote\_created\_at | DateTime | NA | 
| Empresas | updated\_at | DateTime | NA | 
| Empresas | last\_request\_at | DateTime | NA | 
| Empresas | planejar | Struct | NA | 
| Empresas | company\_id | String | NA | 
| Empresas | nome | String | NA | 
| Empresas | custom\_attributes | Struct | NA | 
| Empresas | session\_count | Inteiro | NA | 
| Empresas | monthly\_spend | Inteiro | NA | 
| Empresas | user\_count | Inteiro | NA | 
| Empresas | setor | String | NA | 
| Empresas | size | Inteiro | NA | 
| Empresas | site | String | NA | 
| Empresas | tags | Struct | NA | 
| Empresas | segmentos | Struct | NA | 
| Contatos | id | String | EQUAL\_TO.NOT\_EQUAL\_TO | 
| Contatos | type | String | NA | 
| Contatos | workspace\_id | String | NA | 
| Contatos | external\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | perfil | String | EQUAL\_TO.NOT\_EQUAL\_TO | 
| Contatos | email | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | phone | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | nome | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | avatar | String | NA | 
| Contatos | owner\_id | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Contatos | social\_profiles | Struct | NA | 
| Contatos | has\_hard\_bounced | Booleano | EQUAL\_TO | 
| Contatos | marked\_email\_as\_spam | Booleano | EQUAL\_TO | 
| Contatos | unsubscribed\_from\_emails | Booleano | EQUAL\_TO | 
| Contatos | created\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Contatos | updated\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Contatos | signed\_up\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Contatos | last\_seen\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Contatos | last\_replied\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Contatos | last\_contacted\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Contatos | last\_email\_opened\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Contatos | last\_email\_clicked\_at | DateTime | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Contatos | language\_override | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | navegador | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | browser\_version | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | browser\_language | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | os | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | local | Struct | NA | 
| Contatos | location\_country | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | location\_region | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | location\_city | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | android\_app\_name | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | android\_app\_version | String | NA | 
| Contatos | android\_device | String | NA | 
| Contatos | android\_os\_version | String | NA | 
| Contatos | android\_sdk\_version | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | android\_last\_seen\_at | Data | NA | 
| Contatos | ios\_app\_name | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | ios\_app\_version | String | NA | 
| Contatos | ios\_device | String | NA | 
| Contatos | ios\_os\_version | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | ios\_sdk\_version | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Contatos | ios\_last\_seen\_at | DateTime | NA | 
| Contatos | custom\_attributes | Struct | NA | 
| Contatos | tags | Struct | NA | 
| Contatos | notes | Struct | NA | 
| Contatos | empresas | Struct | NA | 
| Contatos | unsubscribed\_from\_sms | Booleano | NA | 
| Contatos | sms\_consent | Booleano | NA | 
| Contatos | opted\_out\_subscription\_types | Struct | NA | 
| Contatos | indicador | String | NA | 
| Contatos | utm\_campaign | String | NA | 
| Contatos | utm\_content | String | NA | 
| Contatos | utm\_medium | String | NA | 
| Contatos | utm\_source | String | NA | 
| Contatos | utm\_term | String | NA | 
| Conversas | type | String | NA | 
| Conversas | id | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | created\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | updated\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | origem | Struct | NA | 
| Conversas | source\_id | String | EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | source\_type | String | EQUAL\_TO, NOT\_EQUAL\_TO, | 
| Conversas | source\_delivered\_as | String | EQUAL\_TO, NOT\_EQUAL\_TO, | 
| Conversas | source\_subject | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | source\_body | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | source\_author\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | source\_author\_type | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | source\_author\_name | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | source\_author\_email | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | source\_url | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | contacts | Struct | NA | 
| Conversas | colegas de equipe | Struct | NA | 
| Conversas | título | String | NA | 
| Conversas | admin\_assignee\_id | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | team\_assignee\_id | Inteiro | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | custom\_attributes | Struct | NA | 
| Conversas | aberto | Booleano | EQUAL\_TO | 
| Conversas | estado | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | leitura | Booleano | EQUAL\_TO | 
| Conversas | waiting\_since | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | snoozed\_until | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | tags | Struct | NA | 
| Conversas | first\_contact\_reply | Struct | NA | 
| Conversas | priority | String | EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | tópicos | Struct | NA | 
| Conversas | sla\_applied | Struct | NA | 
| Conversas | conversation\_rating | Struct | NA | 
| Conversas | conversation\_rating\_requested\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | conversation\_rating\_replied\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | conversation\_rating\_score | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | conversation\_rating\_remark | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | conversation\_rating\_contact\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | conversation\_rating\_admin\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | estatísticas | Struct | NA | 
| Conversas | statistics\_time\_to\_assignment | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_time\_to\_admin\_reply | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_time\_to\_first\_close | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_time\_to\_last\_close | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_median\_time\_to\_reply | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_first\_contact\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_first\_assignment\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_first\_admin\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_first\_close\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_last\_assignment\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_last\_assignment\_admin\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_last\_contact\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_last\_admin\_reply\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_last\_close\_at | DateTime | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_last\_closed\_by\_id | String | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| Conversas | statistics\_count\_reopens | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_count\_assignments | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | statistics\_count\_conversation\_parts | Inteiro | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| Conversas | conversation\_parts | Lista | NA | 
| Atributos de dados | id | Inteiro | NA | 
| Atributos de dados | type | String | NA | 
| Atributos de dados | modelo | String | NA | 
| Atributos de dados | nome | String | NA | 
| Atributos de dados | full\_name | String | NA | 
| Atributos de dados | rótulo | String | NA | 
| Atributos de dados | description | String | NA | 
| Atributos de dados | data\_type | String | NA | 
| Atributos de dados | options | Lista | NA | 
| Atributos de dados | api\_writable | Booleano | NA | 
| Atributos de dados | ui\_writable | Booleano | NA | 
| Atributos de dados | personalizado | Booleano | NA | 
| Atributos de dados | archived | Booleano | NA | 
| Atributos de dados | created\_at | Booleano | NA | 
| Atributos de dados | updated\_at | DateTime | NA | 
| Atributos de dados | admin\_id | String | NA | 
| Segmentos | type | String | NA | 
| Segmentos | id | String | NA | 
| Segmentos | nome | String | NA | 
| Segmentos | created\_at | DateTime | NA | 
| Segmentos | updated\_at | DateTime | NA | 
| Segmentos | person\_type | String | NA | 
| Segmentos | contagem | Inteiro | NA | 
| Tags | type | String | NA | 
| Tags | id | String | NA | 
| Tags | nome | String | NA | 
| Equipes | type | String | NA | 
| Equipes | id | String | NA | 
| Equipes | nome | String | NA | 
| Equipes | admin\_ids | Lista | NA | 

 **Particionamento de consultas** 

 Podem ser fornecidas as opções adicionais do Spark `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` e `NUM_PARTITIONS` se você quiser utilizar a simultaneidade no Spark. Com esses parâmetros, a consulta original seria dividida em `NUM_PARTITIONS` subconsultas, que poderiam ser executadas pelas tarefas do Spark simultaneamente. 
+  `PARTITION_FIELD`: o nome do campo a ser usado para particionar a consulta. 
+  `LOWER_BOUND`: um valor limite inferior inclusivo do campo de partição escolhido. 

   Na data, aceitamos o formato de data do Spark usado em consultas SQL do Spark. Exemplo de valores válidos: `"2024-02-06"`. 
+  `UPPER_BOUND`: um valor limite superior exclusivo do campo de partição escolhido. 
+  `NUM_PARTITIONS`: número de partições. 

 Os detalhes do suporte do campo de particionamento relativo às entidades são capturados na tabela a seguir. 


| Entity Name | Campo de particionamento | Tipo de dado | 
| --- | --- | --- | 
| Contatos | created\_at, updated\_at,last\_seen\_at | DateTime | 
| Conversas | id | Inteiro | 
| Conversas | created\_at, updated\_at | DateTime | 

 **Exemplo** 

```
Intercom_read = glueContext.create_dynamic_frame.from_options(
    connection_type="Intercom",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "conversation",
        "API_VERSION": "V2.5",
        "PARTITION_FIELD": "created_at"
        "LOWER_BOUND": "2022-07-13T07:55:27.065Z"
        "UPPER_BOUND": "2022-08-12T07:55:27.065Z"
        "NUM_PARTITIONS": "2"
    }
)
```