# 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\$1Version | Pode ser filtrada | Oferece suporte a limite | Oferece suporte a Ordenar por | Oferece suporte a Selecionar \$1 | 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\$1mode\$1enabled | Booleano | NA | 
| Admins | away\$1mode\$1reassign | Booleano | NA | 
| Admins | has\$1inbox\$1seat | Booleano | NA | 
| Admins | teams\$1ids | Lista | NA | 
| Admins | job\$1title | String | NA | 
| Empresas | type | String | NA | 
| Empresas | id | String | NA | 
| Empresas | app\$1id | String | NA | 
| Empresas | created\$1at | DateTime | NA | 
| Empresas | remote\$1created\$1at | DateTime | NA | 
| Empresas | updated\$1at | DateTime | NA | 
| Empresas | last\$1request\$1at | DateTime | NA | 
| Empresas | planejar | Struct | NA | 
| Empresas | company\$1id | String | NA | 
| Empresas | nome | String | NA | 
| Empresas | custom\$1attributes | Struct | NA | 
| Empresas | session\$1count | Inteiro | NA | 
| Empresas | monthly\$1spend | Inteiro | NA | 
| Empresas | user\$1count | 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\$1TO.NOT\$1EQUAL\$1TO | 
| Contatos | type | String | NA | 
| Contatos | workspace\$1id | String | NA | 
| Contatos | external\$1id | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | perfil | String | EQUAL\$1TO.NOT\$1EQUAL\$1TO | 
| Contatos | email | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | phone | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | nome | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | avatar | String | NA | 
| Contatos | owner\$1id | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Contatos | social\$1profiles | Struct | NA | 
| Contatos | has\$1hard\$1bounced | Booleano | EQUAL\$1TO | 
| Contatos | marked\$1email\$1as\$1spam | Booleano | EQUAL\$1TO | 
| Contatos | unsubscribed\$1from\$1emails | Booleano | EQUAL\$1TO | 
| Contatos | created\$1at | DateTime | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Contatos | updated\$1at | DateTime | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Contatos | signed\$1up\$1at | DateTime | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Contatos | last\$1seen\$1at | DateTime | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Contatos | last\$1replied\$1at | DateTime | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Contatos | last\$1contacted\$1at | DateTime | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Contatos | last\$1email\$1opened\$1at | DateTime | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Contatos | last\$1email\$1clicked\$1at | DateTime | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Contatos | language\$1override | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | navegador | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | browser\$1version | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | browser\$1language | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | os | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | local | Struct | NA | 
| Contatos | location\$1country | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | location\$1region | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | location\$1city | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | android\$1app\$1name | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | android\$1app\$1version | String | NA | 
| Contatos | android\$1device | String | NA | 
| Contatos | android\$1os\$1version | String | NA | 
| Contatos | android\$1sdk\$1version | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | android\$1last\$1seen\$1at | Data | NA | 
| Contatos | ios\$1app\$1name | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | ios\$1app\$1version | String | NA | 
| Contatos | ios\$1device | String | NA | 
| Contatos | ios\$1os\$1version | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | ios\$1sdk\$1version | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Contatos | ios\$1last\$1seen\$1at | DateTime | NA | 
| Contatos | custom\$1attributes | Struct | NA | 
| Contatos | tags | Struct | NA | 
| Contatos | notes | Struct | NA | 
| Contatos | empresas | Struct | NA | 
| Contatos | unsubscribed\$1from\$1sms | Booleano | NA | 
| Contatos | sms\$1consent | Booleano | NA | 
| Contatos | opted\$1out\$1subscription\$1types | Struct | NA | 
| Contatos | indicador | String | NA | 
| Contatos | utm\$1campaign | String | NA | 
| Contatos | utm\$1content | String | NA | 
| Contatos | utm\$1medium | String | NA | 
| Contatos | utm\$1source | String | NA | 
| Contatos | utm\$1term | String | NA | 
| Conversas | type | String | NA | 
| Conversas | id | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | created\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | updated\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | origem | Struct | NA | 
| Conversas | source\$1id | String | EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | source\$1type | String | EQUAL\$1TO, NOT\$1EQUAL\$1TO, | 
| Conversas | source\$1delivered\$1as | String | EQUAL\$1TO, NOT\$1EQUAL\$1TO, | 
| Conversas | source\$1subject | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | source\$1body | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | source\$1author\$1id | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | source\$1author\$1type | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | source\$1author\$1name | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | source\$1author\$1email | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | source\$1url | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | contacts | Struct | NA | 
| Conversas | colegas de equipe | Struct | NA | 
| Conversas | título | String | NA | 
| Conversas | admin\$1assignee\$1id | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | team\$1assignee\$1id | Inteiro | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | custom\$1attributes | Struct | NA | 
| Conversas | aberto | Booleano | EQUAL\$1TO | 
| Conversas | estado | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | leitura | Booleano | EQUAL\$1TO | 
| Conversas | waiting\$1since | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | snoozed\$1until | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | tags | Struct | NA | 
| Conversas | first\$1contact\$1reply | Struct | NA | 
| Conversas | priority | String | EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | tópicos | Struct | NA | 
| Conversas | sla\$1applied | Struct | NA | 
| Conversas | conversation\$1rating | Struct | NA | 
| Conversas | conversation\$1rating\$1requested\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | conversation\$1rating\$1replied\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | conversation\$1rating\$1score | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | conversation\$1rating\$1remark | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | conversation\$1rating\$1contact\$1id | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | conversation\$1rating\$1admin\$1id | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | estatísticas | Struct | NA | 
| Conversas | statistics\$1time\$1to\$1assignment | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1time\$1to\$1admin\$1reply | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1time\$1to\$1first\$1close | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1time\$1to\$1last\$1close | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1median\$1time\$1to\$1reply | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1first\$1contact\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1first\$1assignment\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1first\$1admin\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1first\$1close\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1last\$1assignment\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1last\$1assignment\$1admin\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1last\$1contact\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1last\$1admin\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1last\$1close\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1last\$1closed\$1by\$1id | String | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| Conversas | statistics\$1count\$1reopens | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1count\$1assignments | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | statistics\$1count\$1conversation\$1parts | Inteiro | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| Conversas | conversation\$1parts | 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\$1name | String | NA | 
| Atributos de dados | rótulo | String | NA | 
| Atributos de dados | description | String | NA | 
| Atributos de dados | data\$1type | String | NA | 
| Atributos de dados | options | Lista | NA | 
| Atributos de dados | api\$1writable | Booleano | NA | 
| Atributos de dados | ui\$1writable | Booleano | NA | 
| Atributos de dados | personalizado | Booleano | NA | 
| Atributos de dados | archived | Booleano | NA | 
| Atributos de dados | created\$1at | Booleano | NA | 
| Atributos de dados | updated\$1at | DateTime | NA | 
| Atributos de dados | admin\$1id | String | NA | 
| Segmentos | type | String | NA | 
| Segmentos | id | String | NA | 
| Segmentos | nome | String | NA | 
| Segmentos | created\$1at | DateTime | NA | 
| Segmentos | updated\$1at | DateTime | NA | 
| Segmentos | person\$1type | 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\$1ids | 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\$1at, updated\$1at,last\$1seen\$1at | DateTime | 
| Conversas | id | Inteiro | 
| Conversas | created\$1at, updated\$1at | 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"
    }
)
```